À partir du
8 septembre 2025, chaque nouvelle ligne devra indiquer si elle diffusera ou non des annonces à caractère politique dans l'Union européenne (UE). Les importations de fichiers SDF et les appels à l'API Display & Video 360 qui ne fournissent pas de déclarations échoueront. Pour savoir comment mettre à jour votre intégration afin d'effectuer cette déclaration, consultez notre
page sur les abandons de compatibilité.
Annexe: Mise en correspondance des champs de l'interface utilisateur avec les champs de l'API par type de création
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Le tableau ci-dessous met en correspondance les champs de l'UI avec les champs d'API correspondants, séparés par type de création. Notez que certains champs d'API nécessitent une spécification plus détaillée via un rôle ou un type attribué à la ressource fournie.
Création illustrée standard
| Type de création:CREATIVE_TYPE_STANDARD |
| Source d'hébergement:HOSTING_SOURCE_HOSTED |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
Asset de création
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'élément:ASSET_ROLE_MAIN
|
|
|
URL de la page de destination
|
|
Obligatoire
|
|
Nom de champ de l'API:exitEvents[].url
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_DEFAULT
|
|
|
État
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
Balise de suivi HTML ajoutée
|
|
Optional
|
|
Nom de champ de l'API:appendedTag
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Lecture seule
|
|
Nom du champ de l'API: reviewStatus
|
|
Création HTML5
| Type de création:CREATIVE_TYPE_STANDARD |
| Source d'hébergement:HOSTING_SOURCE_HOSTED |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
Asset de création
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'élément:ASSET_ROLE_MAIN
|
|
|
État
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
Images de back-up
|
|
Optional
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_BACKUP
|
|
|
URL de la page de destination de l'image de back-up
|
|
Optional
|
|
Nom de champ de l'API:exitEvents[].url
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_BACKUP
|
|
|
Libellé de création de rapports sur les sorties de l'image de back-up
|
|
Optional
|
|
Nom du champ de l'API:exitEvents[].reportingName
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_BACKUP
|
|
|
Images polite load
|
|
Optional
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_POLITE_LOAD
|
|
|
Sorties
|
|
Obligatoire
|
|
Nom de champ de l'API:exitEvents[]
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_DEFAULT
|
|
|
Compteurs
|
|
Optional
|
|
Nom de champ de l'API:counterEvents[]
|
|
|
Minuteurs
|
|
Optional
|
|
Nom de champ de l'API: timerEvents[]
|
|
|
Balise de suivi HTML ajoutée
|
|
Optional
|
|
Nom de champ de l'API:appendedTag
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Optional
|
|
Nom du champ de l'API: reviewStatus
|
|
Création display tierce
| Type de création:CREATIVE_TYPE_STANDARD |
| Source d'hébergement:HOSTING_SOURCE_THIRD_PARTY |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
État
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
Dimensions
|
|
Obligatoire
|
|
Nom de champ de l'API:dimensions
|
|
|
URL de la page de destination
|
|
Obligatoire
|
|
Nom de champ de l'API:exitEvents[].url
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_DEFAULT
|
|
|
MRAID requis
|
|
Optional
|
|
Nom du champ de l'API:requireMraid
|
|
|
HTML5 requis
|
|
Optional
|
|
Nom du champ de l'API:requireHtml5
|
|
|
Balise tierce
|
|
Obligatoire
|
|
Nom de champ de l'API:thirdPartyTag
|
|
|
Nécessite un ping pour l'attribution
|
|
Optional
|
|
Nom de champ de l'API:requirePingForAttribution
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Lecture seule
|
|
Nom du champ de l'API: reviewStatus
|
|
Création extensible tierce
| Type de création:CREATIVE_TYPE_EXPANDABLE |
| Source d'hébergement:HOSTING_SOURCE_THIRD_PARTY |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
État
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
Dimensions
|
|
Obligatoire
|
|
Nom de champ de l'API:dimensions
|
|
|
URL de la page de destination
|
|
Obligatoire
|
|
Nom de champ de l'API:exitEvents[].url
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_DEFAULT
|
|
|
MRAID requis
|
|
Optional
|
|
Nom du champ de l'API:requireMraid
|
|
|
HTML5 requis
|
|
Optional
|
|
Nom du champ de l'API:requireHtml5
|
|
|
Direction d'expansion
|
|
Obligatoire
|
|
Nom du champ de l'API:expandingDirection
|
|
|
Développer en passant la souris
|
|
Optional
|
|
Nom du champ de l'API:expandOnHover
|
|
|
Tiers
|
|
Obligatoire
|
|
Nom de champ de l'API:thirdPartyTag
|
|
|
Nécessite un ping pour l'attribution
|
|
Optional
|
|
Nom de champ de l'API:requirePingForAttribution
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Lecture seule
|
|
Nom du champ de l'API: reviewStatus
|
|
Création vidéo tierce
| Type de création:CREATIVE_TYPE_VIDEO |
| Source d'hébergement:HOSTING_SOURCE_THIRD_PARTY |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
État
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
URL du tag VAST
|
|
Obligatoire
|
|
Nom du champ de l'API: vastTagUrl
|
|
|
VPAID
|
|
Lecture seule
|
|
Nom de champ de l'API: vpaid
|
|
|
Vidéo au format HTML5
|
|
Lecture seule
|
|
Nom du champ de l'API:html5Video
|
|
|
Nécessite un ping pour l'attribution
|
|
Optional
|
|
Nom de champ de l'API:requirePingForAttribution
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Lecture seule
|
|
Nom du champ de l'API: reviewStatus
|
|
Création audio tierce
| Type de création:CREATIVE_TYPE_AUDIO |
| Source d'hébergement:HOSTING_SOURCE_THIRD_PARTY |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
État
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
URL du tag VAST
|
|
Obligatoire
|
|
Nom du champ de l'API: vastTagUrl
|
|
|
Nécessite un ping pour l'attribution
|
|
Optional
|
|
Nom de champ de l'API:requirePingForAttribution
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Lecture seule
|
|
Nom du champ de l'API: reviewStatus
|
|
Annonce vidéo
| Type de création:CREATIVE_TYPE_VIDEO |
| Source d'hébergement:HOSTING_SOURCE_HOSTED |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
État
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
Fichier source
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'élément:ASSET_ROLE_MAIN
|
|
|
URL de la page de destination
|
|
Obligatoire
|
|
Nom de champ de l'API:exitEvents[].url
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_DEFAULT
|
|
|
Inclure un bouton "Ignorer"
|
|
Optional
|
|
Nom de champ de l'API:champ facultatif
|
|
|
Délai avant de pouvoir ignorer
|
|
Optional
|
|
Nom de champ de l'API: skipOffset
|
|
|
Délai de visionnage avant facturation
|
|
Optional
|
|
Nom du champ de l'API:progressOffset
|
|
|
Identifiant d'annonce universel
|
|
Optional
|
|
Nom du champ de l'API:universalAdId
|
|
|
PCL
|
|
Optional
|
|
Nom du champ de l'API:obaIcon
|
|
|
Créations associées
|
|
Optional
|
|
Nom de champ de l'API:companionCreativeIds
|
|
|
Fichier à diffuser
|
|
Lecture seule
|
|
Nom de champ de l'API:transcodes
|
|
|
URL tierces
|
|
Optional
|
|
Nom de champ de l'API:thirdPartyUrls
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Lecture seule
|
|
Nom du champ de l'API: reviewStatus
|
|
Création audio
| Type de création:CREATIVE_TYPE_AUDIO |
| Source d'hébergement:HOSTING_SOURCE_HOSTED |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
État
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
Fichier source
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'élément:ASSET_ROLE_MAIN
|
|
|
URL de la page de destination
|
|
Obligatoire
|
|
Nom de champ de l'API:exitEvents[].url
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_DEFAULT
|
|
|
Asset associé (importer ou attribuer)
|
|
Obligatoire
|
|
Nom de champ de l'API:companionCreativeIds
|
|
|
Nom du fichier à diffuser
|
|
Lecture seule
|
|
Nom du champ de l'API:transcodes[].name
|
|
|
Type de fichier à diffuser
|
|
Lecture seule
|
|
Nom du champ de l'API:transcodes[].mimeType
|
|
|
Débit audio du fichier de diffusion
|
|
Lecture seule
|
|
Nom du champ de l'API:transcodes[].audioBitRateKbps
|
|
|
Taux d'échantillonnage audio du fichier de diffusion
|
|
Lecture seule
|
|
Nom du champ de l'API: transcodes[].audioSampleRateHz
|
|
|
URL tierces
|
|
Optional
|
|
Nom de champ de l'API:thirdPartyUrls
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Lecture seule
|
|
Nom du champ de l'API: reviewStatus
|
|
Création display native
| Type de création:CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_SQUARE |
| Source d'hébergement:HOSTING_SOURCE_HOSTED |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
état
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
Logo
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_ICON
|
|
|
Image / Image carrée
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'élément:ASSET_ROLE_MAIN
|
|
|
Titre
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_HEADLINE
|
|
|
Titre long
|
|
Optional
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_LONG_HEADLINE
|
|
|
Corps du texte
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_BODY
|
|
|
Corps du texte long
|
|
Optional
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_LONG_BODY
|
|
|
URL de la page de destination
|
|
Obligatoire
|
|
Nom de champ de l'API:exitEvents[].url
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_DEFAULT
|
|
|
URL de la légende
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_CAPTION_URL
|
|
|
Incitation à l'action
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_CALL_TO_ACTION
|
|
|
Annonce de suivi Campaign Manager 360
|
|
Optional
|
|
Nom du champ de l'API:cmTrackingAd
|
|
|
URL de suivi des impressions 1
|
|
Optional
|
|
Nom du champ de l'API:trackingUrls[]
|
|
|
URL de suivi des impressions 2
|
|
Optional
|
|
Nom du champ de l'API:trackingUrls[]
|
|
|
URL de suivi JavaScript
|
|
Optional
|
|
Nom du champ de l'API:jsTrackerUrl
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Lecture seule
|
|
Nom du champ de l'API: reviewStatus
|
|
Création vidéo native
| Type de création:CREATIVE_TYPE_NATIVE_VIDEO |
| Source d'hébergement:HOSTING_SOURCE_HOSTED |
|
Nom
|
|
Obligatoire
|
|
Nom de champ de l'API:displayName
|
|
|
État
|
|
Obligatoire
|
|
Nom du champ de l'API:entityStatus
|
|
|
Logo
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_ICON
|
|
|
Vidéo
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'élément:ASSET_ROLE_MAIN
|
|
|
Image de couverture
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_COVER_IMAGE
|
|
|
Nom de l'annonceur
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_ADVERTISER_NAME
|
|
|
Titre
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_HEADLINE
|
|
|
Titre long
|
|
Optional
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_LONG_HEADLINE
|
|
|
Corps du texte
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_BODY
|
|
|
Corps du texte long
|
|
Optional
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_LONG_BODY
|
|
|
URL de la page de destination
|
|
Obligatoire
|
|
Nom de champ de l'API:exitEvents[].url
|
|
Type d'événement de sortie:EXIT_EVENT_TYPE_DEFAULT
|
|
|
URL de la légende
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_CAPTION_URL
|
|
|
Incitation à l'action
|
|
Obligatoire
|
|
Nom du champ de l'API:assets
|
|
Rôle de l'asset:ASSET_ROLE_CALL_TO_ACTION
|
|
|
URL de suivi des impressions 1
|
|
Optional
|
|
Nom du champ de l'API:trackingUrls[]
|
|
|
URL de suivi des impressions 2
|
|
Optional
|
|
Nom du champ de l'API:trackingUrls[]
|
|
|
URL de suivi JavaScript
|
|
Optional
|
|
Nom du champ de l'API:jsTrackerUrl
|
|
|
Code d'intégration
|
|
Optional
|
|
Nom du champ de l'API:integrationCode
|
|
| Remarques |
|
Optional
|
|
Nom de champ de l'API:remarques
|
|
|
État de l'audit
|
|
Lecture seule
|
|
Nom du champ de l'API: reviewStatus
|
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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,[]]
