privacysandbox ads

  
Questa libreria consente l'integrazione con le API incentrate sulla tutela della privacy, che fanno parte di Privacy Sandbox su Android.
Ultimo aggiornamento Release stabile Release Candidate Versione beta Versione alpha
12 marzo 2025 - - 1.1.0-beta12 -

Dichiarazione delle dipendenze

Per aggiungere una dipendenza da privacysandbox-ads, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli elementi necessari nel file build.gradle per la tua app o il tuo modulo:

Alla moda

dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
 
}

Kotlin

dependencies {

    implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12")

    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
   
}

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di compilazione.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Monitoraggio problemi.

Versione 1.1

Versione 1.1.0-beta12

12 marzo 2025

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12 vengono rilasciati. La versione 1.1.0-beta12 contiene questi commit.

Nuove funzionalità

  • Priorità pubblico personalizzato: abbiamo aggiunto un campo di priorità nel pubblico personalizzato. In questo modo, gli acquirenti possono specificare un valore di priorità in un CustomAudience. Questo valore viene utilizzato per identificare i segmenti di pubblico personalizzati da includere in un'asta se l'insieme dei segmenti di pubblico personalizzati dell'acquirente supera i limiti di dimensione per acquirente
  • Configurazione del venditore: questa funzionalità consente ai venditori di definire i parametri dell'asta per controllare le dimensioni del payload e i partecipanti all'asta. La configurazione dell'asta del venditore consente ai venditori di specificare:
    • Elenco di acquirenti consentiti
    • Per le aste avviate dal venditore in questione, solo gli acquirenti nella lista consentita potranno contribuire CustomAudiences per l'asta
    • Limite di dimensioni per acquirente
    • I venditori potrebbero specificare un limite per acquirente per regolare le dimensioni dei dati caricati da ciascun acquirente nel payload inviato a SellerFrontendService. Se l'acquirente supera il limite di dimensione per acquirente, verrà utilizzata la priorità CustomAudience impostata nella configurazione del payload dell'acquirente per ottenere i dati nei limiti previsti.
    • Limite di dimensione massima per il payload
    • I venditori potrebbero avere allocazioni di risorse diverse e potrebbero voler impostare un limite di dimensione massima per il payload dell'asta per richiesta. Il limite di dimensioni massime rispetterà i bucket di dimensioni fisse impostati dall'API ProtectedAudience.
  • Aggiornamenti dei segmenti di pubblico personalizzati differiti: questa funzionalità consente agli acquirenti di pianificare aggiornamenti differiti per i segmenti di pubblico personalizzati. Ogni richiesta di aggiornamento consente all'utente che effettua la chiamata di pianificare un aggiornamento ritardato utilizzando la nuova API scheduleCustomAudienceUpdate(). Per ogni aggiornamento, l'utente può specificare insiemi di segmenti di pubblico personalizzato a cui partecipare o da cui uscire.

Modifiche all'API

  • Aggiungere la configurazione del venditore nell'API GetAdSelectionRequest (Ibb5c7)
  • Introduzione dell'API ScheduleCustomAudienceUpdate come sperimentale (I6b905)

Versione 1.1.0-beta11

30 ottobre 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11 vengono rilasciati. La versione 1.1.0-beta11 contiene questi commit.

Nuove funzionalità

  • Questo aggiornamento rimuove il supporto per la misurazione di Privacy Sandbox e le API adid su Android R, che è stata ritirata. Le chiamate per ottenere le classi di gestione su Android R ora restituiranno null.

Versione 1.1.0-beta10

21 agosto 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10 vengono rilasciati. La versione 1.1.0-beta10 contiene questi commit.

Modifiche all'API

  • Aggiungere sovraccarichi del costruttore Java mancanti per le API sperimentali GetAdSelectionDataOutcome, PersistAdSelectionResultRequest, ReportEventRequest e FetchAndJoinCustomAudienceRequest. (I19e7f)

Versione 1.1.0-beta09

10 luglio 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09 vengono rilasciati. La versione 1.1.0-beta09 contiene questi commit.

Modifiche all'API

  • Aggiungi le sovraccaricamenti del costruttore Java mancanti per l'API sperimentale GetAdSelectionDataRequest. (Ifbf88).

Versione 1.1.0-beta08

26 giugno 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08 vengono rilasciati. La versione 1.1.0-beta08 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto il supporto per gli indicatori delle app protette.
  • Supporta più provider cloud per le aste di server B&A.

Modifiche all'API

  • L'API sperimentale GetAdSelectionDataRequest::seller non ammette valori null. (I68044)
  • Aggiungi l'API sperimentale GetAdSelectionDataRequest::coordinatorOriginUri. (I18c0b)
  • È stata aggiunta l'API updateSignals. (Ia8512)

Versione 1.1.0-beta07

14 maggio 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07 vengono rilasciati. La versione 1.1.0-beta07 contiene questi commit.

Nuove funzionalità

  • GetTopics ora supporta le risposte criptate nell'ambito di GetTopicsResponse.

Modifiche all'API

  • EncryptedTopic è stato aggiunto al corso GetTopicResponse. (Iab362)

Versione 1.1.0-beta06

17 aprile 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06 vengono rilasciati. La versione 1.1.0-beta06 contiene questi commit.

Nota

  • A partire dalla release 1.1.0-beta06 di privacysandbox-ads jetpack, tutti i dispositivi Android R con flag abilitati potranno accedere alle PPAPI. Per qualsiasi caso d'uso che non supporti Android R, saranno necessarie protezioni aggiuntive all'interno del codice che utilizza il codice jetpack privacysandbox-ads.

