Données structurées – v8 – Annonce

Cette version du fichier de données structurées est en version bêta. Elle n'est disponible que pour un sous-ensemble d'utilisateurs. Des modifications non annoncées peuvent être apportées aux versions bêta.

SDF v8 est compatible avec les ressources de génération de la demande, qui sont en version bêta. Les éléments de campagne, les groupes d'annonces et les annonces de génération de la demande ne sont disponibles que pour les utilisateurs inscrits à la version bêta.

Pour en savoir plus sur ce 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	Identifiant numérique de l'annonce du groupe d'annonces. Si vous ne renseignez pas ce champ, 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 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 de YouTube. Les annonces vidéo responsives sont des types d'annonces YouTube diffusés dans plusieurs formats. Les annonces avec couverture efficace sont diffusées en tant que bumper YouTube si la vidéo est suffisamment courte et en tant qu'annonce InStream YouTube dans le cas contraire. Les annonces vidéo de génération de la demande sont diffusées dans plusieurs formats, y compris, mais sans s'y limiter, sur YouTube. Les annonces illustrées de génération de la demande affichent des images. Les annonces carrousel de génération de la demande affichent des fiches. Les annonces produit de génération de la demande affichent des produits. Sélectionnez l'une des valeurs suivantes: InStream Vidéo In-Feed Bumper Non désactivable Audio YouTube Annonce responsive Couverture efficace Produit de génération de la demande Vidéo de génération de la demande Image de génération de la demande Carrousel de génération de la demande
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	L'URL à afficher de l'annonce
URL de la page de destination	Obligatoire pour les annonces InStream, bumper et de génération de la demande	chaîne	Oui	L'URL de la page de destination de l'annonce
Suivi DCM – ID d'emplacement	Obligatoire uniquement lors de la mise à jour de l'annonce de suivi DCM	entier	Oui	Valeur de l'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 - Identifiant d'annonce	Obligatoire uniquement lors de la mise à jour de l'annonce de suivi DCM	entier	Oui	Valeur de l'ID 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 - ID de l'annonce" et "Suivi DCM - ID de la création" vides.
Suivi DCM - ID de création	Obligatoire uniquement lors de la mise à jour de l'annonce de suivi DCM	entier	Oui	Identifiant numérique de la création associée à l'annonce de suivi correspondante.Pour supprimer une annonce de suivi DCM, ne renseignez pas les trois colonnes "Suivi DCM : ID de l'emplacement", "Suivi DCM" : ID de l'annonce et "ID de la création".
URL du tracker de clics	Non	chaîne	Oui	L'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 = (nom1; valeur1;); (nom2; valeur2;); etc.
Incitation à l'action	Obligatoire lorsque l'élément de campagne parent est un élément de campagne vidéo YouTube pour l'action, "Titre" n'est pas vide ou 'Type d'annonce' est "Vidéo de génération de la demande", "Image de génération de la demande", "Carrousel de génération de la demande".	chaîne	Oui	Libellé du bouton d'incitation à l'action (1 ligne, 10 caractères maximum).
Titre	Obligatoire pour les annonces de génération de la demande	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 vidéo In-Feed	Oui pour les annonces vidéo In-Feed	chaîne	Oui	Miniature de 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 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 de génération de la demande	chaîne	Oui	Texte de la description 1 de l'annonce Discovery ou description de l'annonce responsive
Description 2	Obligatoire pour les vidéos In-Feed	chaîne	Oui	Texte de la description 2 de l'annonce Discovery
Page de destination de la 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	L'URL de la page de destination de l'annonce pour les appareils mobiles
Nom de l'entreprise	Obligatoire pour les annonces de génération de la demande	chaîne	Oui	Nom de l'entreprise dont vous faites la promotion
Suffixe de l'URL de la page de destination	Non	chaîne	Oui	Suffixe de l'URL de page de destination
ID des éléments de logo	Obligatoire pour les annonces de génération de la demande	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.
ID des composants Image marketing	Obligatoire si 'Type d'annonce' est "Image de génération de la demande"	chaîne, liste	Oui	Liste des ID des assets des images marketing. Cette liste est générée par ordre croissant.
Fiches de génération de la demande	Obligatoire si 'Type d'annonce' est "Carrousel de génération de la demande"	chaîne, liste de listes	Oui	Ce code définit une liste de fiches, au format suivant: (URL finale ; finale pour mobile ; url ; titre ; texte de l'incitation à l'action ; ID du composant Image marketing ; ID des assets marketing supplémentaires, etc.). Par exemple: (google.fr; mobile.google.com; Titre; Cliquez ici; 10020; 20020; 30020). Chaque support marketing doit avoir un format unique. Si une fiche sous une annonce contient une image marketing carrée, toutes les fiches situées sous cette annonce doivent comporter une image marketing carrée (cela s'applique également aux autres formats).
ID des éléments des bannières associées	Non	chaîne, liste	Oui	Liste des ID des éléments des 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, les annonces vidéo de génération de la demande, les annonces InStream, bumper et non désactivables. Format de la liste = 100; 200;