Mulai menggunakan Privacy Sandbox untuk Android

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

Untuk Runtime SDK, kami memiliki versi Beta tertutup yang dapat diuji oleh developer Distribusi SDK yang mendukung runtime untuk memilih aplikasi.

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

Ekstensi Android SDK

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

Mulai

Untuk memulai, lakukan langkah-langkah berikut:

Langkah 1: Mendaftar dan registrasi ke program Beta

  • Mendaftar: Selesaikan proses pendaftaran untuk menggunakan API yang terkait dengan iklan.
  • Daftar: Anda harus mendaftar 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. Langkah ini tidak diperlukan jika Anda hanya perlu menguji Runtime SDK di perangkat.

Langkah 2: Menyiapkan lingkungan pengembangan Anda

Siapkan Privacy Sandbox di Android SDK di Android Studio.

Langkah 3: Mengonfigurasikan izin AdServices

Mendeklarasikan izin khusus API dan mengonfigurasi akses SDK untuk resource yang dikelola oleh API yang ditargetkan.

Langkah 4: Menyiapkan perangkat atau image emulator

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

Langkah 5: Mengonfigurasikan perangkat untuk menggunakan Privacy Sandbox di Android

Mengonfigurasi setelan untuk mengaktifkan (atau menonaktifkan) Privasi Sandbox di Android untuk dijalankan di perangkat.

Memecahkan masalah umum

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

  1. Pastikan file manifes aplikasi klien berisi tag extservices <uses-library>. Tag yang relevan adalah sebagai berikut:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. Jika Anda 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 lengkap tersedia.

Dukungan dan masukan

Saat Anda melakukan pengujian dan pengembangan dengan Privacy Sandbox di Android, tinjau rilis ini catatan dan gunakan issue tracker untuk melaporkan masalah dan memberikan masukan.

Memastikan lingkungan pengembangan Anda selalu terbaru

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 terus mendapatkan pemberitahuan tentang rilis baru, daftar untuk mendapatkan info terbaru via email.