Aggiunta nel livello API 34
Anche in Estensioni dei servizi pubblicitari 4

Riepilogo: Metodi | Metodi ereditati

Gestore segmenti di pubblico personalizzati

public class CustomAudienceManager
extends Object

java.lang.Object
🎞	android.adservices.customaudience.CustomAudienceManager

---

CustomAudienceManager fornisce API per SDK per app e annunci che consentono di unire o uscire da segmenti di pubblico personalizzati.

Riepilogo

Metodi pubblici
void	fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) Aggiunge l'utente a CustomAudience recuperato da un fetchUri.
static CustomAudienceManager	get(Context context) Metodo di fabbrica per la creazione di un'istanza di CustomAudienceManager.
TestCustomAudienceManager	getTestCustomAudienceManager() Crea un servizio con API che abilitano i test
void	joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) Aggiunge l'utente al CustomAudience specificato.
void	leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) Tenta di rimuovere un utente da un segmento di pubblico personalizzato eliminando i dati CustomAudience esistenti, identificati da ownerPackageName, buyer e name.

Metodi ereditati

Dal corso java.lang.Object Object clone() Crea e restituisce una copia di questo oggetto. boolean equals(Object obj) Indica se un altro oggetto è "uguale a" questo. void finalize() Viene chiamato dal garbage collector su un oggetto quando viene utilizzata la garbage collection determina che non ci sono altri riferimenti all'oggetto. final Class<?> getClass() Restituisce la classe di runtime di questo Object. int hashCode() Restituisce un valore del codice hash per l'oggetto. final void notify() Riattiva un singolo thread in attesa sull'oggetto di questo monitoraggio. final void notifyAll() Riattiva tutti i thread in attesa sul monitor di questo oggetto. String toString() Restituisce una rappresentazione stringa dell'oggetto. final void wait(long timeoutMillis, int nanos) Fa in modo che il thread attuale attenda fino a quando non viene riattivato, in genere tramite notifica o interruzioni, oppure fino a quando sia trascorso una certa quantità di tempo reale. final void wait(long timeoutMillis) Fa in modo che il thread attuale attenda fino a quando non viene riattivato, in genere tramite notifica o interruzioni, oppure fino a quando sia trascorso una certa quantità di tempo reale. final void wait() Fa in modo che il thread attuale attenda fino a quando non viene riattivato, in genere tramite una notifica o l'interruzione.

Metodi pubblici

fetchAndJoinCustomAudience

Aggiunto in UpsidedownCakePrivacySandbox di Android

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Aggiunge l'utente a CustomAudience recuperato da un fetchUri.

Un tentativo di registrare l'utente per un segmento di pubblico personalizzato con la stessa combinazione di ownerPackageName, buyer e name comporterà la visualizzazione informazioni da sovrascrivere, incluso l'elenco dei dati pubblicitari.

Tieni presente che l'elenco di annunci può essere completamente sovrascritto dal processo di recupero giornaliero in background.

Questa chiamata non va a buon fine con un SecurityException se

1. ownerPackageName non sta chiamando il nome del pacchetto dell'app e/o
2. l'acquirente non è autorizzato a utilizzare l'API.

Questa chiamata non va a buon fine con un IllegalArgumentException se

1. il limite di spazio di archiviazione è stato superato dall'applicazione chiamante e/o
2. tutti i parametri URI nell'elemento CustomAudience specificato non sono autenticati con CustomAudience acquirente.

Questa chiamata non va a buon fine con LimitExceededException se il pacchetto chiamante supera le consentiti, ed è limitato.

Questa chiamata non riesce e restituisce un errore IllegalStateException se si verifica un errore interno del servizio riscontrati.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parametri
fetchAndJoinCustomAudienceRequest	FetchAndJoinCustomAudienceRequest: questo valore non può essere null.
executor	Executor: questo valore non può essere null. Gli eventi di callback e listener vengono inviati tramite questo Executor, che consente di controllare facilmente quale thread in uso. Per inviare eventi tramite il thread principale del tuo puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un valore Executor che effettui l'invio a un thread appropriato.
receiver	OutcomeReceiver: questo valore non può essere null.

