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 dei segmenti di pubblico 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 l'integrazione.

SegmentRequest

Attributo Tipo Descrizione
imp Array Imp Supportato solo per i partner di cura contestuale. Rappresenta le opportunità di impressioni offerte.
site Sito Supportato solo per i partner di cura contestuale. Un descrittore del sito web. Il campo site viene compilato se i contenuti con pubblicità sono un sito web anziché un'applicazione non browser.
app App Supportato solo per i partner di cura contestuale. Una descrizione 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 sfoglia i 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.

Imp

Attributo Tipo Descrizione
id stringa Supportato solo per i partner di cura contestuale. Un identificatore univoco per questa impressione nel contesto della richiesta di segmento. Il valore inizia da 1 e aumenta fino a n per n impressioni.
banner Banner Supportato solo per i partner di cura contestuale. Questo campo viene compilato se l'impressione viene offerta come opportunità di annuncio banner.
video Video Supportato solo per i partner di cura contestuale. Questo campo viene compilato se l'impressione viene offerta come opportunità di annuncio video.
ext ImpExt Questo campo viene compilato con le estensioni per l'oggetto Imp.

Banner

Attributo Tipo Descrizione
w int Supportato solo per i partner di cura contestuale. Larghezza in pixel indipendenti dal dispositivo (DIP).
h int Supportato solo per i partner di cura contestuale. Altezza in pixel indipendenti dal dispositivo (DIP).
pos int Supportato solo per i partner di cura contestuale. Posizione dell'annuncio sullo schermo. Per saperne di più sulle possibili posizioni di posizionamento, consulta Elenco: posizioni di posizionamento in AdCOM 1.0.

Video

Attributo Tipo Descrizione
w int Supportato solo per i partner di cura contestuale. La larghezza del video player in pixel indipendenti dal dispositivo (DIP).
h int Supportato solo per i partner di cura contestuale. Altezza del video player in pixel indipendenti dal dispositivo (DIP).
pos int Supportato solo per i partner di cura contestuale. Posizione dell'annuncio sullo schermo. Per saperne di più sulle possibili posizioni di posizionamento, consulta Elenco: posizioni di posizionamento in AdCOM 1.0.

ImpExt

Attributo Tipo Descrizione
gpid stringa Supportato solo per i partner di cura contestuale. Descrive l'ID posizionamento globale. Un ID univoco e persistente, specificato dal publisher, coerente in tutti i percorsi di offerta per ogni unità pubblicitaria di una pagina. Consulta questo articolo.

Sito

Attributo Tipo Descrizione
page stringa Supportato solo per i partner di cura contestuale. L'URL della pagina che mostra l'impressione.
mobile int Supportato solo per i partner di cura contestuale. Indica se il sito è stato programmato per ottimizzare il layout quando viene visualizzato su dispositivi mobili, dove 0 = no e 1 = sì.

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 suo ID impostato su pub-123.

Utente

Attributo Tipo Descrizione
id stringa ID utente Google.
buyeruid stringa Dati di corrispondenza ospitati caricati con il servizio di corrispondenza dei cookie. Per impostazione predefinita, questo valore è specificato nella codifica Base64 sicura per il web senza padding. Se vuoi, puoi configurare questo campo in modo che venga compilato senza codifica contattando il tuo account manager.
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 del publisher. 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 Array EID Supportato solo per i partner di cura dei segmenti di pubblico. Istanze di ID estesi. In Curation, il campo eids contiene i dati che il publisher rende disponibili, ad esempio gli indicatori sicuri.

EID

Attributo Tipo Descrizione
source stringa Supportato solo per i partner di cura dei segmenti di pubblico. Fornitore di origine o tecnologia responsabile del set di dati incluso. Espresso come dominio di primo livello.
uids Array UID Supportato solo per i partner di cura dei segmenti di pubblico. Array di oggetti UID dall'origine specificata.

UID

Attributo Tipo Descrizione
id stringa Supportato solo per i partner di cura dei segmenti di pubblico. L'identificatore. Nella selezione, 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.
devicetype int Supportato solo per i partner di cura contestuale. Il tipo generale di dispositivo. Per scoprire di più sui possibili tipi di dispositivi, consulta Elenco: tipi di dispositivi in AdCOM 1.0.
os stringa Supportato solo per i partner di cura contestuale. Sistema operativo del dispositivo (ad es. "iOS").
make stringa Supportato solo per i partner di cura contestuale. Marca del dispositivo (ad es. "Apple").
ifa stringa ID pubblicità dispositivo non criptato (senza hash). Nel protocollo di cura in tempo reale di Google, si tratta in genere di un UUID di 36 caratteri, in cui gli ID Android sono in minuscolo e gli IDFA in maiuscolo. Per i dispositivi Samsung, si tratta di valori alfanumerici di 32 caratteri.

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.
city stringa Supportato solo per i partner di cura contestuale. Città che utilizza il codice delle Nazioni Unite per le località commerciali e di trasporto.

SegmentResponse

Attributo Tipo Descrizione
segment Array Segment 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.