Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Riferimento al campo ORTB
<a name="yield-optimization-ortb-reference"></a>

Questa pagina è un riferimento completo per ogni campo della richiesta di offerta OpenRTB. I campi sono classificati in base a come li MediaTailor gestisce e se APS li richiede o consiglia per una compilazione ottimale degli annunci.

Per le specifiche complete di OpenRTB 2.6, vedere le specifiche [ IAB OpenRTB 2.6. ](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md)

## Categorie di campi
<a name="yield-optimization-ortb-reference-categories"></a>


| Categoria | Significato | La tua azione | 
| --- | --- | --- | 
| obbligatorio  | Deve essere presente nel modello. MediaTailor genera un errore se manca. | È necessario fornire questi. | 
| Codificato da EMT  | MediaTailor li imposta sempre utilizzando i valori della configurazione della console o del contesto di disponibilità corrente. I valori del modello vengono sostituiti. | Non impostarli nel modello. | 
| APS consigliato  | Non sono strettamente richiesti da MediaTailor, ma APS li consiglia per una migliore compilazione e targeting degli annunci. La mancanza dei campi consigliati può comportare una riduzione delle percentuali di riempimento o una mancata offerta. | Fortemente consigliato. | 
| Opzionale | Sono inclusi nella richiesta di offerta solo se li fornisci. Nessun valore predefinito. | Fornisci se pertinente al tuo caso d'uso. | 

## ``oggetto app
<a name="yield-optimization-ortb-reference-app"></a>


| Campo | Categoria | Note | 
| --- | --- | --- | 
| app | obbligatorio  | L'appoggetto deve esistere nel modello. | 
| app.bundle | È obbligatorio  | L'ID del pacchetto della tua app (ad esempio,G15147002586). Non deve essere vuoto. | 
| app.storeurl | obbligatorio  | URL dell'App Store (ad esempiohttps://apps.apple.com/us/app/yourapp/id123). | 
| app.publisher.id | Codificato da EMT  | Sempre impostato sulla configurazione PublisherId della console. | 
| app.content | Obbligatorio (oggetto)  | MediaTailor invia un Content oggetto vuoto se lo si omette. Fornisci metadati dei contenuti per un targeting migliore. | 
| app.name | APS consigliato | Nome dell'app per l'identificazione. | 
| app.id | APS consigliato | L'identificatore della tua app in APS. | 
| app.domain | APS consigliato | Dominio dell'app. | 
| app.content.genre | APS consigliato | Genere di contenuto (ad esempio,"Sport","News"). | 
| app.content.contentrating | APS consigliato | Classificazione dei contenuti (ad esempio"TV-G","TV-14"). | 
| app.content.language | APS consigliato | Lingua dei contenuti (ISO-639-1). | 
| app.content.id | APS consigliato | Identificatore del contenuto. | 
| app.content.title | APS consigliato | Titolo del contenuto. | 
| app.content.episode | APS consigliato | Numero dell'episodio. | 
| app.content.len | APS consigliato | Durata del contenuto in secondi. | 
| app.cat | Facoltativo | Categorie di contenuti (tassonomia IAB). | 
| app.sectioncat | Facoltativo | Categorie di sezione. | 
| app.pagecat | Facoltativo | Categorie di pagine. | 
| app.ver | Facoltativo | Versione dell'app. | 
| app.privacypolicy | Facoltativo | 1 = ha una politica sulla privacy. | 
| app.paid | Facoltativo | 1 = app a pagamento. | 
| app.keywords | Facoltativo | Comma-separated parole chiave. | 
| app.kwarray | Facoltativo | Parole chiave come array. | 
| app.inventorypartnerdomain | Facoltativo | Dominio partner di Inventory. | 
| app.ext | Facoltativo | Oggetto di estensione (pass-through). | 

## `oggetto dispositivo`
<a name="yield-optimization-ortb-reference-device"></a>


