Note di rilascio di Privacy Sandbox per Android

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

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 usando il gestore di SDK di Android Studio come API Android 34, estensione di livello 10 e dal punto di vista funzionale sono simili a [Developer Preview 9][b25], con alcune modifiche chiave.

API Protected Audience

  • Ora gli ad tech possono utilizzare la [delega dei segmenti di pubblico personalizzati][b26] 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 [integrazione con l'API Attribution Reporting][b27].

API Attribution Reporting

  • L'API Attribution Reporting ora supporta [integrazione con Protected Audience][b28]

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 e persistAdSelectionResult quando viene revocato il consenso ha causato l'arresto anomalo del processo.
  • La funzionalità di filtro per esclusione non funziona con getAdSelectionData e persistAdSelectionResult.

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 esempio com.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 a ContentProvider utilizzando ContentResolver.
  • 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:
  • 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 e registerTrigger 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 tipo WIN 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

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

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 in custom_audience_bidding_signals.
    • scoreAd() è stato rinominato in custom_audience_scoring_signals.
    • reportWin() è stato rinominato in custom_audience_reporting_signals.
  • In questa release è stato aggiunto un nuovo override di selectAds che richiede AdSelectionFromOutcomeConfig per confrontare i risultati di selectAds. 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. Utilizza no-cache o no-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.

API Attribution Reporting sull'API Android

  • In questa release è stato aggiunto il supporto dei reindirizzamenti daisy-chain per registerSource() e registerTrigger(). 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

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 e getAppSetId 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 e AppSetIdManager 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 con Uri. 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 e AppSetIdManager 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 di Attribution-Reporting-Register-Source
    • Trigger: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data e Attribution-Reporting-Register-Aggregatable-Values sono stati consolidati in un'unica intestazione denominata Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects è ancora un'intestazione separata

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 in selectAds().
    • È stato 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.
    • Sono state aggiunte le classi TestCustomAudienceManager e TestAdSelectionManager 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 e reportImpression hanno limiti di tempo di esecuzione, dopodiché la chiamata verrà terminata.
    • selectAds e reportImpression 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 e reportImpression ora convalidano l'oggetto AdSelectionConfig 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 chiamata joinCustomAudience. 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.
  • 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 o null. 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

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 oggetto Topic 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:

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:

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() e registerTrigger() 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'API MeasurementManager.

  • 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.
  • 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.
  • 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").