Iniziare a utilizzare Privacy Sandbox per Android

Il programma beta di Privacy Sandbox su Android fornisce API stabili. 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 e registrare tutte le app che utilizzano le API Privacy Sandbox.

Per SDK Runtime, stiamo conducendo una versione beta chiusa che consente agli sviluppatori di testare la distribuzione di SDK abilitati per il runtime in app selezionate.

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

Estensioni SDK Android

Le API stabili nelle release beta vengono pubblicate 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 gestione delle versioni che rende disponibili nuove API per le app su più livelli API tramite gli aggiornamenti di sistema di Google Play. L'estensione SDK Privacy Sandbox su Android si chiama Estensioni dei servizi pubblicitari. Scopri di più sulle Estensioni SDK Android.

Inizia

Per iniziare a utilizzare Privacy Sandbox per Android, svolgi i seguenti passaggi:

Passaggio 1: registrati al programma beta

  • Registrazione: completa la procedura di registrazione per utilizzare le API relative agli annunci.
  • Registrazione: devi registrarti per partecipare al programma beta. La registrazione ti consente di:
    • Attiva i tuoi dispositivi per scopi di test interni.
    • Specifica un numero limitato di app pubblicate sul Google Play Store che possono integrare direttamente API che tutelano la privacy o soluzioni SDK che utilizzano le API.
    • Testa la distribuzione dell'SDK abilitato in fase di runtime utilizzando il Google Play Store. Se devi solo testare SDK Runtime sul dispositivo, questo passaggio non è obbligatorio.

Passaggio 2: configura l'ambiente di sviluppo

Configura Privacy Sandbox nell'SDK 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 un'immagine del dispositivo o dell'emulatore

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

Passaggio 5: configura i dispositivi per utilizzare 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 i problemi noti relativi all'integrazione dell'API PP sui dispositivi con Android 12 e versioni precedenti, gli sviluppatori che eseguono l'integrazione con le API di servizi pubblicitari per questi dispositivi devono:

  1. Verifica che il file manifest dell'app client contenga il tag extservices <uses-library>. Il tag pertinente è:
<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 i seguenti strumenti e risorse.

Immagini di sistema SDK ed emulatore

Con Android Studio, puoi scaricare l'ultima versione dell'estensione Ad Services e delle immagini di sistema dell'emulatore tramite SDK Manager. Scopri di più su come configurare l'ambiente di sviluppo e l'accesso alle API.

Riferimento API

È disponibile il riferimento API completo.

Assistenza e feedback

Durante il test e lo sviluppo con Privacy Sandbox su Android, consulta le note di rilascio e utilizza il tracker dei problemi per segnalare i problemi e fornire feedback.

Mantenere aggiornato l'ambiente di sviluppo

Consigliamo vivamente di mantenere aggiornato il tuo ambiente di sviluppo con l'ultima release. Ciò garantisce di disporre delle funzionalità e delle patch di sicurezza più recenti e che il tuo ambiente sia compatibile con le versioni più recenti delle tue dipendenze. Per ricevere notifiche sulle nuove release, iscriviti per ricevere aggiornamenti via email.