ricevi

Aggiunta in Livello API 34
Anche in Estensioni di Ad Services 6

public static CustomAudienceManager get (Context context)

Metodo di fabbrica per la creazione di un'istanza di CustomAudienceManager.

Parametri
context	Context: Context da usare Questo valore non può essere null.

Ritorni
CustomAudienceManager	Un'istanza CustomAudienceManager Questo valore non può essere null.

getTestCustomAudienceManager

Aggiunta nel livello API 34
Anche in Estensioni dei servizi pubblicitari 4

public TestCustomAudienceManager getTestCustomAudienceManager ()

Crea un servizio con API che abilitano i test

Ritorni
TestCustomAudienceManager	Questo valore non può essere null.

UniscitiaaPubblicoPersonalizzato

Aggiunta nel livello API 34
Anche in Estensioni dei servizi pubblicitari 4

public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Aggiunge l'utente al CustomAudience specificato.

Un tentativo di registrare l'utente per un segmento di pubblico personalizzato con la stessa combinazione di ownerPackageName, buyer e name comporterà la visualizzazione informazioni da sovrascrivere, incluso l'elenco dei dati pubblicitari.

Tieni presente che l'elenco di annunci può essere completamente sovrascritto dal processo di recupero giornaliero in background.

Questa chiamata non va a buon fine con un SecurityException se

1. ownerPackageName non sta chiamando il nome del pacchetto dell'app e/o
2. l'acquirente non è autorizzato a utilizzare l'API.

Questa chiamata non va a buon fine con un IllegalArgumentException se

1. il limite di spazio di archiviazione è stato superato dall'applicazione chiamante e/o
2. tutti i parametri URI nell'elemento CustomAudience specificato non sono autenticati con CustomAudience acquirente.

Questa chiamata non va a buon fine con LimitExceededException se il pacchetto chiamante supera le consentiti, ed è limitato.

Questa chiamata non riesce e restituisce un errore IllegalStateException se si verifica un errore interno del servizio riscontrati.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parametri
joinCustomAudienceRequest	JoinCustomAudienceRequest: questo valore non può essere null.
executor	Executor: questo valore non può essere null. Gli eventi di callback e listener vengono inviati tramite questo Executor, che consente di controllare facilmente quale thread in uso. Per inviare eventi tramite il thread principale del tuo puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un valore Executor che effettui l'invio a un thread appropriato.
receiver	OutcomeReceiver: questo valore non può essere null.

abbandonaPubblicoPersonalizzato

Aggiunta nel livello API 34
Anche in Estensioni dei servizi pubblicitari 4

public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Tenta di rimuovere un utente da un segmento di pubblico personalizzato eliminando i dati CustomAudience esistenti, identificati da ownerPackageName, buyer e name.

Questa chiamata non va a buon fine con un SecurityException se

1. ownerPackageName non sta chiamando il nome del pacchetto dell'app; e/o
2. l'acquirente non è autorizzato a utilizzare l'API.

Questa chiamata non va a buon fine con LimitExceededException se il pacchetto chiamante supera le consentiti, ed è limitato.

Questa chiamata non informa il chiamante se esisteva il segmento di pubblico personalizzato specificato on-device. In altre parole, quando un acquirente tenta di lasciare una segmento di pubblico personalizzato che non è stato unito.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parametri
leaveCustomAudienceRequest	LeaveCustomAudienceRequest: questo valore non può essere null.
executor	Executor: questo valore non può essere null. Gli eventi di callback e listener vengono inviati tramite questo Executor, che consente di controllare facilmente quale thread in uso. Per inviare eventi tramite il thread principale del tuo puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un valore Executor che effettui l'invio a un thread appropriato.
receiver	OutcomeReceiver: questo valore non può essere null.