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

Riepilogo: Classi nidificate | Costanti ereditate | Campi | Metodi | Metodi ereditati

Segmento di pubblico personalizzato

public final class CustomAudience
extends Object implements Parcelable

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

---

Rappresenta le informazioni necessarie a un segmento di pubblico personalizzato per partecipare alla selezione degli annunci.

Un segmento di pubblico personalizzato è un raggruppamento astratto di utenti con interessi dimostrati simili. Questo è una raccolta di alcuni dati archiviati su un dispositivo che sono necessari per la pubblicazione di annunci pubblicitari scegliere come target un singolo segmento di pubblico personalizzato.

Riepilogo

Classi nidificate
class	CustomAudience.Builder Builder per CustomAudience oggetti.

Costanti ereditate

Dall'interfaccia android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR Bit descrittore utilizzato con describeContents(): indica che la rappresentazione bidimensionale dell'oggetto Parcelable include un descrittore del file. int PARCELABLE_WRITE_RETURN_VALUE Flag da utilizzare con writeToParcel(Parcel, int): l'oggetto che viene scritto è un valore restituito, ovvero il risultato di una funzione come "Parcelable someFunction()", "void someFunction(out Parcelable)" oppure "void someFunction(inout Parcelable)".

Campi
public static final Creator<CustomAudience>	CREATOR

Metodi pubblici
boolean	equals(Object o) Controlla se due oggetti CustomAudience contengono le stesse informazioni.
Instant	getActivationTime() Al momento della creazione dell'oggetto CustomAudience, è possibile impostare un tempo di attivazione facoltativo in in futuro, per consentire un'attivazione ritardata.
List<AdData>	getAds() Questo elenco di AdData oggetti è un elenco completo degli annunci che verranno pubblicati da questo CustomAudience durante il processo di selezione degli annunci.
Uri	getBiddingLogicUri() Restituisce l'URI di destinazione utilizzato per recuperare la logica di offerta quando un segmento di pubblico personalizzato partecipa alla processo di selezione degli annunci.
AdTechIdentifier	getBuyer() Un acquirente è identificato da un dominio nel formato "buyerexample.com".
Uri	getDailyUpdateUri() Questo URI rimanda a un server gestito dall'acquirente che ospita i dati aggiornati delle offerte e i metadati degli annunci nel processo di selezione degli annunci sul dispositivo.
Instant	getExpirationTime() Una volta trascorsa la scadenza, un segmento di pubblico personalizzato non sarà più idoneo per la visualizzazione giornaliera aggiornamenti dei dati relativi alle offerte/annunci o alla partecipazione al processo di selezione degli annunci.
String	getName() Il nome del segmento di pubblico personalizzato è una stringa arbitraria fornita dal proprietario e dall'acquirente al momento della creazione dell'oggetto CustomAudience.
TrustedBiddingData	getTrustedBiddingData() I dati di Trusted Bidding sono costituiti da un URI che rimanda a un server affidabile per i dati sulle offerte e un elenco di chiavi con cui eseguire query sul server.
AdSelectionSignals	getUserBiddingSignals() Gli indicatori di offerta per l'utente vengono facoltativamente forniti dagli acquirenti per essere utilizzati da quest'ultimo JavaScript durante la selezione degli annunci in un ambiente di esecuzione isolato.
int	hashCode() Restituisce l'hash dei dati dell'oggetto CustomAudience.
void	writeToParcel(Parcel dest, int flags) Appiattisci questo oggetto a un Parcel.

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.
Dall'interfaccia android.os.Parcelable abstract int describeContents() Descrivi i tipi di oggetti speciali contenuti in questo Parcelable la rappresentazione sottoposta a marshall dell'istanza. abstract void writeToParcel(Parcel dest, int flags) Appiattisci questo oggetto a un Parcel.

Campi

CREATOR

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

public static final Creator<CustomAudience> CREATOR

Metodi pubblici

uguale

Aggiunto al livello API 34

public boolean equals (Object o)

Controlla se due oggetti CustomAudience contengono le stesse informazioni.

Parametri
o	Object: l'oggetto di riferimento con cui eseguire il confronto.

Ritorni
boolean	true se questo oggetto è uguale all'oggetto argomento; false negli altri casi.

getActivationTime

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

public Instant getActivationTime ()

Al momento della creazione dell'oggetto CustomAudience, è possibile impostare un tempo di attivazione facoltativo in in futuro, per consentire un'attivazione ritardata. Se il campo non viene configurato, CustomAudience verrà attivato al momento dell'unione.

Ad esempio, un segmento di pubblico personalizzato per gli utenti non più attivi potrebbe non attivarsi fino a quando non viene raggiunta una soglia di di inattività, a quel punto gli annunci del segmento di pubblico personalizzato saranno inclusi nell'annuncio processo di selezione, reindirizzando potenzialmente gli utenti non più attivi all'applicazione del proprietario originale.

Il ritardo massimo nell'attivazione è di 60 giorni dalla creazione iniziale.

Se specificato, l'ora di attivazione deve essere antecedente a quella di scadenza.

Ritorni
Instant	il timestamp Instant, troncato a millisecondi, dopodiché il timestamp personalizzato il segmento di pubblico è attivo Questo valore può essere null.

getAds

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

public List<AdData> getAds ()