| Campo | Categoria | Note | 
| --- | --- | --- | 
| device | obbligatorio  | L'deviceoggetto deve esistere nel modello. | 
| device.ua | È obbligatorio  | Stringa dell'agente utente. Non deve essere vuoto. Utilizza {{session.user\_agent}}. | 
| device.ip | obbligatorio  | Indirizzo IPv4. Non deve essere vuoto. Utilizza {{session.client\_ip}}. | 
| device.lmt | Facoltativo (impostazione predefinita: 0) | Contrassegno Limita il monitoraggio degli annunci. 0= tracciamento consentito, 1 = tracciamento limitato. Se non è fornito nel modello, il valore predefinito è. 0 | 
| device.devicetype | Codificato da EMT (impostazione predefinita: 3)  | MediaTailor set 3 (Connected TV) se non forniti. Il tuo valore viene utilizzato se presente. | 
| device.make | APS consigliato | Produttore del dispositivo (ad esempio"Samsung","Apple"). | 
| device.model | APS consigliato | Modello del dispositivo (ad esempio"Tizen TV","iPhone"). | 
| device.os | APS consigliato | Sistema operativo (ad esempio"Tizen","iOS"). | 
| device.osv | APS consigliato | Versione del sistema operativo. | 
| device.h | APS consigliato | Altezza dello schermo in pixel. | 
| device.w | APS consigliato | Larghezza dello schermo in pixel. | 
| device.language | APS consigliato | Lingua del dispositivo (ISO-639-1). | 
| device.ifa | APS consigliato | ID pubblicitario del dispositivo. Non tutti i dispositivi ne hanno uno (ad esempio, i browser Web). | 
| device.dnt | APS consigliato | Bandiera Do Not Track. | 
| device.geo | Facoltativo | Oggetto geografico concountry,lat,lon. | 
| device.sua | Facoltativo | Agente utente strutturato (UA-CH). | 
| device.ipv6 | Facoltativo | Indirizzo IPv6. | 
| device.hwv | Facoltativo | Versione hardware. | 
| device.connectiontype | Facoltativo | Tipo di connessione (WiFicellulare e così via). | 
| device.carrier | Facoltativo | Nome del corriere. | 
| device.mccmnc | Facoltativo |  country/network Codice mobile. | 
| device.ext | Facoltativo | Oggetto di estensione (pass-through). | 

## `oggetto imp` (impression)
<a name="yield-optimization-ortb-reference-imp"></a>

Il modello deve contenere esattamente ** un ** `imp` oggetto in un array.


| Campo | Categoria | Note | 
| --- | --- | --- | 
| imp[0].video | È obbligatorio  | L'videooggetto deve esistere. | 
| imp[0].video.mimes | È obbligatorio  | Tipi MIME supportati (ad esempio,["video/mp4"]). | 
| imp[0].video.protocols | Opzionale | Protocolli VAST supportati. Se omesso, MediaTailor utilizza il fallback codificato. [1, 2, 3, 4, 5, 6, 7, 8] Vedi il riferimento all'enumerazione del protocollo di seguito. | 
| imp[0].video.minduration | Codificato da EMT  | Imposta il tuo MinimumUnfilledDuration dalla console. | 
| imp[0].video.maxduration | Codificato da EMT  | Impostato sulla durata effettiva del vuoto (secondi). | 
| imp[0].video.maxseq | Codificato da EMT  | Calcolato:. floor(unfilled\_duration / 6) APS consiglia di poddur restituire maxseq o restituire più annunci. | 
| imp[0].video.poddur | Codificato da EMT  | Impostato sulla durata non compilata (secondi). | 
| imp[0].video.startdelay | Facoltativo | Ritardo di avvio. 0= pre-roll, -1 = mid-roll generico, -2 = post-roll, = offset mid-roll in secondi. > 0 Da utilizzare per le pause -1 dal vivo a metà del rollio. Fallback codificato:. 6 | 
| imp[0].video.w | APS consigliato | Larghezza del video in pixel. | 
| imp[0].video.h | APS consigliato | Altezza del video in pixel. | 
| imp[0].video.plcmt | APS consigliato | Tipo di posizionamento (1 = in-stream). | 
| imp[0].video.podid | APS consigliato | Identificatore del pod. | 
| imp[0].video.slotinpod | APS consigliato | Posizione dello slot nel pod. | 
| imp[0].video.ext.slotId | Facoltativo (impostazione predefinita:"default\_slot\_id") | L'ID dello slot APS dalla console APS. L'impostazione predefinita funziona, ma la fornitura dell'ID slot effettivo consente ad APS di applicare il targeting specifico dello slot e la tariffa minima. | 
| imp[0].bidfloor | Facoltativo (impostazione predefinita: 1.0) | Prezzo minimo di offerta in CPM. | 
| imp[0].secure | Facoltativo (impostazione predefinita: 1) | 1 = richiede gli URL creativi HTTPS. | 
| imp[0].id | Facoltativo | ID dell'impressione. Auto-generated se non fornito. | 
| imp[0].tagid | Facoltativo | Tag/placement ID. | 
| imp[0].bidfloorcur | Facoltativo | Valuta minima dell'offerta (impostazione predefinita in USD). | 
| imp[0].ssai | Facoltativo | Indicatore SSAI. | 
| imp[0].exp | Facoltativo | Ora di scadenza dell'impressione. | 
| imp[0].rqddurs | Facoltativo | Matrice delle durate richieste. | 
| imp[0].mincpmpersec | Facoltativo | CPM minimo al secondo. | 
| imp[0].pmp | Facoltativo | Oggetto di mercato privato. | 
| imp[0].ext | Facoltativo | Oggetto di estensione (pass-through). | 

