Données structurées – v10 – Annonce

Pour obtenir une explication du format, consultez la présentation.

ChampObligatoireTypeAccessible en écritureDescription
Identifiant de l'annonceObligatoire uniquement lors de la modification d'annonces existantesentierNonIdentifiant numérique de l'annonce du groupe d'annonces. Si cette valeur n'est pas renseignée, une annonce sera créée avec un identifiant unique.
ID du groupe d'annoncesOuientierNonIdentifiant numérique du groupe d'annonces parent. Vous pouvez spécifier un identifiant personnalisé ("ext[identifiant personnalisé du groupe d'annonces]", par exemple) pour un groupe d'annonces que vous créez en même temps que cette annonce.
Nom du groupe d'annoncesNonchaîneNonNom du groupe d'annonces
NomOuichaîneOuiNom de l'entrée.
ÉtatOuichaîneOuiParamètre d'état de l'entrée.
  • Actif
  • Suspendu
  • Supprimé
Type d'annonceObligatoire pour les annonces YouTube et Demand GenchaîneOuiFormat de l'annonce.

Les annonces vidéo InStream et In-Feed sont des types d'annonces vidéo YouTube vendus au CPV. Les annonces bumper sont des annonces vidéo YouTube de 6 secondes ou moins vendues au CPM. Les annonces vidéo non désactivables sont des annonces YouTube InStream de 6 à 15 secondes vendues au CPM. Les annonces audio YouTube sont des annonces audio YouTube. Les annonces vidéo responsives sont des types d'annonces YouTube diffusées dans plusieurs formats. Les annonces à couverture efficace sont diffusées en tant qu'annonces bumper YouTube si la vidéo est suffisamment courte, et en tant qu'annonces InStream YouTube dans le cas contraire. Les annonces vidéo Demand Gen sont diffusées dans plusieurs formats, y compris, mais sans s'y limiter, YouTube. Les annonces illustrées Demand Gen affichent des images. Les annonces carrousel Demand Gen affichent des fiches. Les annonces produit Demand Gen affichent des produits.

Sélectionnez l'une des valeurs suivantes :
  • InStream
  • In-feed video
  • Bumper
  • Non désactivable
  • Audio YouTube
  • Responsive
  • Couverture efficace
  • Produit Demand Gen
  • Vidéo Demand Gen
  • Image Demand Gen
  • Carrousel Demand Gen
ID vidéoObligatoire pour les annonces vidéo YouTube et Demand GenchaîneOuiID vidéo YouTube
URL à afficherOui pour les annonces InStream et bumperchaîneOuiURL à afficher de l'annonce
URL de la page de destinationObligatoire pour les annonces InStream, bumper et Demand GenchaîneOuiURL de la page de destination de l'annonce
Suivi DCM : ID d'emplacementObligatoire uniquement lors de la mise à jour d'une annonce de suivi DCMentierOuiIdentifiant numérique de l'emplacement DCM pour l'annonce de suivi correspondante.
Pour supprimer une annonce de suivi DCM, laissez les trois colonnes "Suivi DCM : ID d'emplacement", "Suivi DCM : ID d'annonce" et "Suivi DCM : ID de la création" vides.
Suivi DCM : ID d'annonceObligatoire uniquement lors de la mise à jour d'une annonce de suivi DCMentierOuiIdentifiant numérique de l'annonce DCM pour l'annonce de suivi correspondante.Pour supprimer une annonce de suivi DCM, laissez les trois colonnes "Suivi DCM : ID d'emplacement", "Suivi DCM : identifiant de l'annonce" et "Suivi DCM : ID de la création" vides.
Suivi DCM : ID de créationObligatoire uniquement lors de la mise à jour d'une annonce de suivi DCMentierOuiIdentifiant numérique de la création pour l'annonce de suivi correspondante.Pour supprimer une annonce de suivi DCM, laissez les trois colonnes "Suivi DCM : ID d'emplacement", "Suivi DCM : ID d'annonce" et "Suivi DCM : ID de création" vides.
URL de tracker de clicsNonchaîneOuiURL de tracker de clics de l'annonce
Paramètres de l'URL de tracker de clicsNonchaîne, liste de listesOuiParamètres personnalisés de l'URL de tracker de clics. Format : (nom1; valeur1;); (nom2; valeur2;); etc.
Incitation à l'actionObligatoire lorsque le champ "Titre" n'est pas vide ou que le champ "Type d'annonce" est défini sur "Vidéo Demand Gen", "Image Demand Gen" ou "Carrousel Demand Gen"chaîneOuiLibellé du bouton d'incitation à l'action (une ligne de 10 caractères maximum).
TitreObligatoire pour les annonces Demand GenchaîneOuiTitre de la superposition d'incitation à l'action (une ligne de 15 caractères maximum).
Chemin de l'URL à afficher 1NonchaîneOuiChemin de l'URL à afficher 1
Chemin de l'URL à afficher 2NonchaîneOuiChemin de l'URL à afficher 2
Miniature de la vidéo In-FeedOui pour les vidéos In-FeedchaîneOuiMiniature de la vidéo à utiliser pour les annonces Video Discovery
  • 0
  • 1
  • 2
  • 3
