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

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

Questa chiamata non va a buon fine con un IllegalArgumentException se

il limite di spazio di archiviazione è stato superato dall'applicazione chiamante e/o
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.

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

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

Questa chiamata non va a buon fine con un IllegalArgumentException se

il limite di spazio di archiviazione è stato superato dall'applicazione chiamante e/o
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.

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

ownerPackageName non sta chiamando il nome del pacchetto dell'app; e/o
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`.