Questo elenco di AdData oggetti è un elenco completo degli annunci che verranno pubblicati da questo CustomAudience durante il processo di selezione degli annunci.

Se non viene specificato o se viene fornito un elenco vuoto, CustomAudience non parteciperai alla selezione degli annunci finché non verrà fornito un elenco valido di annunci tramite l'aggiornamento giornaliero per il segmento di pubblico personalizzato.

Ritorni
List<AdData>	List di AdData oggetti che rappresentano gli annunci attualmente pubblicati dalla segmento di pubblico personalizzato Questo valore non può essere null.

getBiddingLogicUri

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

public Uri getBiddingLogicUri ()

Restituisce l'URI di destinazione utilizzato per recuperare la logica di offerta quando un segmento di pubblico personalizzato partecipa alla processo di selezione degli annunci. L'URI deve utilizzare HTTPS.

Ritorni
Uri	l'URI per recuperare la logica di offerta dell'acquirente Questo valore non può essere null.

getAcquirente

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

public AdTechIdentifier getBuyer ()

Un acquirente è identificato da un dominio nel formato "buyerexample.com".

Ritorni
AdTechIdentifier	una AdTechIdentifier contenente il dominio dell'acquirente del segmento di pubblico personalizzato Questo valore non può essere null.

getDailyUpdateUri

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

public Uri getDailyUpdateUri ()

Questo URI rimanda a un server gestito dall'acquirente che ospita i dati aggiornati delle offerte e i metadati degli annunci nel processo di selezione degli annunci sul dispositivo. L'URI deve utilizzare HTTPS.

Ritorni
Uri	l'URI di aggiornamento giornaliero del segmento di pubblico personalizzato Questo valore non può essere null.

getExpirationTime

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

public Instant getExpirationTime ()

Una volta trascorsa la scadenza, un segmento di pubblico personalizzato non sarà più idoneo per la visualizzazione giornaliera aggiornamenti dei dati relativi alle offerte/annunci o alla partecipazione al processo di selezione degli annunci. Il segmento di pubblico personalizzato verranno quindi eliminate dalla memoria entro il successivo aggiornamento giornaliero.

Se non viene fornita una data di scadenza al momento della creazione dell'CustomAudience, la scadenza verrà per impostazione predefinita, a 60 giorni dall'attivazione.

La scadenza massima è di 60 giorni dall'attivazione iniziale.

Ritorni
Instant	il timestamp Instant, troncato a millisecondi, dopodiché il timestamp personalizzato segmento di pubblico deve essere rimosso Questo valore può essere null.

getName

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

public String getName ()

Il nome del segmento di pubblico personalizzato è una stringa arbitraria fornita dal proprietario e dall'acquirente al momento della creazione dell'oggetto CustomAudience.

Ritorni
String	Il nome della stringa del segmento di pubblico personalizzato Questo valore non può essere null.

getTrustedBiddingData

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

public TrustedBiddingData getTrustedBiddingData ()

I dati di Trusted Bidding sono costituiti da un URI che rimanda a un server affidabile per i dati sulle offerte e un elenco di chiavi con cui eseguire query sul server. Tieni presente che le chiavi sono identificatori arbitrari. che verrà utilizzato solo per richiedere al server attendibile la logica di offerta di un acquirente durante selezione.

Se non specificato, CustomAudience non parteciperà alla selezione degli annunci fino a quando I dati relativi alle offerte attendibili vengono forniti tramite l'aggiornamento giornaliero per il segmento di pubblico personalizzato.

Ritorni
TrustedBiddingData	un oggetto TrustedBiddingData contenente l'offerta attendibile del segmento di pubblico personalizzato dati Questo valore può essere null.

Indicatori getUserBidding

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

public AdSelectionSignals getUserBiddingSignals ()

Gli indicatori di offerta per l'utente vengono facoltativamente forniti dagli acquirenti per essere utilizzati da quest'ultimo JavaScript durante la selezione degli annunci in un ambiente di esecuzione isolato.

Se gli indicatori di offerta dell'utente non sono un oggetto JSON valido che può essere utilizzato dal JavaScript dell'acquirente, il segmento di pubblico personalizzato non sarà idoneo per la selezione degli annunci.

Se non specificato, CustomAudience non parteciperà alla selezione degli annunci fino a quando gli indicatori di offerta per gli utenti vengono forniti tramite l'aggiornamento giornaliero per il segmento di pubblico personalizzato.

Ritorni
AdSelectionSignals	un oggetto AdSelectionSignals che rappresenta gli indicatori di offerta dell'utente per segmento di pubblico personalizzato Questo valore può essere null.

codice hash

Aggiunto al livello API 34

public int hashCode ()

Restituisce l'hash dei dati dell'oggetto CustomAudience.

Ritorni
int	un valore di codice hash per l'oggetto.

ScriviToParcel

Aggiunto al livello API 34

public void writeToParcel (Parcel dest, 
                int flags)

Appiattisci questo oggetto a un Parcel.

Parametri
dest	Parcel: questo valore non può essere null.
flags	int: flag aggiuntivi su come deve essere scritto l'oggetto. Può essere 0 o Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Il valore è 0 o una combinazione di Parcelable.PARCELABLE_WRITE_RETURN_VALUE e android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES