Scopri le specifiche della funzionalità di selezione in tempo reale

Google invia una SegmentRequest in base alle richieste di annunci che corrispondono al tuo inventario target all'integrazione di Real-time Curation. L'oggetto SegmentRequest fornisce indicatori contestuali o indicatori sicuri che puoi utilizzare per identificare quali dei tuoi segmenti si applicano all'inventario specificato in SegmentResponse. La cura in tempo reale supporta gli oggetti SegmentRequest e SegmentResponse inviati in formato JSON.

Questa guida è un riferimento per il protocollo di cura in tempo reale che può aiutarti a creare la tua integrazione.

SegmentRequest

Attributo	Tipo	Descrizione
site	Sito	Supportato solo per i partner di cura contestuale. Un descrittore del sito web. Il campo site viene compilato se i contenuti supportati da pubblicità sono un sito web anziché un'applicazione non browser.
app	App	Supportato solo per i partner di cura contestuale. Un descrittore dell'app. Il campo app viene compilato se i contenuti supportati da annunci sono un'applicazione non browser anziché un sito web.
pub	Publisher	Supportato solo per i partner di cura contestuale. Un descrittore dell'editore.
user	Utente	Un descrittore dell'utente che naviga nei contenuti del publisher che ha avviato la richiesta di segmento.
device	Dispositivo	Supportato solo per i partner di cura contestuale. Un descrittore del dispositivo dell'utente.
segment_request_id	stringa	Un identificatore univoco utilizzato per identificare la richiesta di segmento indipendentemente da tutte le altre richieste di segmento.

Sito

Attributo	Tipo	Descrizione
page	stringa	Supportato solo per i partner di cura contestuale. L'URL della pagina che mostra l'impressione.

App

Attributo	Tipo	Descrizione
bundle	stringa	Supportato solo per i partner di cura contestuale. Un identificatore dell'applicazione specifico per la piattaforma, destinato a essere univoco per l'app. Su Android, il campo bundle è un nome di pacchetto o bundle. Su iOS, è un ID numerico.

Publisher

Attributo	Tipo	Descrizione
id	stringa	Supportato solo per i partner di cura contestuale. Un ID publisher definito dal suffisso del codice publisher del codice proprietà web. Ad esempio, un publisher con un codice proprietà web ca-pub-123 avrà il proprio ID impostato su pub-123.

Utente

Attributo	Tipo	Descrizione
consent	stringa	Una stringa di consenso della versione 2 del Transparency and Consent Framework (TCF) di IAB codificata in base64 sicura per il web recuperata dalla piattaforma di gestione del consenso (CMP) di IAB dell'editore. Il campo consent viene compilato se il publisher ha eseguito l'integrazione con una CMP per il TCF v2 e se la CMP indica che il GDPR si applica alla richiesta di annuncio e fornisce una stringa di consenso valida. Per informazioni dettagliate sui fornitori elencati nella stringa del consenso, consulta l'elenco dei fornitori globali di IAB all'indirizzo vendor-list.consensu.org/v2/vendor-list.json.
eids	EID array	Supportato solo per i partner di selezione degli indicatori sicuri. Istanze ID estese. In Curation, il campo eids contiene i dati resi disponibili dal publisher, ad esempio gli indicatori sicuri.

EID

Attributo	Tipo	Descrizione
source	stringa	Supportato solo per i partner di selezione degli indicatori sicuri. Fornitore di origine o tecnologia responsabile del set di dati incluso. Espresso come dominio di primo livello.
uids	UID array	Supportato solo per i partner di selezione degli indicatori sicuri. Array di oggetti UID dell'origine specificata.

UID

Attributo	Tipo	Descrizione
id	stringa	Supportato solo per i partner di selezione degli indicatori sicuri. L'identificatore. Nella cura, il campo id è un indicatore sicuro. Per scoprire di più sugli indicatori sicuri, consulta l'articolo Condividi indicatori sicuri con gli offerenti e i partner di selezione di Ad Manager.

Dispositivo

Attributo	Tipo	Descrizione
geo	Dati geografici	Supportato solo per i partner di cura contestuale. La posizione del dispositivo dell'utente.

Dati geografici

Attributo	Tipo	Descrizione
country	stringa	Supportato solo per i partner di cura contestuale. Paese che utilizza lo standard ISO-3166-1 Alpha-3.
region	stringa	Supportato solo per i partner di cura contestuale. Codice regione che utilizza lo standard ISO-3166-2; codice stato di due lettere se si tratta degli Stati Uniti.
metro	stringa	Supportato solo per i partner di cura contestuale. Codice metro di Google trovato nel file geo-table.csv.

SegmentResponse

Attributo	Tipo	Descrizione
segment	Segment array	Un descrittore per un segmento.

Segmento

Attributo	Tipo	Descrizione
segment_id	stringa	L'ID del segmento. L'ID deve corrispondere a curatorDataSegmentId trovato nel nome del segmento nella risorsa curators.dataSegments dell'API Marketplace.