API Runtime SDK: panduan integrasi

Dokumen ini mencakup panduan untuk membantu Anda menyiapkan integrasi Runtime SDK berdasarkan kasus penggunaan umum.

Untuk membantu Anda merencanakan integrasi, langkah ini memberikan gambaran menyeluruh tentang proses integrasi, yang dapat mencakup fitur yang belum diimplementasikan pada tahap Privacy Sandbox pada Pratinjau Developer Android saat ini. Dalam kasus ini, detail yang terkait akan ditandai sebagai belum diimplementasikan.

Sasaran integrasi

Pada tahap Privacy Sandbox di Pratinjau Developer Android ini, tujuan perencanaan integrasi mencakup kemampuan untuk melakukan hal berikut:

  • Memverifikasi kebenaran teknis di lingkungan pengujian
  • Memverifikasi kompatibilitas dengan infrastruktur teknis yang ada
  • Menentukan dan memverifikasi persyaratan integrasi

Kasus penggunaan dan fitur yang saat ini didukung dalam rilis Pratinjau Developer terbaru:

  • Pemuatan jarak jauh dan tampilan iklan banner
  • Menulis/Membaca dari penyimpanan
  • Komunikasi 2 arah
  • Iklan video mandiri

Rilis Pratinjau Developer mendatang berencana menambahkan dukungan untuk kasus penggunaan tambahan dan fitur teknis. Dengan tersedianya fitur-fitur tersebut, panduan ini akan diperbarui untuk mencerminkan detail yang relevan.

  • Iklan native
  • Iklan layar penuh

Prasyarat

Langkah-langkah integrasi

1. Memverifikasi kebenaran teknis di lingkungan pengujian.

  • Buat aplikasi pengujian dan SDK pengujian untuk memahami Privacy Sandbox di Android Runtime SDK. Pada tahap ini, Anda juga dapat memulai dengan aplikasi contoh di GitHub.
  • Instal dan jalankan SDK dan aplikasi di perangkat atau emulator, dan pastikan bahwa WebView memuat URL yang disediakan.
  • Render iklan di aplikasi dari jarak jauh dari Runtime SDK.
  • Tambahkan titik henti sementara ke kode SDK dan hubungkan ke proses untuk memastikan bahwa proses tersebut dapat di-debug.

2. Memverifikasi kompatibilitas dengan infrastruktur teknis yang ada.

  • Setelah Pratinjau Developer, Privacy Sandbox di Android akan memerlukan API level target minimum 33. Identifikasi jalur migrasi untuk codebase yang ada. Evaluasi kompatibilitas aplikasi atau SDK Anda dengan perubahan lain yang diperkenalkan di Android 13.
  • Verifikasi kompatibilitas toolchain pengembangan dengan aplikasi Anda, jika berlaku.
  • Faktorkan ulang codebase Anda jika perlu untuk menggunakan kembali logika umum. Beberapa developer mungkin lebih memilih memiliki satu codebase. Jika ini terjadi pada Anda, verifikasi kelayakan pendekatan ini.

3. Menentukan dan memverifikasi persyaratan integrasi.

  • Periksa kebutuhan akses data solusi SDK Anda saat ini, model interaksi dengan aplikasi klien, dan komponen sistem terhadap desain SDK Runtime.
  • Pastikan SDK dimuat dengan menampilkan salah satu jenis iklan yang didukung dari SDK Runtime dan pastikan bahwa iklan tersebut dapat berinteraksi.
  • Jika berlaku untuk kasus penggunaan bisnis Anda, pastikan bahwa Topics, FLEDGE, atau Attribution Reporting API akan berjalan dari proses Runtime SDK.
  • Periksa apakah proses Runtime SDK dapat di-debug dengan melampirkan melalui ADB atau Android Studio, lalu menyusuri kode Anda.