Mulai menggunakan Privacy Sandbox untuk Android

Privacy Sandbox di program Beta Android menyediakan API stabil. Anda dapat menggunakan rilis program Beta untuk mem-build dan menguji solusi untuk pengujian produksi terbatas di perangkat seluler Android 13+ untuk semua API dan Android 12+ untuk Attribution Reporting API (ARA). Kami akan mulai mendukung sejumlah kecil perangkat dan meningkatkan jumlahnya dari waktu ke waktu. Untuk berpartisipasi, organisasi dapat meminta akses untuk sejumlah kecil perangkat, dan mendaftarkan aplikasi apa pun yang menggunakan Privacy Sandbox API.

Untuk Runtime SDK, kami memiliki versi Beta tertutup bagi developer untuk menguji distribusi SDK yang mendukung Runtime guna memilih aplikasi.

Untuk menggunakan rilis Beta, developer harus mengompilasi solusi mereka dengan update ekstensi SDK 33 API level.

Ekstensi Android SDK

API Stabil dalam rilis Beta dikirimkan menggunakan metode rilis Ekstensi Android SDK yang baru. Metode rilis ini memungkinkan rilis fitur Android yang stabil di antara rilis utama. Versi ini memiliki mekanisme pembuatan versi baru yang membuat API baru tersedia untuk aplikasi di beberapa level API menggunakan update sistem Google Play. Privacy Sandbox di ekstensi Android SDK disebut Ekstensi Layanan Iklan. Pelajari Ekstensi Android SDK lebih lanjut.

Mulai

Untuk memulai Privacy Sandbox untuk Android, lakukan langkah-langkah berikut:

Langkah 1: Mendaftar dan registrasi ke program Beta

  • Daftar: Selesaikan proses pendaftaran untuk menggunakan API terkait iklan.
  • Daftar: Anda harus register untuk berpartisipasi dalam program Beta. Dengan mendaftar, Anda dapat:
    • Mengaktifkan perangkat Anda sendiri untuk tujuan pengujian internal.
    • Menentukan sejumlah kecil aplikasi yang dipublikasikan di Google Play Store dan dapat langsung mengintegrasikan API perlindungan privasi atau mengintegrasikan solusi SDK yang menggunakan API tersebut.
    • Menguji distribusi SDK yang mendukung runtime menggunakan Google Play Store. Jika Anda hanya perlu menguji Runtime SDK di perangkat, langkah ini tidak diperlukan.

Langkah 2: Menyiapkan lingkungan pengembangan Anda

Siapkan Privacy Sandbox di Android SDK di Android Studio.

Langkah 3: Mengonfigurasikan izin AdServices

Deklarasikan izin khusus API dan konfigurasikan akses SDK ke resource yang dikelola oleh API yang ditargetkan.

Langkah 4: Menyiapkan perangkat atau image emulator

Untuk melakukan pengujian menyeluruh, Anda harus berinteraksi dengan perangkat Android 13 yang didukung atau menggunakan image emulator untuk Ekstensi SDK yang tepat.

Langkah 5: Mengonfigurasikan perangkat untuk menggunakan Privacy Sandbox di Android

Konfigurasi setelan untuk mengaktifkan (atau menonaktifkan) Privacy Sandbox di Android agar dapat berjalan di perangkat.

Memecahkan masalah umum

Untuk menghindari masalah umum terkait Integrasi PP API di perangkat yang menjalankan Android 12 dan yang lebih lama, developer yang berintegrasi dengan API layanan iklan untuk perangkat ini harus melakukan hal berikut:

  1. Pastikan file manifes aplikasi klien berisi tag extservices <uses-library>. Tag yang relevan adalah:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. Jika menggunakan library jetpack androidx.privacysandbox.ads, pastikan Anda menggunakan Versi 1.1.0-beta05 atau yang lebih tinggi.

Resource developer apa yang tersedia?

Privacy Sandbox di program Beta Android menyertakan alat dan resource berikut.

Image sistem emulator dan SDK

Dengan Android Studio, Anda dapat mendownload Ekstensi Layanan Iklan dan image sistem emulator terbaru melalui SDK Manager. Pelajari lebih lanjut cara menyiapkan lingkungan pengembangan Anda dan menyiapkan akses API.

Referensi API

Referensi API selengkapnya tersedia.

Dukungan dan masukan

Saat Anda menguji dan mengembangkan dengan Privacy Sandbox di Android, tinjau catatan rilis dan gunakan issue tracker untuk melaporkan masalah dan memberikan masukan.

Memastikan lingkungan pengembangan Anda selalu diupdate

Sebaiknya Anda selalu mengupdate lingkungan pengembangan Anda dengan rilis terbaru. Hal ini memastikan bahwa Anda memiliki fitur dan patch keamanan terbaru, serta lingkungan Anda kompatibel dengan versi terbaru dependensi Anda. Untuk mendapatkan notifikasi tentang rilis baru, daftar ke info terbaru melalui email.