Note di rilascio di Privacy Sandbox per Android

Privacy Sandbox su Android offre programmi beta e di anteprima per gli sviluppatori. Lo faremo introdurre nel tempo nuove API e funzionalità nell'Anteprima per gli sviluppatori e promuovere le API stabilizzate al programma beta. Incoraggiamo i feedback.

Se non hai mai utilizzato Privacy Sandbox su Android, inizia con il programma Panoramica. Per iniziare a integrare Privacy Sandbox nel tuo progetto, configurare il tuo ambiente di sviluppo e scaricare Privacy Sandbox su Android sul dispositivo di test o sull'emulatore.

Release attuali

Anteprima Android VanillaIceCream

API Protected Audience

  • La possibilità di trasferire annunci contestuali autenticati in un'asta protetta ha è stato aggiunto. Sono inclusi anche i filtri negativi per le app già installate dispositivo così come la quota limite su numero di clic, impressioni, visualizzazioni o vince. L'implementazione differisce dalle iterazioni precedenti perché gli annunci devono essere firmati dal tecnico pubblicitario. Leggi come implementare questa funzionalità nella guida per gli sviluppatori.
  • ContextualAds rinominato in SignedContextualAds insieme al getter e al un setter in AdSelectionConfig; getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • Se viene trasmessa un'app contestuale non autenticata, questa verrà rimossa dalla asta

API Attribution Reporting

Aggiornamento beta di Privacy Sandbox su Android di novembre 2023

Questa release di Privacy Sandbox su Android beta include aggiornamenti alle API Privacy Sandbox su dispositivi Android 14 pubblici. L'SDK e le immagini del dispositivo disponibili per il download con SDK Manager di Android Studio come API Android 34. L'estensione di livello 10 è simile a quella di Anteprima per gli sviluppatori. 9, con alcune modifiche importanti.

API Protected Audience

  • Ora i tecnici pubblicitari possono utilizzare la delega dei segmenti di pubblico personalizzati per partecipare a una pubblico per conto di un acquirente che non è presente sul dispositivo.
  • Android ora supporta l'esecuzione di un'asta su servizi di offerte e aste.
  • Le aste Protected Audience supportano la fatturazione CPC.
  • Le aste e i report di Protected Audience ora supportano le intestazioni delle versioni dei dati per gli indicatori di offerte attendibili.
  • Le aste Protected Audience supportano i filtri della quota limite per gli eventi WIN.
  • Protected Audience ora supporta integrazione con l'API Attribution Reporting.

API Attribution Reporting

SDK Runtime

  • Possibilità da SDK di caricare altri SDK all'interno di SDK Runtime per il supporto casi d'uso della mediazione

Release precedenti

Anteprima per gli sviluppatori 10

Data di uscita: 19 dicembre 2023

Limitazioni note

  • Si è verificato un problema che causa l'arresto anomalo di Google Play Services in il contesto in background e informare ripetutamente l'utente:
    • Il riavvio del dispositivo potrebbe risolvere il problema.
    • Durante il test, se riscontri problemi con il timeout delle chiamate asincrone, prova ad aggiungere il seguente comando adb per allungare la soglia fino al timeout:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • Solo dispositivo fisico: l'aggiunta di un Account Google non è supportata. Segui per visualizzare la schermata Home del dispositivo, procedi nel seguente modo:
    • Installa l'immagine di anteprima sullo smartphone.
    • Segui la configurazione guidata senza connetterti alla rete Wi-Fi o ai dati mobili.
    • Nella schermata Home, connettiti al Wi-Fi o ai dati mobili.
    • Riavvia il dispositivo.

API Protected Audience

  • Stiamo introducendo nuove funzionalità, [Protected App Signals][dp98], per supportare la pubblicazione di annunci per l'installazione di app pertinenti. Con questo DP, rilasciamo API per consentire agli ad tech di:
    • Seleziona i segnali archiviando gli eventi delle app nello spazio di archiviazione sul dispositivo protetto, vengono utilizzati per pubblicare annunci pertinenti per l'installazione di app.
    • Esegui un'asta protetta su offerte e servizi di aste in esecuzione all'interno di ambienti di esecuzione affidabili in cui possono accedere ai rispettivi indicatori per facilitare la selezione degli annunci e le offerte.

