Allegato: Mappatura dei campi dell'interfaccia utente ai campi dell'API per tipo di creatività
La tabella riportata di seguito mappa i campi dell'interfaccia utente ai campi dell'API corrispondenti, separati per tipo di creatività. Alcuni campi API richiedono ulteriori specifiche mediante un ruolo o un tipo assegnato per la risorsa fornita.
Creatività immagine standard
| Tipo di creatività: CREATIVE_TYPE_STANDARD |
| Origine hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Asset della creatività
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_MAIN
|
|
|
URL pagina di destinazione
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: exit_EVENT_TYPE_DEFAULT
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
Tag di monitoraggio HTML aggiunto
|
|
Facoltativo
|
|
Nome campo API:aggiungeTag
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Creatività HTML5
| Tipo di creatività: CREATIVE_TYPE_STANDARD |
| Origine hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Asset della creatività
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_MAIN
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
Immagini di backup
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_BACKUP
|
|
|
URL pagina di destinazione di backup
|
|
Facoltativo
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: Esci_EVENT_TYPE_BACKUP
|
|
|
Etichetta report uscita di backup
|
|
Facoltativo
|
|
Nome campo API: exitEvents[].reportingName
|
|
Tipo di evento di uscita: Esci_EVENT_TYPE_BACKUP
|
|
|
Immagini con caricamento "polite"
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_POLITE_LOAD
|
|
|
Uscite
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[]
|
|
Tipo di evento di uscita: exit_EVENT_TYPE_DEFAULT
|
|
|
Contatori
|
|
Facoltativo
|
|
Nome campo API: contatoreEventi[]
|
|
|
Timer
|
|
Facoltativo
|
|
Nome campo API: timerEvents[]
|
|
|
Tag di monitoraggio HTML aggiunto
|
|
Facoltativo
|
|
Nome campo API:aggiungeTag
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Facoltativo
|
|
Nome campo API: reviewStatus
|
|
Creatività display di terze parti
| Tipo di creatività: CREATIVE_TYPE_STANDARD |
| Origine hosting: HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
Dimensioni
|
|
Obbligatorio
|
|
Nome campo API: dimensioni
|
|
|
URL pagina di destinazione
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: exit_EVENT_TYPE_DEFAULT
|
|
|
Richiede MRAID
|
|
Facoltativo
|
|
Nome campo API: requestMraid
|
|
|
Richiede HTML5
|
|
Facoltativo
|
|
Nome campo API: needHTML5
|
|
|
Tag di terze parti
|
|
Obbligatorio
|
|
Nome campo API: thirdPartyTag
|
|
|
Richiede ping per l'attribuzione
|
|
Facoltativo
|
|
Nome campo API: requestPingForAttribution
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Creatività espandibile di terze parti
| Tipo di creatività: CREATIVE_TYPE_EXPANDABLE |
| Origine hosting: HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
Dimensioni
|
|
Obbligatorio
|
|
Nome campo API: dimensioni
|
|
|
URL pagina di destinazione
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: exit_EVENT_TYPE_DEFAULT
|
|
|
Richiede MRAID
|
|
Facoltativo
|
|
Nome campo API: requestMraid
|
|
|
Richiede HTML5
|
|
Facoltativo
|
|
Nome campo API: needHTML5
|
|
|
Direzione di espansione
|
|
Obbligatorio
|
|
Nome campo API: expandDirection
|
|
|
Espandi al passaggio del mouse
|
|
Facoltativo
|
|
Nome campo API: expandOnHover
|
|
|
Di terze parti
|
|
Obbligatorio
|
|
Nome campo API: thirdPartyTag
|
|
|
Richiede ping per l'attribuzione
|
|
Facoltativo
|
|
Nome campo API: requestPingForAttribution
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Creatività video di terze parti
| Tipo di creatività: CREATIVE_TYPE_VIDEO |
| Origine hosting: HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
URL tag VAST
|
|
Obbligatorio
|
|
Nome campo API: vastTagUrl
|
|
|
VPAID
|
|
Sola lettura
|
|
Nome campo API: vpaid
|
|
|
Video HTML5
|
|
Sola lettura
|
|
Nome campo API: html5Video
|
|
|
Richiede ping per l'attribuzione
|
|
Facoltativo
|
|
Nome campo API: requestPingForAttribution
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Creatività audio di terze parti
| Tipo di creatività: CREATIVE_TYPE_AUDIO |
| Origine hosting: HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
URL tag VAST
|
|
Obbligatorio
|
|
Nome campo API: vastTagUrl
|
|
|
Richiede ping per l'attribuzione
|
|
Facoltativo
|
|
Nome campo API: requestPingForAttribution
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Creatività video
| Tipo di creatività: CREATIVE_TYPE_VIDEO |
| Origine hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
File di origine
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_MAIN
|
|
|
URL pagina di destinazione
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: exit_EVENT_TYPE_DEFAULT
|
|
|
Includi pulsante Salta
|
|
Facoltativo
|
|
Nome campo API: ignorabile
|
|
|
Tempo prima del pulsante Salta
|
|
Facoltativo
|
|
Nome campo API: skipOffset
|
|
|
Offset avanzamento
|
|
Facoltativo
|
|
Nome campo API: progressOffset
|
|
|
ID annuncio universale
|
|
Facoltativo
|
|
Nome campo API: universalAdId
|
|
|
OBA
|
|
Facoltativo
|
|
Nome campo API: obaIcon
|
|
|
Creatività companion
|
|
Facoltativo
|
|
Nome campo API: companionCreativeIds
|
|
|
File per la pubblicazione
|
|
Sola lettura
|
|
Nome campo API: transcodifiche
|
|
|
URL di terze parti
|
|
Facoltativo
|
|
Nome campo API: thirdPartyUrls
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Creatività audio
| Tipo di creatività: CREATIVE_TYPE_AUDIO |
| Origine hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
File di origine
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_MAIN
|
|
|
URL pagina di destinazione
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: exit_EVENT_TYPE_DEFAULT
|
|
|
Asset companion (carica o assegna)
|
|
Obbligatorio
|
|
Nome campo API: companionCreativeIds
|
|
|
Nome file per la pubblicazione
|
|
Sola lettura
|
|
Nome campo API: transcodifiche[].name
|
|
|
Tipo di file per la pubblicazione
|
|
Sola lettura
|
|
Nome campo API: transcodifiche[].mimeType
|
|
|
Velocità in bit dell'audio del file per la pubblicazione
|
|
Sola lettura
|
|
Nome campo API: transcodifiche[].audioBitRateKbps
|
|
|
Frequenza di campionamento audio del file per la pubblicazione
|
|
Sola lettura
|
|
Nome campo API: transcodifiche[].audioSampleRateHz
|
|
|
URL di terze parti
|
|
Facoltativo
|
|
Nome campo API: thirdPartyUrls
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Creatività display nativa
| Tipo di creatività: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_square |
| Origine hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
riconosciuto
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
Logo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_ICON
|
|
|
Immagine / immagine quadrata
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_MAIN
|
|
|
Titolo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_HEADLINE
|
|
|
Titolo lungo
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_LONG_HEADLINE
|
|
|
Corpo del testo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_BODY
|
|
|
Testo del corpo lungo
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_LONG_BODY
|
|
|
URL pagina di destinazione
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: exit_EVENT_TYPE_DEFAULT
|
|
|
URL sottotitolo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_CAPTION_URL
|
|
|
Call to action
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_CALL_TO_ACTION
|
|
|
Annuncio di monitoraggio di Campaign Manager 360
|
|
Facoltativo
|
|
Nome campo API: cmTrackingAd
|
|
|
URL di monitoraggio delle impressioni 1
|
|
Facoltativo
|
|
Nome campo API: URLdimonitoraggio[]
|
|
|
URL di monitoraggio delle impressioni 2
|
|
Facoltativo
|
|
Nome campo API: URLdimonitoraggio[]
|
|
|
URL di monitoraggio JavaScript
|
|
Facoltativo
|
|
Nome campo API: jsTrackerUrl
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Creatività video nativa
| Tipo di creatività: CREATIVE_TYPE_NATIVE_VIDEO |
| Origine hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
Logo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_ICON
|
|
|
Video
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_MAIN
|
|
|
Immagine di copertina
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_COVER_IMAGE
|
|
|
Nome inserzionista
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_ADVERTISER_NAME
|
|
|
Titolo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_HEADLINE
|
|
|
Titolo lungo
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_LONG_HEADLINE
|
|
|
Corpo del testo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_BODY
|
|
|
Testo del corpo lungo
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo risorsa: ASSET_ROLE_LONG_BODY
|
|
|
URL pagina di destinazione
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: exit_EVENT_TYPE_DEFAULT
|
|
|
URL sottotitolo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_CAPTION_URL
|
|
|
Call to action
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_CALL_TO_ACTION
|
|
|
URL di monitoraggio delle impressioni 1
|
|
Facoltativo
|
|
Nome campo API: URLdimonitoraggio[]
|
|
|
URL di monitoraggio delle impressioni 2
|
|
Facoltativo
|
|
Nome campo API: URLdimonitoraggio[]
|
|
|
URL di monitoraggio JavaScript
|
|
Facoltativo
|
|
Nome campo API: jsTrackerUrl
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: IntegrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2023-12-01 UTC.
[null,null,["Ultimo aggiornamento 2023-12-01 UTC."],[[["This document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video."],["Each creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types."],["Creative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names."],["Campaign Manager 360 tracking ad can optionally be included using the `cmTrackingAd` API field."],["This mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system."]]],[]]
