Gestione 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 unirsi o uscire dai 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 sviluppo per la creazione di un'istanza di CustomAudienceManager.

TestCustomAudienceManager getTestCustomAudienceManager()

Crea un servizio con API per l'attivazione dei test

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

Aggiunge l'utente all'elemento CustomAudience specificato.

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

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

Metodi ereditati

Metodi pubblici

fetchAndjoinCustomAudience

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

Aggiunge l'utente a CustomAudience recuperato da un fetchUri.

Un tentativo di registrazione dell'utente per un segmento di pubblico personalizzato con la stessa combinazione di ownerPackageName, buyer e name comporterà la sovrascrittura delle informazioni del segmento di pubblico personalizzato esistente, incluso l'elenco dei dati pubblicitari.

Tieni presente che l'elenco degli annunci può essere completamente sovrascritto dal job di recupero dello sfondo giornaliero.

Questa chiamata non va a buon fine con un SecurityException se

  1. ownerPackageName non chiama 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 che effettua la chiamata e/o
  2. Eventuali parametri URI in CustomAudience specificati non sono autenticati con l'acquirente CustomAudience.

Questa chiamata non va a buon fine con LimitExceededException se il pacchetto per le chiamate supera i limiti di frequenza consentiti ed è limitato.

Se si verifica un errore del servizio interno, questa chiamata non riesce con un codice IllegalStateException.
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 di listener vengono inviati tramite questo Executor, offrendo un modo semplice per controllare quale thread viene utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un Executor che verrà inviato al thread appropriato.
receiver OutcomeReceiver: questo valore non può essere null.

ricevi

public static CustomAudienceManager get (Context context)

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

Parametri
context Context: il valore di Context da utilizzare 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 per l'attivazione dei test

Ritorni
TestCustomAudienceManager Questo valore non può essere null.

joinPersonalizzatoPubblico

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

Aggiunge l'utente all'elemento CustomAudience specificato.

Un tentativo di registrazione dell'utente per un segmento di pubblico personalizzato con la stessa combinazione di ownerPackageName, buyer e name comporterà la sovrascrittura delle informazioni del segmento di pubblico personalizzato esistente, incluso l'elenco dei dati pubblicitari.

Tieni presente che l'elenco degli annunci può essere completamente sovrascritto dal job di recupero dello sfondo giornaliero.

Questa chiamata non va a buon fine con un SecurityException se

  1. ownerPackageName non chiama 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 che effettua la chiamata e/o
  2. Eventuali parametri URI in CustomAudience specificati non sono autenticati con l'acquirente CustomAudience.

Questa chiamata non va a buon fine con LimitExceededException se il pacchetto per le chiamate supera i limiti di frequenza consentiti ed è limitato.

Se si verifica un errore del servizio interno, questa chiamata non riesce con un codice IllegalStateException.
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 di listener vengono inviati tramite questo Executor, offrendo un modo semplice per controllare quale thread viene utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un Executor che verrà inviato al thread appropriato.
receiver OutcomeReceiver: questo valore non può essere null.

esci dal segmento di pubblicoPersonalizzato

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

Tentativi di rimuovere un utente da un segmento di pubblico personalizzato eliminando i dati di 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 per le chiamate supera i limiti di frequenza consentiti ed è limitato.

Questa chiamata non informa il chiamante se il segmento di pubblico personalizzato specificato esisteva nello spazio di archiviazione sul dispositivo. In altre parole, quando un acquirente tenta di abbandonare un segmento di pubblico personalizzato di cui non è stato associato, l'evento non funziona automaticamente.
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 di listener vengono inviati tramite questo Executor, offrendo un modo semplice per controllare quale thread viene utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un Executor che verrà inviato al thread appropriato.
receiver OutcomeReceiver: questo valore non può essere null.