Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiunto al livello API 34
Anche in Estensioni di servizi pubblicitari 4

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

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. Questa classe è una raccolta di alcuni dati memorizzati su un dispositivo necessari per pubblicare annunci indirizzati a 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 appiattita dell'oggetto Parcelable include un descrittore di file.
`int`	`PARCELABLE_WRITE_RETURN_VALUE` Flag per l'utilizzo con `writeToParcel(Parcel, int)`: l'oggetto scritto è un valore restituito, ovvero il risultato di una funzione come "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`" o "`void someFunction(inout Parcelable)`".

Campi
`public static final Creator<CustomAudience>`	`CREATOR`

Metodi pubblici
`boolean`	`equals(Object o)` Verifica se due oggetti `CustomAudience` contengono le stesse informazioni.
`Instant`	`getActivationTime()` Al momento della creazione dell'oggetto `CustomAudience`, è possibile impostare in futuro un tempo di attivazione facoltativo per gestire un'attivazione ritardata.
`List<AdData>`	`getAds()` Questo elenco di oggetti `AdData` fornisce un elenco completo e 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 al processo di selezione degli annunci.
`AdTechIdentifier`	`getBuyer()` Un acquirente viene identificato da un dominio nel formato "acquirenteexample.com".
`Uri`	`getDailyUpdateUri()` Questo URI punta a un server gestito dall'acquirente che ospita i dati delle offerte aggiornati e i metadati degli annunci da utilizzare nel processo di selezione degli annunci on-device.
`Instant`	`getExpirationTime()` Una volta trascorsa la scadenza, un segmento di pubblico personalizzato non è più idoneo per gli aggiornamenti giornalieri dei dati relativi agli annunci/delle offerte né per la 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 relativi alle offerte attendibili sono costituiti da un URI che rimanda a un server attendibile per i dati relativi alle offerte degli acquirenti e da un elenco di chiavi con cui eseguire query al server.
`AdSelectionSignals`	`getUserBiddingSignals()` Gli indicatori di offerta dell'utente vengono eventualmente forniti dagli acquirenti per essere utilizzati dal codice JavaScript fornito dall'acquirente 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 in un particolato.

Metodi ereditati

Dal corso


        
          java.lang.Object