Nuove funzionalità

  • Supporto della compatibilità con le versioni precedenti per Android R.

Versione 1.1.0-beta05

3 aprile 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05 vengono rilasciati. La versione 1.1.0-beta05 contiene questi commit.

Correzioni di bug

  • È stata aggiunta la rilevazione degli errori quando non viene trovata una definizione di classe sui dispositivi Android S a causa del tag uses-library mancante nel file manifest.

Versione 1.1.0-beta04

24 gennaio 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04 vengono rilasciati. La versione 1.1.0-beta04 contiene questi commit.

Nuove funzionalità

  • Nuova API per supportare i report sugli eventi utente post-asta
  • È stato aggiunto il supporto per il filtro della quota limite per gli annunci di remarketing
  • Supporto della delega di Join Custom Audience
  • Supporto per il troncamento della catena di mediazione a cascata
  • Supporto per le aste protette sui server di offerte e aste

Modifiche all'API

  • Introduzione dell'API sperimentale AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) (I86cd2)
  • Introduzione dell'API sperimentale ReportEventRequest::inputEvent (Ib94f3)
  • Rendi facoltativo ReportImpressionRequest::adSelectionConfig (Ief280)
  • Introduzione delle API sperimentali AdSelectionManager::getAdSelectionData e AdSelectionManager::persistAdSelectionResultUnified (Ie4d0e)
  • Introduzione dell'API sperimentale CustomAudienceManager::fetchAndJoinCustomAudience (I09152)
  • Introduzione dell'API sperimentale AdSelectionManager::reportEvent (I0d7dc)
  • È stata introdotta l'API sperimentale AdSelectionManager::updateAdCounterHistogram e modificato AdData per indicare una serie di AdFilters (I87b83)

Correzioni di bug

  • Ora gli URI di input vengono abbinati a un sito/un'origine condiviso anziché richiedere una corrispondenza esatta del nome host.
  • Correggere l'errore del test dovuto allo schema HTTPS mancante (d573058)
  • Correggere lo schema HTTPS mancante dagli URL web (cecdcb8)
  • Aggiunta dell'annotazione di eccezione alle API di misurazione (2dba359)

Versione 1.1.0-beta03

15 novembre 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03 vengono rilasciati. La versione 1.1.0-beta03 contiene questi commit.

Nuove funzionalità

  • Supporto della compatibilità con le versioni precedenti per Android S.

Versione 1.1.0-beta02

4 ottobre 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02 vengono rilasciati. La versione 1.1.0-beta02 contiene questi commit.

Modifiche all'API

  • È stato rimosso il controllo della versione T+ dai classi di richiesta di misurazione. I client non devono eseguire un controllo della versione della piattaforma T+ per accedere alle classi di richiesta MeasurementManager privacysandbox. MeasurementManager sarà nullo con il nuovo comportamento. (Ieb105)

Versione 1.1.0-beta01

23 agosto 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 vengono rilasciati senza modifiche. La versione 1.1.0-beta01 contiene questi commit.

Versione 1.1.0-alpha01

9 agosto 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 e androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 vengono rilasciati. La versione 1.1.0-alpha01 contiene questi commit.

Modifiche all'API

  • Introduzione dell'elenco registerSource (Iae92f)
  • Sono stati rimossi gli utilizzi dell'API isAtLeastU() sperimentale (Ie9117, b/289269026)

Correzioni di bug

Versione 1.0

Versione 1.0.0-beta05

7 giugno 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05 vengono rilasciati. La versione 1.0.0-beta05 contiene questi commit.

Correzioni di bug

  • Aggiunge un controllo dell'estensione SDK 5 a TopicsManager
  • Aumenta la dipendenza dalle coroutine di Kotlin a 1.7.1 per evitare errori di compilazione di classi duplicate in Gradle

Versione 1.0.0-beta04

10 maggio 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04 vengono rilasciati. La versione 1.0.0-beta04 contiene questi commit.

Correzioni di bug

  • Risolvere il problema di deadlock quando le API di misurazione degli adservices vengono richiamate sul thread principale dall'autore della chiamata. (I65361)

Versione 1.0.0-beta03

19 aprile 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03 vengono rilasciati. La versione 1.0.0-beta03 contiene questi commit.

Nuove funzionalità

  • È stata attivata l'API Preview per Topics.

Versione 1.0.0-beta02

22 marzo 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02 vengono rilasciati. La versione 1.0.0-beta02 contiene questi commit.

Correzioni di bug

  • Sono state attivate le API MeasurementManager per la versione 5 e successive dell'estensione SDK.
  • Le API MeasurementManager sono state disattivate per la versione 4 e precedenti dell'estensione SDK.

Versione 1.0.0-beta01

22 febbraio 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 vengono rilasciati senza modifiche significative. La versione 1.0.0-beta01 è stata rilasciata da un ramo interno.

Modifiche al comportamento

  • I report sull'attribuzione sono stati disattivati e non sono disponibili per l'utilizzo in questa versione.

Versione 1.0.0-alpha01

11 gennaio 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 e androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01 vengono rilasciati. La versione 1.0.0-alpha01 è stata rilasciata da un ramo interno.

  • Si tratta di una nuova libreria Jetpack che consente l'integrazione con le API Privacy Preserving di Privacy Sandbox (Topics, FLEDGE e Attribution Reporting).
  • Le API Jetpack Privacy Sandbox possono essere utilizzate come sostitutive delle API Privacy Sandbox fornite nell'SDK per le estensioni 4.