Données structurées – v11 – Annonce

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

Champ	Obligatoire	Type	Accessible en écriture	Description
Identifiant de l'annonce	Obligatoire uniquement lorsque vous modifiez des 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	Valeur d'ID 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 annonces bumper 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 sont 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 des vidéos YouTube utilisées par l'annonce. Chaque ID de vidéo YouTube peut également être associé à une valeur d'état d'attestation de contenu synthétique. Cette valeur indique s'il faut ajouter un libellé à la vidéo pour signaler qu'elle a été créée ou modifiée à l'aide de l'IA lorsqu'elle est diffusée dans des régions où des réglementations locales sur le libellé de l'IA sont en vigueur : "ACTIVÉ" indique que la vidéo a été créée ou modifiée à l'aide de l'IA. "DÉSACTIVÉ" indique que la vidéo n'a pas été créée ni modifiée à l'aide de l'IA. Si vous ne renseignez pas cette valeur, aucune attestation ne sera fournie. Si une attestation a déjà été fournie pour cet ID vidéo YouTube pour cet annonceur, la valeur de l'attestation existante sera automatiquement appliquée. Si la valeur "ON" ou "OFF" est fournie pour un ID de vidéo YouTube, cette attestation sera appliquée à toutes les utilisations existantes de cet ID de vidéo YouTube pour cet annonceur. Pour en savoir plus, consultez Libellés d'IA dans les annonces à l'aide de fichiers de données structurées. Format de la liste : (ID vidéo YouTube ; état de l'attestation de contenu synthétique) ; (ID vidéo YouTube ; état de l'attestation de contenu synthétique) ; etc.) Par exemple : "(abdefg; ON);(hijlk; OFF);(mnopq;)"
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 d'ID numérique de l'emplacement DCM pour l'annonce de suivi correspondante. Pour supprimer une annonce de suivi DCM, laissez vides les trois colonnes "Suivi DCM – ID de l'emplacement", "Suivi DCM – ID de l'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 d'ID numérique de l'annonce DCM 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".
Suivi DCM : ID de la création	Obligatoire uniquement lorsque vous mettez à jour une annonce de suivi DCM	entier	Oui	Valeur d'ID numérique de la création pour l'annonce de suivi correspondante.Pour supprimer une annonce de suivi DCM, laissez vides les trois colonnes "Suivi DCM – ID de l'emplacement", "Suivi DCM – ID de l'annonce" et "Suivi DCM – ID de la création".
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 de suivi des clics. Format : (name1; value1;); (name2; value2;); etc.
Incitation à l'action	Obligatoire 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î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	Vignette vidéo à utiliser pour les annonces vidéo Discovery 0 1 2 3
Titre de la vidéo In-Feed	Obligatoire pour les annonces vidéo In-Feed et Demand Gen	chaîne	Oui	Texte du titre d'une annonce Discovery ou responsive, ou titre long pour les annonces Demand Gen.
Description 1	Obligatoire pour les annonces vidéo In-Feed et Demand Gen	chaîne	Oui	Texte de la description 1 d'une annonce Discovery ou description d'une 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 si elle n'est pas définie au niveau de l'annonceur	chaîne	Oui	Nom de l'entreprise promue. Si vous ne spécifiez pas de valeur et qu'une valeur par défaut est définie au niveau de l'annonceur, celle-ci sera appliquée. À partir du 12 octobre 2026, cette colonne sera obligatoire pour toutes les annonces responsives YouTube si aucune valeur n'est définie au niveau de l'annonceur.
Suffixe de l'URL de la page de destination	Non	chaîne	Oui	Suffixe de l'URL de la page de destination
ID d'élément de logo	Obligatoire pour les annonces Demand Gen si elle n'est pas définie au niveau de l'annonceur	chaîne, liste	Oui	Liste des ID d'élément pour les logos. Cette liste est générée par ordre numérique croissant. Si vous ne spécifiez pas de valeur et qu'une valeur par défaut est définie au niveau de l'annonceur, celle-ci sera appliquée. À partir du 12 octobre 2026, cette colonne sera obligatoire pour toutes les annonces responsives YouTube si aucune valeur n'est définie au niveau de l'annonceur.
ID des composants Image marketing	Obligatoire lorsque le type d'annonce est "Annonce illustrée Demand Gen"	chaîne, liste	Oui	Liste des ID d'élément 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 ressource 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 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 ;
ID des composants Image d'annonce de pause	Non	chaîne, liste	Oui	Liste des ID d'élément pour les images des annonces pendant la pause. Par exemple : (100;200;300;) La compatibilité du fichier SDF avec les éléments de campagne de type "Offre instantanée", ainsi que leurs groupes d'annonces et annonces, est en version bêta et n'est disponible que pour les partenaires ajoutés à la liste d'autorisation. Les annonces associées aux accords instantanés ne seront pas incluses dans les fichiers téléchargés. Vous devrez les importer à l'aide du workflow de création d'accords instantanés YouTube de l'interface Display & Video 360.
ID de la création parente	Non	entier	Non	Identifiant numérique de la création parente Display & Video 360.