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 rilis program Beta untuk mem-build dan menguji solusi untuk pengujian produksi terbatas di perangkat seluler Android 13. Kami akan mulai mendukung sebagian 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 API level 33.

Ekstensi Android SDK

API Stabil dalam rilis Beta dikirim menggunakan metode rilis Ekstensi Android SDK baru. Metode rilis ini memungkinkan rilis fitur Android yang stabil 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.

Memulai

Untuk memulai, 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. Langkah ini tidak diperlukan jika Anda hanya perlu menguji Runtime SDK di perangkat.

Langkah 2: Menyiapkan lingkungan pengembangan Anda

Menyiapkan Privacy Sandbox di Android SDK di Android Studio.

Langkah 3: Mengonfigurasikan izin AdServices

Deklarasikan izin khusus API dan konfigurasi 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 Android 12 dan perangkat 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 extservice <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 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 terbaru

Sebaiknya terus update lingkungan pengembangan Anda dengan rilis terbaru. Hal ini memastikan Anda memiliki patch keamanan dan fitur terbaru, serta kompatibilitas lingkungan dengan versi terbaru dependensi Anda. Untuk terus mendapatkan notifikasi terkait rilis baru, daftar untuk mendapatkan info terbaru melalui email.