API Attribution Reporting

  • Questa versione dell'API Attribution Reporting:
    • Aggiunge l'integrazione di Protected Audience, che consente ai segmenti di pubblico personalizzati nei report di riepilogo aggregati.
    • Supporta il provider Google Cloud in qualità di TEE per il servizio di aggregazione.
    • Aggiunge il campo shared_debug_key per supportare il debug per più reti di attribuzione senza reindirizzamenti.
    • Aggiunge intestazioni di versione nelle richieste di report di debug dettagliato.

Personalizzazione sul dispositivo

  • Release iniziale per i ricercatori e fase di sviluppo iniziale.
  • La personalizzazione sul dispositivo introduce un modo innovativo per personalizzare i prodotti e servizi, garantendo al contempo una maggiore protezione della privacy dell'utente finale. Sul dispositivo La personalizzazione fornisce un insieme di servizi e algoritmi come componenti di base per raggiungere questo obiettivo, inclusi, a titolo esemplificativo:
    • Federated Compute (FC) che consente l'addestramento, la valutazione e la personalizzazione che utilizzano l'apprendimento federato. Utilizzo di Personalizzazione sul dispositivo Il calcolo si baserà sull'addestramento del modello e (facoltativamente, se necessario) sull'inferenza.
    • Corrispondenza basata su filtro a cucù e corrispondenza incrociata tra i dati in una posizione dispersa.
    • Addestramento differenzialmente privato (DP) di modelli sparsi utilizzando nuove tecniche come la minimizzazione alternata DP (per l'addestramento su i dati localizzati) e la personalizzazione del modello in DP billboard.

Anteprima per gli sviluppatori 9

Data di uscita: 15 agosto 2023

Limitazioni note

  • I dati sulle aste generati chiamando l'API Bidding e aste non vengono eliminati automaticamente in DP9.
  • Chiamata a getAdSelectionData e persistAdSelectionResult quando viene concesso il consenso revocati ha arrestato il processo in modo anomalo.
  • La funzionalità di filtro per esclusione non funziona con getAdSelectionData e persistAdSelectionResult.

API Protected Audience

  • Ora i tecnici pubblicitari possono utilizzare la delega dei segmenti di pubblico personalizzati per partecipare a una pubblico a un chiamante sul dispositivo.
  • Android ora supporta l'esecuzione di un'asta su offerte e aste : le aste Protected Audience supportano la fatturazione CPC.
  • L'API Report Interactions ora si chiama reportEvent.
  • Il metodo di quota limite e i tipi di contatore sono stati rinominati.
  • I report di debug sono disponibili per ottenere informazioni sul motivo per cui un o per identificare problemi nella logica JavaScript.

API Attribution Reporting

  • Questa release migliora i report di debug per l'API Attribution Reporting per:
    • Supporto di report di debug dettagliato supportati su web.
    • Attivare i report di debug sull'attribuzione cross-web e app (richiede ID pubblicità su entrambi) registrazione sul web e nelle app).
  • I tecnici pubblicitari possono configurare parametri di rumore per diversi scenari di reporting.
  • Questa release passa all'attribuzione basata sull'origine, il che significa che:
    • L'origine viene utilizzata per la registrazione.
    • Sono accettate più origini in un unico sito.
    • Un nuovo limite di frequenza di un'origine per app di origine o registrazione.
  • Ora i tecnici pubblicitari possono disattivare la registrazione per testare l'utilizzo di Attribution Reporting a livello locale.

SDK Runtime

  • L'SDK può essere avviato o associato solo a una lista consentita di servizi.
  • L'SDK è in grado di accedere solo a un sottoinsieme del sistema ContentProvider (ad esempio come com.android.providers.settings.SettingsProvider), dove i dati ottenuti non dispone di identificatori e non può essere utilizzato per creare un'impronta dell'utente. Questi I controlli si applicano anche all'accesso a ContentProvider tramite ContentResolver.
  • L'SDK è in grado di accedere solo a un sottoinsieme di broadcast receiver protetti (come come android.intent.action.AIRPLANE_MODE).
  • L'SDK può avviare un'attività appartenente a un'altra app, ma con limitazioni attive ciò che può essere inviato nell'intent.

Aggiornamento beta di Privacy Sandbox su Android di marzo 2023

La versione di marzo 2023 di Privacy Sandbox su Android beta include aggiornamenti alle API Privacy Sandbox su dispositivi Android 13 pubblici. Questa release include le API Ad Services Extensions 5 ed è simile all'Anteprima per gli sviluppatori 6, con alcune modifiche fondamentali.

Limitazioni note

  • Il job di recupero in background che viene eseguito periodicamente per aggiornare FLEDGE personalizzato segmenti di pubblico causano l'arresto anomalo del processo. A causa di questo problema, FLEDGE è disabilitata per impostazione predefinita.

Generali

  • A partire da questa versione, puoi utilizzare l'API Attribution Reporting. L'API era disattivato in precedenza. Se hai utilizzato l'API Attribution Reporting nella precedente esperienza Release beta, cancella i dati dell'app o del dispositivo prima di utilizzare questa release beta utilizzando uno dei seguenti passaggi:
  • Attribution Reporting ora supporta le chiavi di debug, che consentono agli sviluppatori di ricevere dall'attribuzione report non modificati e report avanzati per la privacy tramite Google Cloud CLI o tramite l'API Compute Engine. Le chiavi di debug offrono l'opportunità di ottenere maggiore visibilità su come vengono strutturati durante la transizione a Privacy Sandbox.
  • Attribution Reporting ha recentemente riscontrato un bug con l'annuncio Servizi in cui registerSource e registerTrigger non riusciranno con eccezioni. Se hai riscontrato questi problemi durante lo sviluppo, la soluzione sarà il deployment e questi problemi dovrebbero risolversi nel tempo.
  • La funzionalità di anteprima dell'API Topics ora corrisponde a Privacy Sandbox su Anteprime per gli sviluppatori Android. Un chiamante dell'API Topics può visualizzare l'anteprima degli argomenti senza inclusa la chiamata di recupero dell'argomento nel calcolo dell'epoca settimanale che interessa l'elenco di argomenti osservati per il chiamante. Consulta le shouldRecordObservation per i dettagli.

  • Per attivare i test in FLEDGE su Android, registrati alla versione beta e usa lo stesso Account Google per accedere al tuo i dispositivi di test. In caso contrario, i tentativi di chiamata alle API causano IllegalStateException con l'indicazione "Il servizio non è disponibile" . FLEDGE dovrebbe essere reintegrato nella prossima release beta.

    Nel frattempo è possibile continuare a testare utilizzando Anteprime per gli sviluppatori. e FLEDGE può essere abilitato manualmente sui dispositivi con avvertenze:

    Puoi abilitare FLEDGE con i seguenti comandi adb. Tuttavia, questo causa il processo di recupero in background si arresta in modo anomalo, con un impatto negativo sull'integrità del sistema. metriche di valutazione. Non si tratta di una soluzione definitiva in quanto questi valori possono essere reimpostati completamente gestita.

    adb shell device_config set_sync_disabled_for_tests persistent
adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
adb shell device_config put adservices fledge_background_fetch_enabled true

Release precedenti

Anteprima per gli sviluppatori 8

Data di rilascio: 23 maggio 2023

Limitazioni note

  • Anche se i filtri per la quota limite di tipo WIN possono essere aggiunti a Protected Audience annunci, il tipo WIN non è ancora supportato e i filtri di questo tipo sono ignorato.
  • Per generare report sulle impressioni vincitrici per gli acquirenti vincitori di Protected Audience gli acquirenti devono essere registrati a Privacy Sandbox. Questo requisito non possono essere sostituiti.
  • Per accedere alle impostazioni di Privacy Sandbox su un dispositivo con Privacy Sandbox disponibile, vai su Impostazioni > Google > Annunci > Privacy Sandbox.
  • Impossibile eseguire il deployment di progetti con emulatori su Android Studio Giraffe. Altre versioni di Android Studio dovrebbe funzionare correttamente. Verrà implementata una correzione in Android Studio Giraffa il 26 maggio 2023.

API Protected Audience

API Attribution Reporting

  • Filtri di attivazione OR aggiunti. Ciò significa che i filtri ora sono costituiti da un insieme di filtri, un elenco di mappe filtrate. Se nessuna delle mappe filtrate nell'insieme corrisponde dati del filtro dell'origine, l'oggetto event_trigger_data viene ignorato.
  • La scadenza delle impressioni e la finestra del report per l'aggregazione e a livello di evento Le API sono state disaccoppiate.
  • Aggiunto il supporto per i report aggregabili delle chiavi di deduplicazione.
  • L'elemento scheduled_report_time è stato aggiunto ai report sugli eventi per garantire la parità con le Norme sulla privacy Sandbox per il web
  • È stata implementata l'attribuzione su più reti senza reindirizzamenti.

SDK Runtime

Anteprima per gli sviluppatori 7

Data di uscita: 26 gennaio 2023

API FLEDGE su Android

  • Il parametro custom_audience_signals è stato rinominato nel seguente Metodi JavaScript:
    • generateBid() è stato rinominato custom_audience_bidding_signals.
    • scoreAd() è stato rinominato custom_audience_scoring_signals.
    • reportWin() è stato rinominato custom_audience_reporting_signals.
  • In questa release è stato aggiunto un nuovo override di selectAds che prende AdSelectionFromOutcomeConfig per confrontare selectAds risultati. Ciò consente SDK ad tech che sfruttano questa API per eseguire la mediazione a cascata. Altri dettagli sono descritte nella guida per gli sviluppatori.
  • L'API selectAds() ora supporta la memorizzazione nella cache per la logica di offerta e punteggio JavaScript recuperato durante il processo di selezione degli annunci.
    • La cache può essere controllata con le intestazioni Cache-Control restituite dal token durante la chiamata di recupero di JavaScript. Usa no-cache o no-store per impedire che le risposte JavaScript vengano memorizzate nella cache e impostare la durata massima per controllare e la durata della cache.
    • La voce di cache corrente max-age è impostata su due giorni per impostazione predefinita.

API Attribution Reporting su Android

  • In questa release è stato aggiunto il supporto dei reindirizzamenti daisy-chain per registerSource() e registerTrigger(). Consumer API ora può utilizzare un reindirizzamento HTTP come risposta del server.

Rilascio beta iniziale, gennaio 2023

Data di uscita: 9 gennaio 2023

Privacy Sandbox su Android Beta 1 rappresenta la prima disponibilità di Privacy Sandbox per le API sui dispositivi pubblici e aggiunge miglioramenti alle aree elencate di seguito.

Generali

  • Privacy Sandbox su Android Beta 1 è funzionalmente equivalente a Sviluppatore Anteprima 5, con alcune funzionalità e limitazioni aggiuntive elencati di seguito.
  • Per utilizzare gli annunci correlati agli annunci, gli sviluppatori devono completare una procedura di registrazione API (inclusi Topics, FLEDGE e Attribution Reporting). La registrazione verifica l'identità dello sviluppatore e raccoglie i dati specifici dello sviluppatore necessari dalle API.
  • Con la release beta 1 di Privacy Sandbox su Android, gli sviluppatori che hanno i dettagli registrati e inviati alla lista consentita potrebbero avere l'opportunità per eseguire test sui propri dispositivi fisici. Per sviluppare rispetto ad API stabili nel scarica la nuova versione SDK Ad Services Extensions 4.

API Topics

API Attribution Reporting

  • Attribution Reporting è stato disattivato e non può essere utilizzato in questo . L'accesso a questa API dovrebbe essere riattivato nella prossima release beta. Ti invitiamo a continuare a testare con le Anteprime per gli sviluppatori.

SDK Runtime

Le seguenti limitazioni dovrebbero essere risolte nelle prossime versioni di Android release della piattaforma:

  • Il rendering degli annunci all'interno di una visualizzazione scorrevole, come RecyclerView, al momento non funzionano correttamente. Potresti riscontrare dei blocchi se l'elemento viene ridimensionato. Utente gli eventi di scorrimento al tocco non vengono passati correttamente al runtime.
  • Il rendering WebView non è disponibile nella procedura di SDK Runtime.
  • Lo spazio di archiviazione per SDK non è disponibile.
  • Il supporto per le API getAdId e getAppSetId non è ancora stato attivato.

Anteprima per gli sviluppatori 6

Data di uscita: 31 ottobre 2022

Privacy Sandbox su Android Developer Preview 6 aggiunge miglioramenti alle le seguenti aree:

Generali

  • In preparazione all'implementazione in produzione, Anteprima per gli sviluppatori 6 ha introdotto un flag per disattivare l'accesso all'API che tutela la privacy per impostazione predefinita. A scopo di test, abilitare l'accesso all'API che tutela la privacy nell'Anteprima per gli sviluppatori eseguendo il comando seguente comando:

    adb shell device_config put adservices global_kill_switch false

  • Le API AdIdManager e AppSetIdManager richiedono Google Play Services versione 22.36.16 o successiva.

    • Su un dispositivo Android, verifica che sia elencata la versione corretta nella sezione Impostazioni > App > Google Play Services.
    • Se devi aggiornare Google Play Services alla versione corretta, accedi sul tuo emulatore o dispositivo di test Android con un Account Google. Poi vai sul Google Play Store > icona profilo > Impostazioni > Informazioni. Nella sezione Intestazione Versione Play Store, tocca Aggiorna Play Store.
    • Questo passaggio è applicabile solo allo sviluppo e ai test e non sarà necessaria dopo l'implementazione di Privacy Sandbox per gli utenti pubblici.

API Topics

  • È stata aggiunta un'API Preview per attivare o disattivare la registrazione di getTopics come un osservatore.
  • Modifiche di minore entità al codice di inizializzazione per GetTopicsRequest corso.
  • Rilascio della guida all'integrazione di Topics.

API FLEDGE su Android

  • Se stai eseguendo il test su server reali, ora l'abilitazione dell'API è applicata in modo forzato. Segui questi passaggi per configurare il dispositivo. Questi passaggi non sono necessaria se utilizzi gli override remoti presenti in app di esempio.
  • Modifiche che provocano un errore:
    • Url sostituito nei parametri con Uri. Questo vale per tutte le API FLEDGE e JavaScript personalizzato per la logica di offerta e punteggio.
    • Campo owner rimosso dagli input dell'API Custom Audience.
  • I segmenti di pubblico personalizzati incompleti ora sono immediatamente idonei per lo sfondo aggiorna.
  • Il limite di memoria JavaScript è ora impostato su 10 MB. Questo vale per offerte e della logica di punteggio.

API Attribution Reporting

  • I tecnici pubblicitari devono registrarsi prima di poter utilizzare Attribution Reporting nell'Anteprima per gli sviluppatori 6. Consulta Per saperne di più, registrati per un account Privacy Sandbox.
  • Questa release introduce le chiavi di debug, che consentono agli sviluppatori di ricevere report non alterati insieme ai report migliorati per la privacy da Attribuzione API di reporting. Le chiavi di debug offrono la possibilità di ottenere maggiore visibilità come sono strutturati i report durante la transizione con Privacy Sandbox.

Anteprima per gli sviluppatori 5

Generali

  • Prima di poter accedere alle API Privacy Sandbox in Developer Preview 5, devi Devi prima abilitare le API e configurare autorizzazioni specifiche delle API.
    • I design per Privacy Sandbox su Android consentono agli utenti di controllare le API incentrate sulla tutela della privacy e SDK Runtime sono attivi sul loro dispositivo. Queste impostazioni sono disattivate per impostazione predefinita in Anteprima per gli sviluppatori 5. Tu puoi attivare l'accesso all'API utilizzando un comando adb.
    • L'app del chiamante deve specificare le autorizzazioni specifiche dell'API nel manifest e configurazioni AdServices correlate che controllano l'accesso per gli SDK incorporati.
  • Le app devono chiamare le API che tutelano la privacy quando vengono eseguite in primo piano.
  • AdIdManager e AppSetIdManager non sono al momento operativi. Loro in una release futura.

SDK Runtime

  • sendData() verrà deprecato in una versione futura.
  • loadSdk() ora restituisce un oggetto IBinder per facilitare la comunicazione bidirezionale tra l'SDK abilitato per il runtime e le app definite in AIDL.
  • Le app hanno accesso a eventi aggiuntivi del ciclo di vita dell'SDK abilitati per il runtime, ad esempio quando termina il processo dell'SDK.

API Attribution Reporting

Questa release introduce funzionalità aggiuntive nell'API Attribution Reporting, tra cui:

  • Supporto dei report di aggregazione criptati.
  • Supporto della misurazione cross-app e web.
  • Intestazioni consolidate nelle risposte di origine e di attivazione della registrazione:
    • Fonte: Attribution-Reporting-Register-Aggregatable-Source ora fa parte di Attribution-Reporting-Register-Source
    • Attivatore: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data e Attribution-Reporting-Register-Aggregatable-Values sono state consolidato in un'unica intestazione denominata Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects è ancora un'intestazione separata

API FLEDGE su Android

Questa release include una serie di nuove funzioni e miglioramenti, oltre a modifiche:

  • Modifiche che provocano un errore:
    • runAdSelection() è stato rinominato in selectAds().
    • Sostituito il parametro di AdSelectionConfig.Builder.setAdSelectionSignals() con AdSelectionSignals, che rappresenta un oggetto JSON.
    • È stato sostituito l'utilizzo di String per rappresentare un acquirente/venditore di ad tech con l'oggetto AdTechIdentifier.
    • Aggiunti TestCustomAudienceManager e TestAdSelectionManager corsi per eseguire l'override del recupero JavaScript remoto.
    • Il proprietario di un segmento di pubblico personalizzato deve essere il nome del pacchetto app per chiamate.
  • Le API FLEDGE ora convalidano l'app del chiamante in base a un insieme di restrizioni e Limitazioni descritte nella guida per gli sviluppatori. Di seguito sono riportate le esempi degni di nota.
    • Per selectAds e reportImpression sono ora applicati dei limiti per il tempo di esecuzione, dopo il giorno in cui la chiamata verrà terminata.
    • selectAds e reportImpression hanno ora un limite di memoria utilizzata durante l'esecuzione di JavaScript. Le API generano un errore se la memoria il consumo supera i limiti configurati.
    • selectAds e reportImpression ora convalidano la AdSelectionConfig per garantire che i campi siano sintatticamente validi e che gli URL nell'eTLD+1 utilizzato nel campo del venditore.
    • Ora AdServices convalida i segmenti di pubblico personalizzati al momento della creazione. Alcuni di questa convalida include garantire che la scadenza sia valida e applichi una il limite al numero di segmenti di pubblico personalizzati che un'app può creare e alla dimensione totale gli annunci forniti nella chiamata joinCustomAudience. La convalida inoltre richiede che gli URI forniti per gli indicatori e il recupero della logica di offerta il recupero in background si trova tutti nel dominio dell'acquirente.
  • I metadati dei segmenti di pubblico personalizzati vengono aggiornati quotidianamente mediante un recupero in background .
  • I segmenti di pubblico personalizzati vengono rimossi quando il "proprietario" viene disinstallata.
  • È stato aggiunto il supporto per specificare gli indicatori di punteggio e i dati delle offerte attendibili durante la selezione degli annunci. Guarda un esempio di codice per il formato della risposta.
  • Le API di FLEDGE per Android dipendono da WebView versione 105.0.5195.58 o successiva. Per maggiori dettagli, consulta le informazioni di configurazione nella guida per gli sviluppatori.

  • Problemi noti:

    • Quando ti unisci a un segmento di pubblico personalizzato, al momento la piattaforma non ha un rendimento soddisfacente. in background si aggiorna immediatamente, se uno dei metadati o dei valori di AdData sono vuote o null. Il segmento di pubblico personalizzato non sarà idoneo per l'annuncio selezioni fino a quando non viene aggiornato un giorno dopo. In una versione futura, rendi immediatamente idonei al recupero in background i segmenti di pubblico personalizzati incompleti aggiornamenti. L'attuale limite di memoria predefinito per l'esecuzione di JavaScript è troppo basso e potrebbe causare l'arresto anomalo di JavaScript Engine dispositivi mobili. L'esecuzione di JavaScript potrebbe terminare inaspettatamente con messaggio di errore "Fatal javascript OOM in CALL_AND_RETRY_LAST".

      Puoi risolvere manualmente il problema configurando la soglia di memoria corretta con il seguente comando:

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"

    • Gli annunci con segmenti di pubblico personalizzati che non corrispondono alla struttura JSON richiesta vengono viene aggiornata durante il recupero in background.

API Topics

Aggiornamenti degli strumenti

Android Studio Canary supporta la creazione di APK dell'SDK con un nuovo tipo di modulo. La guida per gli sviluppatori SDK Runtime è stata aggiornata e Privacy Sandbox le app di esempio su GitHub riflettono questo aggiornamento.

Anteprima per gli sviluppatori 4

Data di uscita: 14 luglio 2022

Privacy Sandbox nell'Anteprima per gli sviluppatori Android 4 aggiunge miglioramenti alle le seguenti aree:

SDK Runtime

  • Ora le app possono comunicare con gli SDK abilitati per il runtime (RE-SDK) tramite la aggiunta di sendData().
  • Lo spazio di archiviazione locale è ora disponibile nel processo SDK Runtime.
  • Un SDK può anche eseguire il rendering di annunci o contenuti autonomi basati su video all'interno dell'SDK Tempo di esecuzione.
  • Sono stati aggiunti chiarimenti sull'utilizzo della riflessione per includere la possibilità di usare riflessione, a condizione che i contenuti non siano inclusi in un altro RE-SDK.

API Attribution Reporting

Questa versione introduce modifiche per migliorare la chiarezza sull'utilizzo dell'attribuzione API di reporting, ad esempio:

  • Modifiche nel formato dei report aggregati per migliorarne la leggibilità.
  • Campi intestazione aggiornati per le funzionalità Filtro delle conversioni e Possibilità di offerta.
  • Sono stati aggiunti chiarimenti nel riferimento dell'API WebApp per spiegare l'origine e attivare la registrazione, nonché la disponibilità dell'API per il consenso e la privacy.

API FLEDGE su Android

Questa release include nuove funzioni per semplificare i test e il debug, nonché come miglioramenti interni:

  • Aggiunto il supporto per eseguire l'override degli URL remoti per il recupero della logica JavaScript durante lo sviluppo.
  • Segnalazione degli errori migliorata durante la selezione degli annunci.
  • I segmenti di pubblico personalizzati non attivi ora vengono filtrati durante la selezione degli annunci.

API Topics

Questa release include diverse modifiche significative all'API Topics, cosa importante:

  • Il tipo restituito dell'API getTopics() è stato cambiato nel nuovo Tipo di oggetto Topic che incapsula gli ID interi che corrispondono Argomenti della tassonomia e informazioni sul classificatore e sulla tassonomia e versioni successive. Dovresti aggiornare le app esistenti che utilizzano questa API.
  • L'API Topics ora richiede una nuova autorizzazione normale.
  • Introduzione della funzionalità di classificazione on-device per assegnare dinamicamente Argomenti basati su informazioni sull'app disponibili pubblicamente.

Problemi noti

  • La release iniziale di queste immagini dispositivo (revisione 6) non viene caricata Emulatore Android versione 31.2.10. Immagini del dispositivo aggiornate che soddisfano il problema è stato reso disponibile il 27 luglio 2022.

Anteprima per gli sviluppatori 3

Data di rilascio: 9 giugno 2022

Privacy Sandbox nell'Anteprima per gli sviluppatori Android 3 aggiunge funzionalità per API Attribution Reporting e FLEDGE su Android.

API Attribution Reporting

L'API Attribution Reporting migliora la privacy degli utenti eliminando il ricorso identificatori di utenti trasversali e supporta i principali casi d'uso per l'attribuzione e la misurazione delle conversioni nelle varie app.

Questa release include risorse per sviluppatori che ti aiutano a testare quanto segue Funzionalità dell'API Attribution Reporting:

  • Registra l'origine dell'attribuzione e attiva gli eventi
  • Fai pratica con l'attribuzione con priorità all'origine e post-installazione
  • Ricevi report sugli eventi
  • Ricevi report aggregabili, non criptati in questa release

Viene fornito un esempio di app e server di tecnologia pubblicitaria di riferimento per semplificare i test

Problemi noti:

FLEDGE su Android

FLEDGE su Android introduce un nuovo modo per mostrare annunci in base a segmenti di pubblico personalizzati definiti dagli sviluppatori di app e dalle interazioni all'interno delle loro app. Questa soluzione memorizza le informazioni e gli annunci associati a livello locale e fornisce una struttura per orchestrare flussi di lavoro di selezione degli annunci.

Questa release include risorse per sviluppatori che ti aiuteranno a testare le seguenti funzionalità FLEDGE Funzionalità di Android:

  • Entrare a far parte di un segmento di pubblico personalizzato o abbandonarlo e osservarne l'effetto sui valori parametro risultati dell'asta
  • Recupera il codice asta JavaScript da endpoint remoti
  • Configura e avvia aste degli annunci on-device
  • Gestire i report sulle impressioni
  • Vengono forniti un esempio di configurazione di app e server fittizio per facilitare i test

Problemi noti:

Anteprima per gli sviluppatori 2

Data di rilascio: 17 maggio 2022

L'Anteprima per gli sviluppatori 2 include anteprime in anteprima dei MeasurementManager API Attribution Reporting.

  • Puoi chiamare i numeri registerSource() e registerTrigger() per registrarti eventi relativi agli annunci per app e ricevere dati dei report a livello di evento per l'attribuzione dei contenuti. La nostra implementazione attuale utilizza l'attribuzione basata sull'ultimo touchpoint. I report sono pianificati per essere inviati come definito dal report . Fare riferimento all'API MeasurementManager di riferimento per ulteriori informazioni.

  • Il caricamento effettivo del report avviene al termine di intervalli di tempo fissi, piuttosto che all'orario esatto pianificato. L'intervallo di caricamento dei report dura 4 ore per impostazione predefinita, ma può essere sostituito con il seguente ab :

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • Un'app di esempio e un server ad tech di riferimento per i test delle API verranno sarà pubblicata in una release futura.

  • Altra MeasurementManager API Attribution Reporting come report aggregati, attribuzione post-installazione e reindirizzamenti sarà disponibile in una release futura.

Anteprima per gli sviluppatori 1

Data di rilascio: 28 aprile 2022

L'Anteprima per gli sviluppatori 1 include anteprime in anteprima dell'API Topics e SDK Runtime. Funzionalità per FLEDGE su Android e Le API Attribution Reporting saranno disponibili in un nella versione futura.

  • API Topics
      .
    • Attualmente l'API getTopics() restituisce valori di test basati sulla modalità offline per un insieme limitato di app. Le classificazioni on-device sono non ancora implementata.
    • Puoi usare i comandi adb per eseguire l'override degli intervalli di epoca e forzare l'attivatore di calcolo dell'epoca.
    • Per informazioni dettagliate, consulta la guida per gli sviluppatori di Topics.
  • SDK Runtime
      .
    • Puoi pacchettizzare e creare SDK abilitati per il runtime utilizzando il nuovo Elemento <sdk-library> nel file manifest dell'app con SDK. Installa gli SDK RE su un emulatore o un dispositivo di test supportato, come faresti normalmente durante lo sviluppo dell'app.
    • Puoi integrare un'app con gli SDK RE, caricarle in SDK Runtime e testare l'impatto dell'accesso limitato sul codice SDK: autorizzazioni, e le comunicazioni tra app e SDK. Le API di archiviazione per gli SDK RE non sono non è ancora stato implementato e sarà disponibile in una versione futura.
    • Un SDK può eseguire il rendering di contenuti o annunci banner basati su WebView nella SDK Runtime.
    • Per ulteriori informazioni, leggi la guida per gli sviluppatori SDK Runtime.
  • Controlli lint Android
      .
    • I controlli della lint di Android potrebbero mostrare erroneamente avvisi nei progetti compilati con il livello API TiramisuPrivacySandbox. Ad esempio, potresti vedere il messaggio di avviso: "La chiamata richiede il livello API 33". Puoi temporaneamente risolvere questo problema utilizzando l'annotazione @SuppressLint("NewApi").