A partire dall'
8 settembre 2025, ogni nuovo elemento pubblicitario dovrà dichiarare se pubblicherà o meno annunci politici dell'Unione Europea (UE). I caricamenti di API Display & Video 360 e SDF che non forniscono dichiarazioni non andranno a buon fine. Consulta la nostra
pagina dei ritiri per ulteriori dettagli su come aggiornare l'integrazione per effettuare questa dichiarazione.
Allegato: Mappatura dei campi dell'interfaccia utente ai campi dell'API per tipo di creatività
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La tabella seguente mappa i campi dell'interfaccia utente ai campi API corrispondenti, separati per tipo di creatività. Tieni presente che alcuni campi dell'API richiedono ulteriori specificazioni tramite un ruolo o un tipo assegnato per la risorsa fornita.
Creatività immagine standard
| Tipo di creatività: CREATIVE_TYPE_STANDARD |
| Sorgente hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Asset della creatività
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo dell'asset: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: appendedTag
|
|
|
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 |
| Sorgente hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Asset della creatività
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo dell'asset:ASSET_ROLE_MAIN
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
Immagini di backup
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo dell'asset: ASSET_ROLE_BACKUP
|
|
|
URL pagina di destinazione di backup
|
|
Facoltativo
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: EXIT_EVENT_TYPE_BACKUP
|
|
|
Etichetta report uscita di backup
|
|
Facoltativo
|
|
Nome campo API: exitEvents[].reportingName
|
|
Tipo di evento di uscita: EXIT_EVENT_TYPE_BACKUP
|
|
|
Immagini con caricamento "polite"
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo dell'asset: ASSET_ROLE_POLITE_LOAD
|
|
|
Uscite
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[]
|
|
Tipo di evento di uscita: EXIT_EVENT_TYPE_DEFAULT
|
|
|
Contatori
|
|
Facoltativo
|
|
Nome campo API: counterEvents[]
|
|
|
Timer
|
|
Facoltativo
|
|
Nome campo API: timerEvents[]
|
|
|
Tag di monitoraggio HTML aggiunto
|
|
Facoltativo
|
|
Nome campo API: appendedTag
|
|
|
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 |
| Sorgente 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: requireMraid
|
|
|
Richiede HTML5
|
|
Facoltativo
|
|
Nome campo API: requireHtml5
|
|
|
Tag di terze parti
|
|
Obbligatorio
|
|
Nome campo API: thirdPartyTag
|
|
|
Richiede ping per l'attribuzione
|
|
Facoltativo
|
|
Nome campo API: requirePingForAttribution
|
|
|
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 |
| Sorgente 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: requireMraid
|
|
|
Richiede HTML5
|
|
Facoltativo
|
|
Nome campo API: requireHtml5
|
|
|
Direzione di espansione
|
|
Obbligatorio
|
|
Nome campo API: expandingDirection
|
|
|
Si espande 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: requirePingForAttribution
|
|
|
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 |
| Sorgente 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: requirePingForAttribution
|
|
|
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 |
| Sorgente 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: requirePingForAttribution
|
|
|
Codice integrazione
|
|
Facoltativo
|
|
Nome campo API: integrationCode
|
|
|
Note
|
|
Facoltativo
|
|
Nome campo API: note
|
|
|
Stato audit
|
|
Sola lettura
|
|
Nome campo API: reviewStatus
|
|
Annuncio video
| Tipo di creatività: CREATIVE_TYPE_VIDEO |
| Sorgente 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 dell'asset: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: skippable
|
|
|
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: transcodes
|
|
|
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 |
| Sorgente 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 dell'asset:ASSET_ROLE_MAIN
|
|
|
URL pagina di destinazione
|
|
Obbligatorio
|
|
Nome campo API: exitEvents[].url
|
|
Tipo di evento di uscita: EXIT_EVENT_TYPE_DEFAULT
|
|
|
Asset associato (carica o assegna)
|
|
Obbligatorio
|
|
Nome campo API: companionCreativeIds
|
|
|
Nome del file di pubblicazione
|
|
Sola lettura
|
|
Nome campo API: transcodes[].name
|
|
|
Tipo di file di pubblicazione
|
|
Sola lettura
|
|
Nome del campo API: transcodes[].mimeType
|
|
|
Velocità in bit audio del file per la pubblicazione
|
|
Sola lettura
|
|
Nome campo API: transcodes[].audioBitRateKbps
|
|
|
Frequenza di campionamento audio del file di pubblicazione
|
|
Sola lettura
|
|
Nome campo API: transcodes[].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 |
| Sorgente hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
Logo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_ICON
|
|
|
Immagine / Immagine quadrata
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo dell'asset:ASSET_ROLE_MAIN
|
|
|
Titolo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_HEADLINE
|
|
|
Titolo lungo
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo dell'asset: ASSET_ROLE_LONG_HEADLINE
|
|
|
Corpo del testo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo della risorsa: ASSET_ROLE_BODY
|
|
|
Testo del corpo lungo
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo della 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 dell'asset: ASSET_ROLE_CAPTION_URL
|
|
|
Call to action
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo dell'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: trackingUrls[]
|
|
|
URL di monitoraggio delle impressioni 2
|
|
Facoltativo
|
|
Nome campo API: trackingUrls[]
|
|
|
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 |
| Sorgente hosting: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obbligatorio
|
|
Nome campo API: displayName
|
|
|
Stato
|
|
Obbligatorio
|
|
Nome campo API: entityStatus
|
|
|
Logo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo asset: ASSET_ROLE_ICON
|
|
|
Video
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo dell'asset:ASSET_ROLE_MAIN
|
|
|
Immagine di copertina
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo dell'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 dell'asset: ASSET_ROLE_LONG_HEADLINE
|
|
|
Corpo del testo
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo della risorsa: ASSET_ROLE_BODY
|
|
|
Testo del corpo lungo
|
|
Facoltativo
|
|
Nome campo API: asset
|
|
Ruolo della 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 dell'asset: ASSET_ROLE_CAPTION_URL
|
|
|
Call to action
|
|
Obbligatorio
|
|
Nome campo API: asset
|
|
Ruolo dell'asset: ASSET_ROLE_CALL_TO_ACTION
|
|
|
URL di monitoraggio delle impressioni 1
|
|
Facoltativo
|
|
Nome campo API: trackingUrls[]
|
|
|
URL di monitoraggio delle impressioni 2
|
|
Facoltativo
|
|
Nome campo API: trackingUrls[]
|
|
|
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 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003eEach 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.\u003c/p\u003e\n"],["\u003cp\u003eCreative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names.\u003c/p\u003e\n"],["\u003cp\u003eCampaign Manager 360 tracking ad can optionally be included using the \u003ccode\u003ecmTrackingAd\u003c/code\u003e API field.\u003c/p\u003e\n"],["\u003cp\u003eThis mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system.\u003c/p\u003e\n"]]],[],null,[]]
