Iniziare a utilizzare Privacy Sandbox per Android

Il programma beta di Privacy Sandbox su Android fornisce API stabili. Stiamo pianificare diverse release beta nel corso del 2023. Puoi utilizzare le release del programma beta per creare e testare soluzioni per test di produzione limitati su dispositivi mobili Android 13 e versioni successive per tutte le API e Android 12 e versioni successive per l'API Attribution Reporting (ARA). Inizieremo a supportare una piccola percentuale di dispositivi e aumenteremo il numero nel tempo. Per partecipare, le organizzazioni possono richiedere l'accesso per un numero limitato di dispositivi, nonché registrare le app che utilizzano le API Privacy Sandbox.

Per SDK Runtime, è disponibile una versione beta chiusa che gli sviluppatori potranno testare Distribuzione dell'SDK abilitato per il runtime per selezionare le app.

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

Estensioni SDK Android

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

Inizia

Per iniziare, segui questi passaggi:

Passaggio 1: registrati al programma beta

  • Iscriviti: completa la procedura di registrazione per utilizzare le API relative agli annunci.
  • Registrati: devi registrarti per partecipare al programma beta. La registrazione ti consente di:
    • Abilita i tuoi dispositivi per i test interni.
    • Specificare un numero limitato di app pubblicate sul Google Play Store che Può integrare direttamente API incentrate sulla tutela della privacy o soluzioni SDK che utilizzano le API.
    • Testa la distribuzione di SDK abilitati per il runtime utilizzando il Google Play Store. Questo non è obbligatorio se devi solo testare SDK Runtime sul dispositivo.

Passaggio 2: configura l'ambiente di sviluppo

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

Passaggio 3: configura le autorizzazioni di AdServices

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

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

Per eseguire i test end-to-end, devi interagire con un Android 13 supportato dispositivo oppure utilizza un'immagine emulatore per l'estensione SDK corretta.

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

Configurare le impostazioni per attivare (o disattivare) la privacy Sandbox su Android per l'esecuzione 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 i dispositivi Android 12 e versioni precedenti devono fare quanto segue:

  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 androidx.privacysandbox.adslibreria Jetpack, assicurati di utilizzare la versione 1.1.0-beta05 o successive.

Quali risorse per sviluppatori sono disponibili?

Il programma beta Privacy Sandbox su Android include quanto segue: strumenti e risorse.

Immagini di sistema dell'SDK e dell'emulatore

Con Android Studio, puoi scaricare le ultime estensioni di Servizi pubblicitari e immagini di sistema dell'emulatore tramite SDK Manager. Scopri di più su come configurare l'ambiente di sviluppo e l'accesso all'API.

Riferimento API

Il riferimento API completo è disponibile.

Assistenza e feedback

Mentre esegui test e sviluppi con Privacy Sandbox su Android, rivedi la release Note e utilizza Issue Tracker per segnalare problemi e fornire feedback.

Mantieni aggiornato l'ambiente di sviluppo

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