Iniziare a utilizzare Privacy Sandbox per Android

Il programma beta Privacy Sandbox su Android fornisce API stabili. Stiamo pianificando diverse release beta per tutto il 2023. Puoi utilizzare le release del programma beta per creare e testare soluzioni per i test di produzione limitati su dispositivi mobili Android 13. Inizieremo a supportare una piccola percentuale di dispositivi e ad aumentare il numero nel tempo. Per partecipare, le organizzazioni possono richiedere l'accesso per un numero limitato di dispositivi, oltre a registrare le app che utilizzano le API Privacy Sandbox.

Per SDK Runtime, stiamo usufruendo di una beta chiusa per consentire agli sviluppatori di testare la distribuzione di SDK abilitata per runtime su determinate app.

Per utilizzare la release beta, gli sviluppatori devono compilare le loro soluzioni con un aggiornamento dell'estensione SDK 33 a livello API.

Estensioni SDK Android

Le API stabili nelle release beta vengono fornite utilizzando il nuovo metodo di rilascio delle estensioni dell'SDK Android. Questo metodo di rilascio consente il rilascio di funzionalità Android stabili tra le release principali. È dotato di un nuovo meccanismo di controllo delle versioni che rende disponibili le nuove API alle app su più livelli API utilizzando gli aggiornamenti di sistema di Google Play. L'estensione di Privacy Sandbox su Android SDK si chiama Estensioni AdServices. Scopri di più sulle estensioni SDK Android.

Inizia

Per iniziare, segui questi passaggi:

Passaggio 1: registrati e registrati al programma beta

  • Registrazione: completa il processo di registrazione per utilizzare le API relative agli annunci.
  • Registrati: devi register per partecipare al programma beta. La registrazione ti consente di:
    • Abilita i tuoi dispositivi per test interni.
    • Specifica un numero limitato di app pubblicate sul Google Play Store che possono integrare direttamente API incentrate sulla tutela della privacy o integrare soluzioni SDK che utilizzano le API.
    • Testare la distribuzione di SDK abilitati per il runtime utilizzando il Google Play Store. Questo passaggio non è obbligatorio se devi solo testare SDK Runtime on-device.

Passaggio 2: configura l'ambiente di sviluppo

Configura l'SDK Privacy Sandbox su Android in Android Studio.

Passaggio 3: configura le autorizzazioni AdServices

Dichiara autorizzazioni specifiche per l'API e configura l'accesso all'SDK alle risorse gestite dall'API di destinazione.

Passaggio 4: configura l'immagine di un dispositivo o di un emulatore

Per eseguire il test end-to-end, devi interagire con un dispositivo Android 13 supportato o utilizzare un'immagine emulatore per l'estensione SDK appropriata.

Passaggio 5: configura i dispositivi per l'utilizzo di Privacy Sandbox su Android

Configura le impostazioni per attivare (o disattivare) l'esecuzione di Privacy Sandbox su Android sui dispositivi.

Risolvere i problemi noti

Per evitare problemi noti relativi all'integrazione dell'API PP sui dispositivi Android 12 e versioni precedenti, gli sviluppatori che integrano le API dei servizi pubblicitari per Android 12 e versioni precedenti devono:

  1. Verifica che il file manifest dell'app client contenga il tag extservices <uses-library>. Il tag pertinente è il seguente:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. Se utilizzi la libreria jetpack androidx.privacysandbox.ads, assicurati di utilizzare la versione 1.1.0-beta05 o successiva.

Quali risorse per sviluppatori sono disponibili?

Il programma beta Privacy Sandbox su Android include i seguenti strumenti e risorse.

Immagini di sistema di SDK ed emulatori

Con Android Studio puoi scaricare l'estensione dei servizi pubblicitari più recente e le immagini di sistema dell'emulatore tramite SDK Manager. Scopri di più su come configurare l'ambiente di sviluppo e l'accesso API.

Riferimento API

È disponibile il riferimento API completo.

Assistenza e feedback

Mentre esegui test e sviluppi con Privacy Sandbox su Android, esamina le note di rilascio e utilizza lo strumento Issue Tracker per segnalare problemi e fornire feedback.

Tieni aggiornato l'ambiente di sviluppo

Ti consigliamo vivamente di mantenere l'ambiente di sviluppo aggiornato con la release più recente. In questo modo avrai la certezza di disporre delle funzionalità e delle patch di sicurezza più recenti e che il tuo ambiente sia compatibile con le versioni più recenti delle dipendenze. Per ricevere notifiche sulle nuove uscite, registrati per ricevere gli aggiornamenti via email.