Questa pagina è stata tradotta dall'API Cloud Translation.

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