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<ObjectException> 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<ObjectException> receiver)

Aggiunge l'utente al CustomAudience specificato.

void leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<ObjectException> 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

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

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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

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

public TestCustomAudienceManager getTestCustomAudienceManager ()

Crea un servizio con API che abilitano i test

Ritorni
TestCustomAudienceManager Questo valore non può essere null.

UniscitiaaPubblicoPersonalizzato

public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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

public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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.