Données structurées – v8.1 – Annonce

Cette version du fichier de données structurées a été abandonnée. Les utilisateurs doivent utiliser la v10 des fichiers de données structurées pour continuer à les utiliser. N'utilisez cette documentation que pour les fichiers générés précédemment.

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

Champ	Obligatoire	Type	Accessible en écriture	Description
Identifiant de l'annonce	Obligatoire uniquement lors de la modification d'annonces existantes	entier	Non	Valeur d'ID 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'annonces	Oui	entier	Non	Identifiant 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'annonces	Non	chaîne	Non	Nom du groupe d'annonces
Nom	Oui	chaîne	Oui	Nom de l'entrée.
État	Oui	chaîne	Oui	Paramètre d'état de l'entrée. Actif Suspendu Supprimé
Type d'annonce	Obligatoire pour les annonces YouTube et de génération de la demande	chaîne	Oui	Format de l'annonce. Les annonces vidéo InStream et In-Feed sont des types d'annonces vidéo YouTube vendus au CPV. Les bumpers sont des annonces vidéo YouTube de six secondes ou moins, vendues au CPM. Les annonces vidéo non désactivables sont des annonces InStream YouTube de 6 à 15 secondes vendues au CPM. Les annonces audio YouTube sont des annonces audio diffusées sur YouTube. Les annonces vidéo responsives sont des types d'annonces YouTube qui peuvent être diffusées dans plusieurs formats. Les annonces axées sur la couverture efficace seront diffusées en tant que bumpers 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, sur YouTube. Les annonces illustrées Demand Gen affichent des images. Les annonces carrousel Demand Gen affichent des fiches. Les annonces produit Demand Gen présentent 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éo	Obligatoire pour les annonces vidéo YouTube et de génération de la demande	chaîne	Oui	ID vidéo YouTube
URL à afficher	Oui pour les annonces InStream et bumper	chaîne	Oui	URL à afficher de l'annonce
URL de la page de destination	Obligatoire pour les annonces InStream, bumpers et de génération de la demande	chaîne	Oui	URL de la page de destination de l'annonce
Suivi DCM : ID d'emplacement	Obligatoire uniquement lorsque vous mettez à jour une annonce de suivi DCM	entier	Oui	Valeur numérique de l'ID d'emplacement DCM pour l'annonce de suivi correspondante. Pour supprimer une annonce de suivi DCM, laissez vides les trois colonnes "Suivi DCM – ID d'emplacement", "Suivi DCM – ID d'annonce" et "Suivi DCM – ID de la création".
Suivi DCM : ID de l'annonce	Obligatoire uniquement lorsque vous mettez à jour une annonce de suivi DCM	entier	Oui	Valeur numérique de l'ID de l'annonce DCM pour l'annonce de suivi correspondante.Pour supprimer une annonce de suivi DCM, laissez vides les trois colonnes "Suivi DCM – ID d'emplacement", "Suivi DCM – ID d'annonce" et "Suivi DCM – ID de la création".
Suivi DCM : ID de la création	Obligatoire uniquement lorsque vous mettez à jour une annonce de suivi DCM	entier	Oui	Valeur numérique de l'ID de la création pour l'annonce de suivi correspondante.Pour supprimer une annonce de suivi DCM, laissez vides les trois colonnes "DCM Tracking – Placement ID", "DCM Tracking – Ad ID" et "DCM Tracking – Creative ID".
URL du tracker de clics	Non	chaîne	Oui	URL du tracker de clics sur l'annonce
Paramètres d'URL du tracker de clics	Non	chaîne, liste de listes	Oui	Paramètres personnalisés de l'URL du tracker de clics. Format : (name1; value1;); (name2; value2;); etc.
Incitation à l'action	Obligatoire lorsque l'élément de campagne parent est un élément de campagne vidéo YouTube pour l'action, que 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îne	Oui	Libellé du bouton d'incitation à l'action (une ligne de 10 caractères maximum).
Titre	Obligatoire pour les annonces Demand Gen	chaîne	Oui	Titre de l'incitation à l'action en superposition (une ligne de 15 caractères maximum).
Chemin de l'URL à afficher 1	Non	chaîne	Oui	Chemin de l'URL à afficher 1
Chemin de l'URL à afficher 2	Non	chaîne	Oui	Chemin de l'URL à afficher 2
Miniature de vidéo In-Feed	Oui pour les annonces vidéo In-Feed	chaîne	Oui	Miniature de la vidéo à utiliser pour les annonces Video Discovery 0 1 2 3
Titre de la vidéo In-Feed	Obligatoire pour les annonces vidéo In-Feed et les annonces de génération de la demande	chaîne	Oui	Texte du titre d'une annonce Discovery ou responsive, ou titre long pour les annonces de génération de la demande.
Description 1	Obligatoire pour les annonces vidéo In-Feed et les annonces de génération de la demande	chaîne	Oui	Texte de la description 1 de l'annonce Discovery ou de l'annonce responsive
Description 2	Obligatoire pour les annonces vidéo In-Feed	chaîne	Oui	Texte de la description 2 de l'annonce Discovery
Page de destination vidéo In-Feed	Oui pour les annonces vidéo In-Feed	chaîne	Oui	Page de destination de l'annonce Discovery
URL de la page de destination pour mobile	Non	chaîne	Oui	URL de la page de destination de l'annonce pour les appareils mobiles
Nom de l'entreprise	Obligatoire pour les annonces Demand Gen	chaîne	Oui	Nom de l'entreprise promue
Suffixe de l'URL de la page de destination	Non	chaîne	Oui	Suffixe de l'URL de la page de destination
ID des composants Logo	Obligatoire pour les annonces Demand Gen	chaîne, liste	Oui	Liste des ID d'éléments pour les logos. Cette liste est générée par ordre numérique croissant.
ID des composants Image marketing	Obligatoire lorsque le type d'annonce est "Annonce illustrée Demand Gen"	chaîne, liste	Oui	Liste des ID de composants pour les images marketing. Cette liste est générée par ordre croissant.
Fiches Demand Gen	Obligatoire lorsque le type d'annonce est "Demand Gen Carousel"	chaîne, liste de listes	Oui	Cela définit une liste de cartes, au format suivant : (URL finale, URL finale pour mobile, URL, titre, texte d'incitation à l'action, ID du composant Image marketing, ID des composants marketing supplémentaires, etc.) Par exemple : (google.com; mobile.google.com; Titre; Cliquez ici; 10020; 20020; 30020). Chaque asset 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 également comporter une image marketing carrée (cela s'applique également aux autres formats).
ID des éléments de bannière associée	Non	chaîne, liste	Oui	Liste des ID d'éléments pour les bannières associées. Cette liste est générée par ordre numérique croissant. Cette fonctionnalité est disponible pour les annonces vidéo axées sur les performances, vidéo Demand Gen, InStream, bumper et non désactivables. Format de la liste = 100 ; 200 ;