Scopri le specifiche della funzionalità di selezione in tempo reale
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Google invia un
SegmentRequest
in base alle richieste di annunci che corrispondono al tuo inventario target alla tua integrazione di selezione in tempo reale. 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 selezione in tempo reale supporta gli oggetti SegmentRequest e SegmentResponse inviati in formato JSON.
Questa guida è un riferimento per il protocollo di selezione in tempo reale che può aiutarti a creare la tua integrazione.
Supportato solo per i partner di selezione contestuale. Un descrittore del sito web. Il campo site viene compilato se il contenuto supportato dagli annunci è un sito web anziché un'applicazione non browser.
Supportato solo per i partner di selezione contestuale. Un descrittore dell'app. Il campo app viene compilato se il contenuto supportato dagli annunci è un'applicazione non browser anziché un sito web.
Supportato solo per i partner di selezione 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 selezione 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.
Supportato solo per i partner di selezione contestuale. Questo campo viene compilato se l'impressione viene offerta come opportunità di annunci banner.
Questo campo viene compilato con le estensioni per l'oggetto Imp.
Banner
Attributo
Tipo
Descrizione
w
int
Supportato solo per i partner di selezione contestuale. Larghezza in pixel indipendenti dal dispositivo (DIPS).
h
int
Supportato solo per i partner di selezione contestuale. Altezza in pixel indipendenti dal dispositivo (DIPS).
pos
int
Supportato solo per i partner di selezione contestuale. Posizione dell'annuncio sullo schermo. Per scoprire di più sulle possibili posizioni di posizionamento, consulta l'elenco delle posizioni di posizionamento in AdCOM 1.0.
Video
Attributo
Tipo
Descrizione
w
int
Supportato solo per i partner di selezione contestuale. Larghezza del video player in pixel indipendenti dal dispositivo (DIPS).
h
int
Supportato solo per i partner di selezione contestuale. Altezza del video player in pixel indipendenti dal dispositivo (DIPS).
pos
int
Supportato solo per i partner di selezione contestuale. Posizione dell'annuncio sullo schermo. Per scoprire di più sulle possibili posizioni di posizionamento, consulta l'elenco delle posizioni di posizionamento in AdCOM 1.0.
ImpExt
Attributo
Tipo
Descrizione
gpid
stringa
Supportato solo per i partner di selezione contestuale. Descrive l'ID posizionamento globale. Un ID distinto e persistente, specificato dal publisher, che è coerente tra i percorsi di fornitura per ogni unità pubblicitaria in una pagina. Consulta questo articolo.
Sito
Attributo
Tipo
Descrizione
page
stringa
Supportato solo per i partner di selezione contestuale. URL della pagina che mostra l'impressione.
mobile
int
Supportato solo per i partner di selezione contestuale. Indica se il sito è stato programmato per ottimizzare il layout quando viene visualizzato sui dispositivi mobili, dove 0 = no, 1 = sì.
App
Attributo
Tipo
Descrizione
bundle
stringa
Supportato solo per i partner di selezione contestuale. Un identificatore di applicazione specifico per la piattaforma che deve essere univoco per l'app. Su Android, il campo bundle è un nome di bundle o pacchetto. Su iOS, è un ID numerico.
Publisher
Attributo
Tipo
Descrizione
id
stringa
Supportato solo per i partner di selezione 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à l'ID impostato su pub-123.
Utente
Attributo
Tipo
Descrizione
consent
stringa
Una stringa di consenso del Transparency and Consent Framework (TCF) v2 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 TCF v2 e questa CMP indica che il GDPR si applica alla richiesta di annuncio e fornisce una stringa di consenso valida. Per maggiori dettagli sui fornitori elencati nella stringa di consenso, consulta l'elenco globale dei fornitori di IAB all'indirizzo vendor-list.consensu.org/v2/vendor-list.json.
Supportato solo per i partner di selezione di indicatori sicuri. Istanze di ID estesi. Nella selezione, 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 di indicatori sicuri. Origine o fornitore di tecnologia responsabile del set di dati inclusi. Espresso come dominio di primo livello.
Supportato solo per i partner di selezione di indicatori sicuri. Array di oggetti UID dall'origine specificata.
UID
Attributo
Tipo
Descrizione
id
stringa
Supportato solo per i partner di selezione di indicatori sicuri. 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.
Supportato solo per i partner di selezione contestuale. Posizione del dispositivo dell'utente.
devicetype
int
Supportato solo per i partner di selezione contestuale. Il tipo generale di dispositivo. Per scoprire di più sui possibili tipi di dispositivo, consulta l'elenco dei tipi di dispositivo in AdCOM 1.0.
os
stringa
Supportato solo per i partner di selezione contestuale. Sistema operativo del dispositivo (ad es. "iOS").
make
stringa
Supportato solo per i partner di selezione contestuale. Marca del dispositivo (ad es. "Apple").
Dati geografici
Attributo
Tipo
Descrizione
country
stringa
Supportato solo per i partner di selezione contestuale. Paese che utilizza lo standard ISO-3166-1 Alpha-3.
region
stringa
Supportato solo per i partner di selezione contestuale. Codice regione che utilizza lo standard ISO-3166-2; codice stato di due lettere se USA.
metro
stringa
Supportato solo per i partner di selezione contestuale. Codice metro di Google trovato nel file geo-table.csv.
city
stringa
Supportato solo per i partner di selezione contestuale. Città che utilizza il codice delle Nazioni Unite per le località commerciali e di trasporto.
L'ID del segmento. L'ID deve corrispondere a curatorDataSegmentId presente nel nome del segmento nella risorsa curators.dataSegments dell'API Marketplace.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2026-03-31 UTC."],[],[]]
