Privacy Sandbox su Android offre programmi Anteprima per gli sviluppatori e beta. Nel corso del tempo introdurremo nuove API e funzionalità nell'Anteprima per sviluppatori e promuoveremo le API stabilizzate al programma beta. Incoraggiamo feedback.
Se è la prima volta che utilizzi Privacy Sandbox su Android, inizia dalla Panoramica del programma. Per iniziare a integrare Privacy Sandbox nel tuo progetto, configura il tuo ambiente di sviluppo e scarica Privacy Sandbox su Android sul dispositivo di test o sull'emulatore.
Release attuali
Anteprima Android VanillaIceCream
API Protected Audience
- È stata aggiunta la possibilità di trasferire gli annunci contestuali autenticati in un'asta protetta. Sono inclusi anche i filtri negativi per le app già installate sul dispositivo e la quota limite su numero di clic, impressioni, visualizzazioni o vincite. L'implementazione è diversa dalle iterazioni precedenti in quanto gli annunci contestuali devono essere firmati dalla tecnologia pubblicitaria. Scopri come implementare questa funzionalità nella guida per gli sviluppatori.
- ContextualAds è stato rinominato SignedContextualAds insieme a getter e setter correlati in AdSelectionConfig; getPerBuyerSignedContextualAds,setPerBuyerSignedContextualAds
- Se viene superata un'app contestuale non autenticata, verrà rimossa dall'asta
API Attribution Reporting
- La possibilità di eliminare una fonte se l'app è già installata sul dispositivo
- Aggiornamenti dai report sugli eventi Lite-Flessibili ai report sugli eventi completamente flessibili
Aggiornamento di Privacy Sandbox su Android beta di novembre 2023
Questa release di Privacy Sandbox su Android beta include aggiornamenti alle API Privacy Sandbox sui dispositivi pubblici Android 14. L'SDK e le immagini del dispositivo possono essere scaricati utilizzando il gestore di SDK di Android Studio come API Android 34, estensione di livello 10 e dal punto di vista funzionale sono simili ad Anteprima per sviluppatori 9, con alcune modifiche chiave.
API Protected Audience
- Ora gli ad tech possono utilizzare la delega di segmenti di pubblico personalizzati per entrare a far parte di un segmento di pubblico personalizzato per conto di un acquirente che non ha una presenza sul dispositivo.
- Android ora supporta l'esecuzione di un'asta sui servizi di offerte e aste.
- Le aste Protected Audience supportano la fatturazione CPC.
- Le aste e i report Protected Audience ora supportano le intestazioni delle versioni dei dati per gli indicatori di offerta attendibili.
- Le aste Protected Audience supportano il filtro della quota limite negli eventi WIN.
- Protected Audience ora supporta l'integrazione con l'API Attribution Reporting.
API Attribution Reporting
- L'API Attribution Reporting ora supporta l'integrazione con Protected Audience
Runtime SDK
- Possibilità dall'SDK di caricare altri SDK all'interno del runtime SDK per supportare i casi d'uso di mediazione
Release precedenti
Anteprima per sviluppatori 10
Data di uscita: 19 dicembre 2023
Limitazioni note
- Esiste un problema che causa l'arresto anomalo di Google Play Services in background e informa ripetutamente l'utente:
- Il riavvio del dispositivo potrebbe risolvere il problema.
- Durante il test, se hai 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. Per impostare il dispositivo sulla schermata Home, 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 alla rete 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 pertinenti per l'installazione di app. Con questa pagina di sviluppo, rilasciamo API
per consentire ai tecnici pubblicitari di:
- Seleziona gli indicatori archiviando gli eventi delle app in uno spazio di archiviazione protetto sul dispositivo, che vengono utilizzati per pubblicare annunci pertinenti per l'installazione di app.
- Esegui un'asta protetta per i servizi di asta e di offerta in esecuzione all'interno di ambienti di esecuzione attendibili, 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 Protected Audience, che attiva le dimensioni personalizzate dei segmenti di pubblico nei report di riepilogo aggregati.
- Supporta il fornitore Google Cloud in qualità di TEE per il servizio di aggregazione.
- Aggiunge il campo shared_debug_key per supportare il debug dell'attribuzione su più reti senza reindirizzamenti.
- Aggiunge intestazioni di versione nelle richieste di report di debug dettagliato.
Personalizzazione sul dispositivo
- Release iniziale per i ricercatori e sviluppo iniziale.
- La personalizzazione on-device introduce un modo innovativo per personalizzare prodotti e servizi fornendo al contempo una maggiore protezione della privacy dell'utente finale. La personalizzazione on-device fornisce una serie 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 dei modelli utilizzando l'apprendimento federato. L'uso del calcolo federato da parte della personalizzazione on-device si baserà sull'addestramento del modello e (facoltativamente, se necessario) sull'inferenza.
- Corrispondenza in base a Cuckoo Filtra e corrispondenza incrociata tra dati disparati.
- Addestramento differenziato privato (DP) di modelli sparsi mediante nuove tecniche come la minimizzazione alternata DP (per l'addestramento su dati dislocati in posizioni diverse) e la personalizzazione dei modelli nel DP del cartellone pubblicitario.
Anteprima per sviluppatori 9
Data di uscita: 15 agosto 2023
Limitazioni note
- I dati delle aste generati chiamando l'API Bidding e l'API dell'asta non vengono eliminati automaticamente in DP9.
- La chiamata a
getAdSelectionData
epersistAdSelectionResult
quando viene revocato il consenso ha causato l'arresto anomalo del processo. - La funzionalità di filtro per esclusione non funziona con
getAdSelectionData
epersistAdSelectionResult
.
API Protected Audience
- Ora gli ad tech possono utilizzare la delega di segmenti di pubblico personalizzati per unire un segmento di pubblico personalizzato a un chiamante sul dispositivo.
- Android ora supporta l'esecuzione di un'asta nei servizi di 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'asta è stata persa o per identificare problemi nella logica JavaScript.
API Attribution Reporting
- Questa release migliora i report di debug per l'API Attribution Reporting nei seguenti modi:
- Supporto di report di debug dettagliati supportati sul web.
- Attivazione dei report di debug dell'attribuzione cross-web e app (richiede l'ID pubblicità sia per la registrazione web che per le app).
- I tecnici pubblicitari possono configurare i parametri del rumore per diversi scenari di generazione dei report.
- In questa versione passa all'attribuzione basata sull'origine, il che significa che:
- L'origine è 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 gli ad tech possono disattivare la registrazione per i casi d'uso di Attribution Reporting a livello locale.
Runtime SDK
- 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 esempiocom.android.providers.settings.SettingsProvider
), nei casi in cui i dati ottenuti non contengono identificatori e non possono essere utilizzati per creare un'impronta dell'utente. Questi controlli si applicano anche all'accesso aContentProvider
utilizzandoContentResolver
. - L'SDK è in grado di accedere solo a un sottoinsieme di ricevitori di trasmissioni protetti (come
android.intent.action.AIRPLANE_MODE
). - L'SDK può avviare un'attività appartenente a un'altra app, ma con limiti relativi a ciò che può essere inviato nell'intent.
Aggiornamento di Privacy Sandbox su Android beta di marzo 2023
La release di marzo 2023 di Privacy Sandbox su Android beta include aggiornamenti alle API Privacy Sandbox sui dispositivi pubblici Android 13. Questa release include le API Ad Services Extensions 5 ed è simile ad Anteprima per gli sviluppatori 6, con alcune modifiche chiave.
Limitazioni note
- Il job di recupero in background eseguito periodicamente per aggiornare i segmenti di pubblico personalizzati FLEDGE causa l'arresto anomalo del processo. A causa di questo problema, FLEDGE è disattivato per impostazione predefinita.
Generali
- Puoi utilizzare l'API Attribution Reporting a partire da questa release. L'API era
precedentemente disabilitata. Se hai utilizzato l'API Attribution Reporting nella release beta precedente, cancella i dati dell'app o del dispositivo prima di utilizzare questa release beta
seguendo uno dei seguenti passaggi:
- Su un dispositivo o un emulatore, vai a Impostazioni e svuota lo spazio di archiviazione specifico dell'app (non solo la cache) per le app utilizzate per i test.
- Esegui il ripristino dei dati di fabbrica sul dispositivo fisico o emulato.
- Per un dispositivo emulato, esegui la funzione Cancella i dati.
- Attribution Reporting ora supporta le chiavi di debug, che consentono agli sviluppatori di ricevere report inalterati e report avanzati per la privacy dall'API Attribution. Le chiavi di debug offrono un'opportunità per ottenere una maggiore visibilità su come sono strutturati i report durante la transizione a Privacy Sandbox.
- Attribution Reporting ha riscontrato di recente un bug con i servizi pubblicitari in cui i valori
registerSource
eregisterTrigger
non andrebbero a buon fine con alcune eccezioni. Se hai riscontrato questi problemi durante lo sviluppo, è stata implementata una soluzione che dovrebbe risolversi nel tempo. - La funzionalità di anteprima dell'API Topics ora è identica a quella di Privacy Sandbox nelle anteprime per sviluppatori Android. Un chiamante dell'API Topics può visualizzare l'anteprima degli argomenti senza includere la chiamata per il recupero dell'argomento nel calcolo dell'epoca settimanale o influire sull'elenco degli argomenti osservati per il chiamante. Per maggiori dettagli, consulta il campo
shouldRecordObservation
. Per attivare i test in FLEDGE su Android, registrati al programma beta e utilizza lo stesso Account Google per accedere ai dispositivi di test. In caso contrario, i tentativi di chiamare le API causano un evento
IllegalStateException
con il messaggio "Il servizio non è disponibile". FLEDGE dovrebbe essere reintegrato nella prossima release beta.Nel frattempo, i test con Anteprime per gli sviluppatori possono continuare ed è incoraggiato e FLEDGE può essere abilitato manualmente sui dispositivi con le seguenti avvertenze:
Puoi attivare FLEDGE con i seguenti comandi adb. Tuttavia, questo causa l'arresto anomalo del processo di recupero in background, con un impatto negativo sulle metriche di integrità del sistema. Questa non è una soluzione definitiva perché questi valori potrebbero essere reimpostati dalla piattaforma.
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 sviluppatori 8
Data di rilascio: 23 maggio 2023
Limitazioni note
- Sebbene i filtri per la quota limite di tipo
WIN
possano essere aggiunti agli annunci Protected Audience, il tipoWIN
non è ancora supportato e i filtri di questo tipo vengono ignorati. - Per generare report sulle impressioni vincenti per gli acquirenti vincitori delle aste Protected Audience, gli acquirenti devono essere registrati a Privacy Sandbox. Questo requisito non può essere sostituito.
- Per accedere alle impostazioni di Privacy Sandbox su un dispositivo in cui è disponibile Privacy Sandbox, vai a Impostazioni > Google > Annunci > Privacy Sandbox.
- Impossibile eseguire il deployment di progetti con emulatori su Android Studio Giraffe. Le altre versioni di Android Studio dovrebbero funzionare correttamente. Il 26 maggio 2023 verrà implementata una correzione per Android Studio Giraffe.
API Protected Audience
- FLEDGE è stata rinominata API Protected Audience.
- Protected Audience è stata disattivata per impostazione predefinita nella release beta di marzo 2023. Questo problema è stato risolto e Protected Audience è ora implementata per un numero limitato di utenti.
- Sono state aggiunte le seguenti nuove funzionalità:
- Quota limite
- Report sulle interazioni
- Includere annunci contestuali in un'asta
- Filtro degli annunci esclusi per l'installazione di app
- Gli URI predefiniti sono una libreria di logica predefinita da utilizzare nel processo di asta dagli adtech anziché dal loro codice JavaScript
- Controllo delle versioni per le funzioni JavaScript di offerta e valutazione
API Attribution Reporting
- Filtri attivatore OR aggiunti. Ciò significa che i filtri ora sono costituiti da un insieme
di filtri, ovvero un elenco di mappe di filtri. Se nessuna delle mappe dei filtri nel set corrisponde
ai dati del filtro dell'origine, l'oggetto
event_trigger_data
viene ignorato. - La scadenza delle impressioni e la finestra di report per le API di aggregazione e a livello di evento sono state disaccoppiate.
- Aggiunto il supporto per i report aggregabili delle chiavi di deduplicazione.
- È stato aggiunto
scheduled_report_time
ai report sugli eventi per garantire la parità con Privacy Sandbox per il web. - Implementata attribuzione su più reti senza reindirizzamenti.
Runtime SDK
- Implementata comunicazione tra SDK e SDK per il processo dell'app e per il processo di runtime dell'SDK.
- Assistenza personalizzata per le attività degli SDK
Anteprima per sviluppatori 7
Data di uscita: 26 gennaio 2023
API di FLEDGE su Android
- Il parametro
custom_audience_signals
è stato rinominato nei seguenti metodi JavaScript:generateBid()
è stato rinominato incustom_audience_bidding_signals
.scoreAd()
è stato rinominato incustom_audience_scoring_signals
.reportWin()
è stato rinominato incustom_audience_reporting_signals
.
- In questa release è stato aggiunto un nuovo override di
selectAds
che richiedeAdSelectionFromOutcomeConfig
per confrontare i risultati diselectAds
. In questo modo, gli SDK di tecnologia pubblicitaria che sfruttano questa API possono eseguire la mediazione a cascata. Ulteriori dettagli sono descritti nella guida per gli sviluppatori. - L'API
selectAds()
ora supporta la memorizzazione nella cache per il codice JavaScript di offerta e di punteggio recuperato durante il processo di selezione degli annunci.- La cache può essere controllata con intestazioni
Cache-Control
restituite dai server durante la chiamata di recupero JavaScript. Utilizzano-cache
ono-store
per impedire che le risposte JavaScript vengano memorizzate nella cache e utilizza la massima età per controllare la durata della cache. - La voce corrente della cache
max-age
è impostata su due giorni per impostazione predefinita.
- La cache può essere controllata con intestazioni
API Attribution Reporting sull'API Android
- In questa release è stato aggiunto il supporto dei reindirizzamenti daisy-chain per
registerSource()
eregisterTrigger()
. Il consumer API ora può utilizzare un reindirizzamento HTTP come risposta del server.
Release beta iniziale, gennaio 2023
Data di uscita: 9 gennaio 2023
Privacy Sandbox su Android beta 1 rappresenta la prima disponibilità di API Privacy Sandbox sui dispositivi pubblici e aggiunge miglioramenti alle aree elencate di seguito.
Generali
- Privacy Sandbox su Android Beta 1 è equivalente a Developer Preview 5, con alcune funzionalità e limitazioni aggiuntive elencate di seguito.
- Gli sviluppatori devono completare una procedura di registrazione per utilizzare le API correlate agli annunci (tra cui Topics, FLEDGE e Attribution Reporting). Il processo di registrazione verifica l'identità dello sviluppatore e raccoglie i dati specifici dello sviluppatore necessari dalle API.
- Con la release di Privacy Sandbox su Android beta 1, gli sviluppatori che hanno registrato e inviato dettagli alla lista consentita possono avere l'opportunità di eseguire test sui propri dispositivi fisici. Per sviluppare in base ad API stabili nella release, scarica la nuova versione SDK Ad Services Extensions 4.
API Topics
- Il copertivo della categoria di classificazione argomenti Android Colab consente agli sviluppatori di capire meglio come funziona il modello di classificazione.
API Attribution Reporting
- Attribution Reporting è stato disattivato e non può essere utilizzato in questa release. L'accesso a questa API dovrebbe essere riattivato nella prossima release beta. Ti invitiamo a continuare a eseguire test con Anteprime per gli sviluppatori.
Runtime SDK
Si prevede che le seguenti limitazioni verranno risolte nella prossima release principale della piattaforma Android:
- Al momento, il rendering degli annunci in una visualizzazione scorrevole come
RecyclerView
non funziona correttamente. Potresti riscontrare jank se l'elemento viene ridimensionato. Gli eventi di scorrimento al tocco dell'utente non vengono trasmessi correttamente al runtime. - Il rendering di
WebView
non è disponibile nel processo di SDK Runtime. - Lo spazio di archiviazione per SDK non è disponibile.
- Il supporto delle API
getAdId
egetAppSetId
non è ancora stato attivato.
Anteprima per sviluppatori 6
Data di rilascio: 31 ottobre 2022
Privacy Sandbox su Anteprima per sviluppatori Android 6 aggiunge miglioramenti alle seguenti aree:
Generali
In preparazione all'implementazione in produzione, Anteprima per sviluppatori 6 ha introdotto un flag per disabilitare per impostazione predefinita l'accesso all'API Privacy-Privacy. A scopo di test, abilita l'accesso all'API Privacy-Preserving nell'anteprima per sviluppatori eseguendo questo comando:
adb shell device_config put adservices global_kill_switch false
Le API
AdIdManager
eAppSetIdManager
richiedono Google Play Services 22.36.16 o versioni successive.- Su un dispositivo Android, verifica che la versione corretta sia elencata in Impostazioni > App > Google Play Services.
- Se devi aggiornare Google Play Services alla versione corretta, accedi all'emulatore o al dispositivo di test Android con un Account Google. Quindi, vai a Google Play Store > icona profilo > Impostazioni > Informazioni. Sotto l'intestazione Versione del Play Store, tocca Aggiorna Play Store.
- Questo passaggio è applicabile solo per lo sviluppo e i test e non sarà necessario dopo l'implementazione di Privacy Sandbox per gli utenti pubblici.
API Topics
- È stata aggiunta un'API Anteprima per attivare/disattivare la registrazione di
getTopics
come osservatore. - Modifiche di minore entità al codice di inizializzazione per la classe
GetTopicsRequest
. - È stata rilasciata la guida all'integrazione di Topics.
API di FLEDGE su Android
- Se esegui test su server reali, viene applicata l'abilitazione dell'API. Per configurare il dispositivo, segui questi passaggi. Questi passaggi non sono necessari se utilizzi gli override da remoto presenti nell'app di esempio.
- Modifiche che provocano un errore:
Url
sostituito nei parametri conUri
. Ciò vale per tutte le API FLEDGE e per JavaScript personalizzato per la logica di offerta e punteggio.- Campo
owner
rimosso dagli input dell'API Custom Audience.
- I segmenti di pubblico personalizzati incompleti sono ora immediatamente idonei per l'aggiornamento in background.
- Il limite di memoria JavaScript è ora impostato su 10 MB. Ciò vale per la logica di offerta e punteggio.
API Attribution Reporting
- I tecnici pubblicitari devono registrarsi prima di poter utilizzare l'API Attribution Reporting nell'Anteprima per sviluppatori 6. Per ulteriori informazioni, consulta Creare un account Privacy Sandbox.
- Questa release introduce le chiavi di debug, che consentono agli sviluppatori di ricevere report senza modifiche insieme ai report ottimizzati per la privacy dell'API Attribution Reporting. Le chiavi di debug offrono la possibilità di ottenere una maggiore visibilità su come sono strutturati i report durante la transizione con Privacy Sandbox.
Anteprima per sviluppatori 5
Generali
- Prima di poter accedere alle API Privacy Sandbox nell'Anteprima per sviluppatori 5, devi abilitare le API e configurare autorizzazioni specifiche per le API.
- I design per Privacy Sandbox su Android consentono agli utenti di controllare se 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 sviluppatori 5. Puoi abilitare l'accesso API utilizzando un comando adb.
- L'app chiamante deve specificare autorizzazioni specifiche dell'API nel manifest e
le configurazioni
AdServices
correlate che controllano l'accesso per gli SDK incorporati.
- Quando vengono eseguite in primo piano, le app devono chiamare le API che tutelano la privacy.
AdIdManager
eAppSetIdManager
non sono attualmente operativi. Verranno abilitate in una release futura.
Runtime SDK
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 ulteriori eventi del ciclo di vita dell'SDK abilitati per il runtime, ad esempio al termine del processo dell'SDK.
API Attribution Reporting
Questa release introduce funzionalità aggiuntive nell'API Attribution Reporting, tra cui:
- Supporto dei report sull'aggregazione criptati.
- Supporto della misurazione su più app e web.
- Intestazioni consolidate nell'origine e attivano le risposte di registrazione:
- Fonte:
Attribution-Reporting-Register-Aggregatable-Source
ora fa parte diAttribution-Reporting-Register-Source
- Trigger:
Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data
eAttribution-Reporting-Register-Aggregatable-Values
sono stati consolidati in un'unica intestazione denominataAttribution-Reporting-Register-Event-Trigger
Attribution-Reporting-Redirects
è ancora un'intestazione separata
- Fonte:
API di FLEDGE su Android
Questa release include diversi nuovi miglioramenti e funzioni, nonché modifiche che provocano errori:
- Modifiche che provocano un errore:
runAdSelection()
è stato rinominato inselectAds()
.- È stato sostituito il parametro di
AdSelectionConfig.Builder.setAdSelectionSignals()
conAdSelectionSignals
, che rappresenta un oggetto JSON. - È stato sostituito l'utilizzo di
String
per rappresentare un acquirente/venditore di ad tech con l'oggettoAdTechIdentifier
. - Sono state aggiunte le classi
TestCustomAudienceManager
eTestAdSelectionManager
per eseguire l'override del recupero di JavaScript da remoto. - Il proprietario di un segmento di pubblico personalizzato deve essere il nome del pacchetto dell'app per le chiamate.
- Le API FLEDGE ora convalidano l'app chiamante in base a una serie di restrizioni e limitazioni descritte nella guida per gli sviluppatori. Ecco alcuni esempi degni di nota.
- Ora
selectAds
ereportImpression
hanno limiti di tempo di esecuzione, dopodiché la chiamata verrà terminata. selectAds
ereportImpression
ora presentano un limite alla memoria utilizzata durante l'esecuzione di JavaScript. Le API generano un errore se il consumo di memoria supera i limiti configurati.selectAds
ereportImpression
ora convalidano l'oggettoAdSelectionConfig
per garantire che i campi siano sintatticamente validi e che gli URL siano compresi nell'eTLD+1 utilizzato nel campo del venditore.AdServices
ora convalida i segmenti di pubblico personalizzati al momento della creazione. Alcune di questa convalida includono la garanzia che la data di scadenza sia valida e applica un limite al numero di segmenti di pubblico personalizzati che un'app può creare e alle dimensioni totali degli annunci forniti nella chiamatajoinCustomAudience
. La convalida impone inoltre che gli URI forniti per gli indicatori, il recupero della logica di offerta e il recupero in background siano tutti sotto il dominio dell'acquirente.
- Ora
- I metadati dei segmenti di pubblico personalizzati vengono aggiornati quotidianamente tramite una procedura di recupero in background.
- I segmenti di pubblico personalizzati vengono rimossi quando viene disinstallata l'app "proprietario".
- È stato aggiunto il supporto per specificare gli indicatori di punteggio attendibili e i dati di Offerte attendibili durante la selezione degli annunci. Consulta un esempio di codice per il formato della risposta.
- Le API FLEDGE per Android dipendono da WebView versione 105.0.5195.58 o successiva. Per maggiori dettagli, consulta le informazioni sulla configurazione nella guida per gli sviluppatori.
Problemi noti:
Quando aggiungi un segmento di pubblico personalizzato, la piattaforma attualmente non esegue aggiornamenti in background immediatamente, se uno qualsiasi dei metadati o dei valori
AdData
è vuoto onull
. Il segmento di pubblico personalizzato non potrà essere selezionato fino a quando non verrà aggiornato un giorno dopo. In una versione futura, i segmenti di pubblico personalizzati incompleti saranno immediatamente idonei per gli aggiornamenti del recupero in background. L'attuale limite di memoria predefinito per l'esecuzione di JavaScript è troppo basso e potrebbe causare l'arresto anomalo di JavaScriptEngine sui dispositivi nei normali carichi di lavoro. L'esecuzione di JavaScript potrebbe arrestarsi in modo imprevisto con il messaggio di errore"Fatal javascript OOM in CALL_AND_RETRY_LAST"
.Puoi risolvere manualmente il problema configurando la soglia di memoria adeguata con il seguente comando:
adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"
Gli annunci dei segmenti di pubblico personalizzati che non corrispondono alla struttura JSON richiesta vengono aggiornati durante il recupero in background.
API Topics
- Tassonomia aggiornata per la classificazione delle app mobile.
- Sono state aggiornate la proposta di progettazione e le app di esempio con il lancio dell'interfaccia utente delle impostazioni per visualizzare gli argomenti assegnati.
Aggiornamenti agli strumenti
La versione canary di Android Studio supporta la creazione di APK dell'SDK con un nuovo tipo di modulo. La guida per gli sviluppatori SDK Runtime è stata aggiornata e le app di esempio di Privacy Sandbox su GitHub riflettono questo aggiornamento.
Anteprima per sviluppatori 4
Data di uscita: 14 luglio 2022
Privacy Sandbox su Anteprima per sviluppatori Android 4 aggiunge miglioramenti alle seguenti aree:
Runtime SDK
- Ora le app possono comunicare con gli SDK abilitati per il runtime tramite l'aggiunta di
sendData()
. - Lo spazio di archiviazione locale è ora disponibile nel processo di SDK Runtime.
- Un SDK può anche eseguire il rendering di annunci o contenuti autonomi basati su video nel runtime dell'SDK.
- Sono stati aggiunti chiarimenti sull'utilizzo della riflessione per includere la possibilità di utilizzare la riflessione, a condizione che i contenuti non siano in un altro RE-SDK.
API Attribution Reporting
Questa release introduce modifiche per migliorare la chiarezza sull'utilizzo dell'API Attribution Reporting, ad esempio:
- Modifiche al formato del report aggregato per migliorare la leggibilità.
- Sono stati aggiornati i campi dell'intestazione per le funzionalità Filtro delle conversioni e Idoneità.
- Sono stati aggiunti chiarimenti nel riferimento API WebApp per spiegare l'origine e la registrazione dell'attivatore, nonché la disponibilità dell'API Privacy e Consent.
API di FLEDGE su Android
Questa release include nuove funzionalità utili per i test e il debug, nonché miglioramenti interni:
- Aggiunto il supporto per eseguire l'override degli URL remoti per recuperare la logica JavaScript durante lo sviluppo.
- Miglioramento dei report sugli errori durante la selezione degli annunci.
- I segmenti di pubblico personalizzati non attivi vengono ora esclusi durante la selezione degli annunci.
API Topics
Questa release include diverse modifiche significative all'API Topics, soprattutto:
- Il tipo restituito dell'API
getTopics()
è stato modificato nel nuovo tipo di oggettoTopic
che incapsula gli ID interi corrispondenti agli argomenti nella tassonomia, nonché alle informazioni sulle versioni di classificatori e tassonomie. Devi aggiornare le app esistenti utilizzando questa API. - L'API Topics ora richiede una nuova autorizzazione normale.
- Introduzione del sistema "On-Device Classifier" per l'assegnazione dinamica degli argomenti in base alle informazioni sull'app disponibili pubblicamente.
Problemi noti
La release iniziale di queste immagini del dispositivo (revisione 6) non viene caricata nell'emulatore Android versione 31.2.10. Le immagini del dispositivo aggiornate che risolvono il problema sono state rese disponibili dal 27 luglio 2022.
Anteprima per sviluppatori 3
Data di uscita: 9 giugno 2022
Privacy Sandbox su Anteprima per sviluppatori Android 3 aggiunge funzionalità per l'API Attribution Reporting e FLEDGE su Android.
API Attribution Reporting
L'API Attribution Reporting migliora la privacy degli utenti eliminando il ricorso a identificatori di utenti trasversali e supporta casi d'uso chiave per l'attribuzione e la misurazione delle conversioni nelle app.
Questa release include risorse per sviluppatori utili per testare le seguenti funzionalità dell'API Attribution Reporting:
- Registra l'origine dell'attribuzione e attiva gli eventi
- Attribuisci la priorità all'origine e applica l'attribuzione post-installazione
- Ricevi report sugli eventi
- Ricevi report aggregabili, che non sono criptati in questa release
Vengono forniti un'app di esempio e un server ad tech di riferimento per facilitare i test
Problemi noti:
- L'API Attribution Reporting non cripta ancora i report aggregati in base alla proposta di progettazione. A scopo di test, i payload dei report vengono inviati in testo in chiaro fino all'implementazione della crittografia.
FLEDGE su Android
FLEDGE su Android introduce un nuovo modo per mostrare annunci basati su segmenti di pubblico personalizzati definiti dagli sviluppatori di app e sulle interazioni all'interno della loro app. Questa soluzione memorizza informazioni e annunci associati localmente e fornisce un framework per orchestrare i flussi di lavoro per la selezione degli annunci.
Questa release include risorse per sviluppatori che consentono di testare le seguenti funzionalità di FLEDGE su Android:
- Unisciti o esci da un segmento di pubblico personalizzato e osserva in che modo i valori dei parametri possono influenzare i risultati delle aste
- Recupera il codice asta JavaScript da endpoint remoti
- Configurare e avviare aste dell'annuncio on-device
- Gestire i report sulle impressioni
- Vengono forniti un'app di esempio e una configurazione simulata del server per facilitare i test
Problemi noti:
- Un segmento di pubblico personalizzato può partecipare alla selezione degli annunci anche prima della sua "ora di attivazione".
Anteprima per sviluppatori 2
Data di rilascio: 17 maggio 2022
Anteprima per sviluppatori 2 include anteprime in anteprima delle
API per i report sull'attribuzione di MeasurementManager
.
- Puoi chiamare
registerSource()
eregisterTrigger()
per registrare eventi relativi agli annunci per app e ricevere dati dei report a livello di evento per l'attribuzione app-app. La nostra attuale implementazione utilizza l'attribuzione basata sull'ultimo touchpoint. I report sono pianificati per l'invio in base a quanto definito dalle finestre di reporting. Per saperne di più, consulta la documentazione dell'APIMeasurementManager
. Il caricamento effettivo del report avviene alla fine di intervalli di tempo fissi, anziché all'esatto orario pianificato. Per impostazione predefinita, l'intervallo di caricamento dei report è di 4 ore, ma può essere sostituito con il seguente comando adb:
adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>
In una release futura verranno pubblicati un'app di esempio e un server ad tech di riferimento per i test delle API.
Altre funzionalità dell'API di reporting sull'attribuzione di
MeasurementManager
, come i report aggregati, l'attribuzione post-installazione e i reindirizzamenti, saranno disponibili in una release futura.
Anteprima per sviluppatori 1
Data di uscita: 28 aprile 2022
Developer Preview 1 include anteprime dell'API Topics e dell'SDK Runtime. La funzionalità per FLEDGE su Android e le API Attribution Reporting saranno disponibili in una release futura.
- API Topics
- Al momento, l'API
getTopics()
restituisce valori di test basati sulla classificazione offline per un gruppo limitato di app. Le classificazioni on-device non sono ancora implementate. - Puoi utilizzare i comandi adb per eseguire l'override degli intervalli delle epoch e forzare il calcolo delle epoch con trigger.
- Per informazioni dettagliate, leggi la guida per gli sviluppatori di Topics.
- Al momento, l'API
- SDK Runtime
- Puoi pacchettizzare e creare SDK abilitati per il runtime (RE SDK) utilizzando il nuovo
elemento
<sdk-library>
nel file manifest della tua app SDK. Installa gli SDK RE su un emulatore o un dispositivo di test supportato, come faresti normalmente per installare un'app durante lo sviluppo. - Puoi integrare un'app con gli SDK RE, caricarli in SDK Runtime e testare l'impatto dell'accesso limitato sul codice SDK: autorizzazioni, memoria e comunicazioni tra app. Le API Storage per gli SDK RE non sono ancora state implementate e saranno disponibili in una release futura.
- Un SDK può eseguire il rendering di contenuti o annunci banner basati su
WebView
in SDK Runtime. - Per saperne di più, leggi la guida per gli sviluppatori SDK Runtime.
- Puoi pacchettizzare e creare SDK abilitati per il runtime (RE SDK) utilizzando il nuovo
elemento
- Controlli lint di Android
- I controlli lint di Android potrebbero mostrare erroneamente avvisi nei progetti compilati con il livello API
TiramisuPrivacySandbox
. Ad esempio, potresti visualizzare il messaggio di avviso: "La chiamata richiede il livello API 33". Puoi risolvere temporaneamente questo problema utilizzando l'annotazione@SuppressLint("NewApi")
.
- I controlli lint di Android potrebbero mostrare erroneamente avvisi nei progetti compilati con il livello API