`Object`	`clone()` Crea e restituisce una copia dell'oggetto.
`boolean`	`equals(Object obj)` Indica se qualche altro oggetto è "uguale a" questo.
`void`	`finalize()` Richiamato dal garbage collector su un oggetto quando la garbage collection determina che non ci sono altri riferimenti all'oggetto.
`final Class<?>`	`getClass()` Restituisce la classe di runtime di `Object`.
`int`	`hashCode()` Restituisce un valore di codice hash per l'oggetto.
`final void`	`notify()` Riattiva un singolo thread in attesa sul monitor di questo oggetto.
`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 sì che il thread corrente attenda finché non viene riattivato, in genere tramite notifica o interruzione, o fino a quando non è trascorso un determinato periodo di tempo reale.
`final void`	`wait(long timeoutMillis)` Fa sì che il thread corrente attenda finché non viene riattivato, in genere tramite notifica o interruzione, o fino a quando non è trascorso un determinato periodo di tempo reale.
`final void`	`wait()` Fa sì che il thread corrente attenda fino a quando non viene riattivato, in genere tramite una notifica o un'interruzione.

Dall'interfaccia


        
          android.os.Parcelable

`abstract int`	`describeContents()` Descrivi i tipi di oggetti speciali contenuti nella rappresentazione sottoposta a marshall di questa istanza Parcelable.
`abstract void`	`writeToParcel(Parcel dest, int flags)` Appiattisci questo oggetto in un particolato.

Campi

CREATOR

Aggiunto al livello API 34
Anche in Estensioni di servizi pubblicitari 4

public static final Creator<CustomAudience> CREATOR

Metodi pubblici

uguale a

Aggiunto al livello API 34

public boolean equals (Object o)

Verifica se due oggetti CustomAudience contengono le stesse informazioni.

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

Ritorni
`boolean`	`true` se questo oggetto è uguale all'argomento obj; in caso contrario `false`.

getActivationTime

Aggiunto al livello API 34
Anche in Estensioni di servizi pubblicitari 4

public Instant getActivationTime ()

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

Ad esempio, un segmento di pubblico personalizzato per gli utenti non più attivi potrebbe non essere attivato finché non viene raggiunta una soglia di inattività. A quel punto, gli annunci del segmento di pubblico personalizzato parteciperanno al processo di selezione degli annunci, reindirizzando potenzialmente gli utenti non più attivi all'applicazione del proprietario originale.

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

Se specificata, la data/ora di attivazione deve essere un istante precedente alla scadenza.

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

getAds

Aggiunto al livello API 34
Anche in Estensioni di servizi pubblicitari 4

public List<AdData> getAds ()

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

Se non specificato o se viene fornito un elenco vuoto, CustomAudience non parteciperà 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 oggetti `AdData` che rappresentano gli annunci attualmente pubblicati dal segmento di pubblico personalizzato Questo valore non può essere `null`.

getBiddingLogicUri

Aggiunto al livello API 34
Anche in Estensioni di 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 al processo di selezione degli annunci. L'URI deve utilizzare HTTPS.

Ritorni
`Uri`	l'URI per il recupero della logica di offerta dell'acquirente Questo valore non può essere `null`.

Ottieni acquirente

Aggiunto al livello API 34
Anche in Estensioni di servizi pubblicitari 4

public AdTechIdentifier getBuyer ()

Un acquirente viene identificato da un dominio nel formato "acquirenteexample.com".

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

getDailyUpdateUri

Aggiunto al livello API 34
Anche in Estensioni di servizi pubblicitari 4

public Uri getDailyUpdateUri ()

Questo URI punta a un server gestito dall'acquirente che ospita i dati delle offerte aggiornati e i metadati degli annunci da utilizzare nel processo di selezione degli annunci on-device. L'URI deve utilizzare HTTPS.

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

getExpirationTime

Aggiunto al livello API 34
Anche in Estensioni di servizi pubblicitari 4

public Instant getExpirationTime ()

Una volta trascorsa la scadenza, un segmento di pubblico personalizzato non è più idoneo per gli aggiornamenti giornalieri dei dati relativi agli annunci/delle offerte né per la partecipazione al processo di selezione degli annunci. Il segmento di pubblico personalizzato verrà eliminato dalla memoria dopo l'aggiornamento giornaliero successivo.

Se al momento della creazione di CustomAudience non viene specificata alcuna scadenza, per impostazione predefinita la scadenza sarà di 60 giorni dall'attivazione.

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

Ritorni
`Instant`	il timestamp `Instant`, troncato a millisecondi, dopo il quale il segmento di pubblico personalizzato deve essere rimosso. Questo valore potrebbe essere `null`.

getName

Aggiunto al livello API 34
Anche in Estensioni di 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`	Nome stringa del segmento di pubblico personalizzato Questo valore non può essere `null`.

getTrustedBiddingData

Aggiunto al livello API 34
Anche in Estensioni di servizi pubblicitari 4

public TrustedBiddingData getTrustedBiddingData ()

I dati relativi alle offerte attendibili sono costituiti da un URI che rimanda a un server attendibile per i dati relativi alle offerte degli acquirenti e da un elenco di chiavi con cui eseguire query al server. Tieni presente che le chiavi sono identificatori arbitrari che verranno utilizzati solo per eseguire query sul server attendibile per conoscere la logica di offerta di un acquirente durante la selezione degli annunci.

Se non specificato, CustomAudience non parteciperà alla selezione degli annunci finché non verranno forniti dati delle offerte attendibili tramite l'aggiornamento giornaliero per il segmento di pubblico personalizzato.

Ritorni
`TrustedBiddingData`	un oggetto `TrustedBiddingData` contenente i dati delle offerte attendibili del segmento di pubblico personalizzato Questo valore può essere `null`.

getUserBiddingSignals

Aggiunto al livello API 34
Anche in Estensioni di servizi pubblicitari 4

public AdSelectionSignals getUserBiddingSignals ()

Gli indicatori di offerta dell'utente vengono eventualmente forniti dagli acquirenti per essere utilizzati dal codice JavaScript fornito dall'acquirente 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 codice JS 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 finché non verranno forniti indicatori di offerta dell'utente tramite l'aggiornamento giornaliero del segmento di pubblico personalizzato.

Ritorni
`AdSelectionSignals`	un oggetto `AdSelectionSignals` che rappresenta gli indicatori di offerta dell'utente per il 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.

writeToParcel

Aggiunto al livello API 34

public void writeToParcel (Parcel dest, 
                int flags)

Appiattisci questo oggetto in un particolato.

Parametri
`dest`	`Parcel`: questo valore non può essere `null`.
`flags`	`int`: flag aggiuntivi su come scrivere 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