Titre de la vidéo In-FeedObligatoire pour les annonces vidéo In-Feed et Demand GenchaîneOuiTexte du titre d'une annonce Discovery ou responsive, ou titre long pour les annonces Demand Gen.
Description 1Obligatoire pour les annonces vidéo In-Feed et Demand GenchaîneOuiTexte de la description 1 de l'annonce Discovery ou description de l'annonce responsive
Description 2Obligatoire pour les vidéos In-FeedchaîneOuiTexte de la description 2 de l'annonce Discovery
Page de destination de la vidéo In-FeedOui pour les vidéos In-FeedchaîneOuiPage de destination de l'annonce Discovery
URL de la page de destination pour mobileNonchaîneOuiURL de la page de destination de l'annonce pour les appareils mobiles
Nom de l'entrepriseObligatoire pour les annonces Demand GenchaîneOuiNom de l'entreprise faisant l'objet de la publicité

À compter du 13 juillet 2026, cette colonne pourra être définie pour les annonces responsives en plus des annonces Demand Gen. Si elle n'est pas définie, elle héritera de la valeur par défaut de son annonceur parent. Si aucune valeur par défaut n'est définie, elle restera vide. Cette colonne ne sera plus obligatoire pour les annonces Demand Gen si une valeur par défaut est définie au niveau de l'annonceur.
Suffixe de l'URL de la page de destinationNonchaîneOuiSuffixe de l'URL de la page de destination
ID des éléments de logoObligatoire pour les annonces Demand Genchaîne, listeOuiListe des ID d'éléments pour les logos. Cette liste est générée par ordre numérique croissant.

À compter du 13 juillet 2026, cette colonne pourra être définie pour les annonces responsives en plus des annonces Demand Gen. Si elle n'est pas définie, elle héritera de la valeur par défaut de son annonceur parent. Si aucune valeur par défaut n'est définie, elle restera vide. Cette colonne ne sera plus obligatoire pour les annonces Demand Gen si une valeur par défaut est définie au niveau de l'annonceur.
ID des éléments d'image marketingObligatoire lorsque le champ "Type d'annonce" est défini sur "Image Demand Gen"chaîne, listeOuiListe des ID d'éléments pour les images marketing. Cette liste est générée par ordre croissant.
Fiches Demand GenObligatoire lorsque le champ "Type d'annonce" est défini sur "Carrousel Demand Gen"chaîne, liste de listesOuiDéfinit une liste de fiches au format suivant :

(URL finale; URL finale pour mobile; URL; titre; texte de l'incitation à l'action; ID du composant Image marketing; ID d'éléments marketing supplémentaires...).

Par exemple : (google.com; mobile.google.com; Titre; Cliquez ici; 10020; 20020; 30020).

Chaque élément marketing doit avoir un format unique. Si une fiche d'une annonce comporte une image marketing carrée, toutes les fiches de cette annonce doivent comporter une image marketing carrée (cela s'applique également aux autres formats).

ID des éléments de bannière associéeNonchaîne, listeOuiListe des ID d'éléments pour les bannières associées. Cette liste est générée par ordre numérique croissant. Ce format est compatible avec les annonces vidéo axées sur les performances, les annonces vidéo Demand Gen, les annonces InStream, les annonces bumper et les annonces non désactivables. Format de la liste : 100; 200;