Menyiapkan akses API untuk aplikasi atau SDK

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Untuk mengakses API menjaga privasi (PPAPI) untuk aplikasi atau SDK selama Pratinjau Developer, Anda harus melakukan langkah-langkah berikut terlebih dahulu:

Akses API diperlukan untuk API menjaga privasi dan Runtime SDK.

Hal ini diperlukan untuk API menjaga privasi spesifik yang digunakan di aplikasi atau SDK Anda.

Mengaktifkan akses ke API Privacy Sandbox

Desain untuk Privacy Sandbox di Android memungkinkan pengguna mengontrol apakah PPAPI dan SDK Runtime aktif di perangkat mereka. Setelan ini dinonaktifkan secara default mulai Pratinjau Developer 5. Untuk tujuan pengembangan, Anda dapat mengaktifkan akses API dengan perintah adb berikut:

adb shell device_config put adservices ppapi_app_allow_list \"*\"

Mengonfigurasi izin AdServices

Ikuti petunjuk di bawah ini untuk mendeklarasikan izin khusus API, dan mengonfigurasi akses SDK ke resource yang dikelola oleh API yang ditargetkan.

Mendeklarasikan izin khusus API AdServices

Akses ke setiap PPAPI memerlukan izin normal AdServices. Di manifes, deklarasikan izin akses yang tepat, yang sesuai dengan API yang diperlukan di aplikasi atau SDK Anda.

Attribution Reporting API:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_ATTRIBUTION" />

FLEDGE / API audiens kustom:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_CUSTOM_AUDIENCE" />

Topics API:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_TOPICS" />

Mengonfigurasi layanan iklan khusus API

Serupa dengan izin akses PPAPI, setiap API memiliki entri yang sesuai dalam konfigurasi layanan iklan. Konfigurasi ini memberi Anda akses kontrol yang terperinci ke resource yang dikelola oleh API di aplikasi Anda atau SDK tersemat. Dalam manifes, tentukan properti adservicesConfig seperti yang ditunjukkan pada contoh di bawah:

<application ...>
      ...
    <property android:name="android.adservices.AD_SERVICES_CONFIG"
        android:resource="@xml/ad_services_config" />

      ...
</application>

Tentukan resource XML layanan iklan yang dirujuk dalam manifes, seperti res/xml/ad_services_config.xml. Untuk setiap API perlindungan privasi yang berlaku untuk aplikasi Anda (atau SDK tersemat), gunakan atribut allowAllToAccess untuk memberikan akses.

Platform teknologi iklan juga harus memastikan bahwa klien aplikasi mereka memberikan akses dengan benar ke API perlindungan privasi yang diperlukan dalam konfigurasi layanan iklan.

<ad-services-config>
    <!-- Attribution API -->
    <attribution allowAllToAccess="true" />

    <!-- Topics API -->
    <topics allowAllToAccess="true" />

    <!-- FLEDGE on Android API -->
    <custom-audiences allowAllToAccess="true" />
</ad-services-config>

Batasan akses latar depan

Untuk memberikan transparansi, akses ke Runtime SDK dan API yang menjaga privasi dibatasi untuk aplikasi yang memiliki Aktivitas yang terlihat, atau dengan RunningAppProcessInfo dari IMPORTANCE_FOREGROUND