### Riferimento enumerato al protocollo
<a name="yield-optimization-ortb-reference-protocol-enum"></a>


| Valore | Protocollo | 
| --- | --- | 
| 1 | VAST1.0 | 
| 2 | VAST2.0 | 
| 3 | VAST3.0 | 
| 4 | Involucro VAST 1.0 | 
| 5 | Involucro VAST 2.0 | 
| 6 | Involucro VAST 3.0 | 
| 7 | VAST4.0 | 
| 8 | Involucro VAST 4.0 | 
| 9\+ | DAAST | 

## Top-level campi
<a name="yield-optimization-ortb-reference-top-level"></a>


| Campo | Categoria | Note | 
| --- | --- | --- | 
| id | codificato da EMT  | Auto-generated: {sessionId}\_{availId} formato (ad esempio,). abc123-def456\_78901 Utile per correlare le richieste di offerta con i registri delle sessioni. | 
| cur | Facoltativo (impostazione predefinita:["USD"]) | Valute consentite. | 
| ext.integrationType | Codificato da EMT  | Sempre impostato su. "EMT" | 
| bcat | Facoltativo | Categorie di annunci bloccati (tassonomia IAB). Il valore del modello viene inviato così com'è ad APS. | 
| badv | Facoltativo | Domini degli inserzionisti bloccati. | 
| bapp | Facoltativo | ID dei pacchetti di app bloccati. | 
| test | Facoltativo | Bandiera della modalità test. | 
| at | Facoltativo | Tipo di asta. | 
| tmax | Facoltativo | Tempo massimo (ms) di attesa per la risposta all'offerta. | 
| wseat | Facoltativo | Posti per gli acquirenti consentiti. | 
| bseat | Facoltativo | Posti per gli acquirenti bloccati. | 
| wlang | Facoltativo | Linguaggi creativi consentiti. | 
| source | Facoltativo | Oggetto sorgente per la catena di fornitura. | 
| ext | Facoltativo | I campi di estensione personalizzati vengono uniti a quelli EMT. integrationType | 

## `oggetto utente`
<a name="yield-optimization-ortb-reference-user"></a>


| Campo | Categoria | Note | 
| --- | --- | --- | 
| user | Consigliato APS (UE) | Necessario per il traffico nell'UE con il consenso del GDPR. | 
| user.consent | Raccomandato da APS (UE) | Stringa di consenso GDPR (TCF). | 
| user.id | Facoltativo | ID utente. | 
| user.buyeruid | Facoltativo | Buyer-specific ID utente. | 
| user.eids | Facoltativo | Identificatori estesi (LiveRamp, UID2 e così via). | 
| user.data | Facoltativo | Segmenti di dati utente. | 
| user.ext | Facoltativo | Oggetto di estensione. | 

## `oggetto regs`
<a name="yield-optimization-ortb-reference-regs"></a>


| Campo | Categoria | Note | 
| --- | --- | --- | 
| regs | APS consigliato | Includere per la conformità normativa. | 
| regs.coppa | Consigliato APS (Stati Uniti) | Bandiera COPPA (1 = destinata ai bambini). | 
| regs.us\_privacy | Raccomandato da APS (USA) | Stringa US Privacy/CCPA. | 
| regs.gdpr | Raccomandato da APS (UE) | Si applica il GDPR (1 = sì). | 
| regs.gpp | APS consigliato | Stringa Global Privacy Platform. Preferito rispetto us\_privacy al pubblico statunitense, si traduce in tassi di riempimento migliori. Consulta [Best practice](yield-optimization-best-practices.md). | 
| regs.gpp\_sid | Consigliato APS | ID di sezione GPP (ad esempio, [7] per i cittadini statunitensi). Obbligatorio quando gpp è presente. | 
| regs.ext | Facoltativo | Oggetto di estensione. | 

## Fasi successive
<a name="yield-optimization-ortb-reference-next-steps"></a>
+ Per i modelli copia-incolla, vedere. [Modelli di esempio](yield-optimization-examples.md)
+ Per consigli su come massimizzare i tassi di riempimento, consulta. [Best practice](yield-optimization-best-practices.md)