Vous devrez peut-être utiliser la version 9 ou ultérieure pour importer des fichiers de données structurées. Pour en savoir plus, consultez la page sur les abandons et le guide de migration vers la version 9 pour obtenir des instructions détaillées.
Données structurées – v9 – Campagne
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Pour obtenir une explication sur le format, consultez la présentation.
Champ
Obligatoire
Type
Accessible en écriture
Description
ID de campagne
Obligatoire uniquement lors de la modification de campagnes existantes
entier
Non
Valeur d'ID numérique de la campagne. Si cette valeur n'est pas renseignée, un ID de campagne sera créé avec un identifiant unique. Lors de la création d'une campagne, vous pouvez utiliser un identifiant personnalisé pour lui attribuer des ordres d'insertion. Un identifiant personnalisé se présente sous la forme "ext[identifiant personnalisé]". Par exemple : ext123. Lors de l'importation et du traitement du fichier, tous les identifiants personnalisés sont remplacés par les identifiants attribués par DBM. Les objets sont, quant à eux, associés (par exemple, ordre d'insertion à une campagne) en fonction des identifiants personnalisés.
Référence annonceur
Oui
entier
Non
Valeur d'ID numérique de l'annonceur. Il doit s'agir d'une référence annonceur existante et valide.
Nom
Oui
chaîne
Oui
Nom de l'entrée.
Horodatage
Obligatoire lorsque vous modifiez des entrées existantes
entier
Non
Horodatage de l'entrée. Cette valeur est utilisée par le système pour vérifier que l'entrée n'a pas changé entre le téléchargement et l'importation.
État
Oui
chaîne
Oui
Paramètre d'état de l'entrée.
Actif
Suspendu
Archivé
Objectif de la campagne
Oui
chaîne
Oui
Sélectionnez l'un des objectifs de campagne applicables :
Renforcer la notoriété de ma marque ou de mes produits
Générer des visites ou des actions en ligne
Générer des ventes hors connexion ou en magasin
Générer des installations d'application ou des engagements
KPI de l'objectif de la campagne
Oui
chaîne
Oui
Sélectionnez l'un des KPI d'objectif de campagne applicables :
CPM
Pourcentage d'impressions visibles
CPIAVC
CPA
CPC
CTR
Autre
Valeur du KPI de l'objectif de la campagne
Oui
float
Oui
Nombre positif pour le KPI de l'objectif de campagne. Pour les KPI "% de vues" et "CTR" de l'objectif de campagne, saisissez la valeur de ce champ en pourcentage (par exemple, saisissez "80" pour 80 %). Pour le KPI "Autre", ce champ contient une brève description de l'objectif.
Types de créations
Oui
chaîne, liste
Oui
Liste des types de créations que vous comptez utiliser.
Écran
Vidéo
Audio
Budget de la campagne
Non
float
Oui
Montant positif du budget de la campagne. Il s'agit toujours d'un float pour un montant monétaire, car il s'agit toujours d'un budget monétaire. Les devises seront affichées dans la devise de l'annonceur en unités standards (et non en 1/1 000 000e d'unité monétaire).
Date de début de la campagne
Oui
chaîne
Oui
Date de début de la campagne au format MM/JJ/AAAA HH:mm
Date de fin de la campagne
Non
chaîne
Oui
Date de fin de la campagne au format MM/JJ/AAAA HH:mm
Fréquence activée
Oui
chaîne
Oui
Active/Désactive la limitation de la fréquence d'exposition basée sur les impressions pour la campagne.
TRUE
FALSE
Expositions à une fréquence
Obligatoire lorsque "Fréquence activée" est défini sur "TRUE"
entier
Oui
Nombre entier positif d'impressions pour une fréquence donnée, c'est-à-dire le x dans "Afficher x impressions sur une période de y".
Période de fréquence
Obligatoire lorsque "Fréquence activée" est défini sur "TRUE"
chaîne
Oui
Spécifie l'unité de période pour la limite de la fréquence d'exposition.
Minutes
Heures
Jours
Semaines
Mois
Montant de la fréquence
Obligatoire lorsque "Fréquence activée" est défini sur "TRUE"
entier
Oui
Nombre entier positif correspondant à la durée de la période de fréquence, c'est-à-dire "y" dans "Afficher x impressions sur une période de y".
Les périodes de fréquence ne doivent pas dépasser 30 jours.
Segments de budget de campagne
Non
chaîne, liste de listes
Oui
Ensemble des segments de budget pour la campagne. Format de la liste : (ID ; Nom ; Type ; Montant ; Date de début ; Date de fin ; Source de budget externe ; ID de budget externe ; ID de regroupement des factures ; Code client Prisma ; Code produit Prisma ; Code d'estimation Prisma ; Type Prisma ; Fournisseur).
Exemple : "(; My Budget; IMPRESSIONS; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; Client; Product; Estimate; DISPLAY; MySupplier;)" où l'ID et la date de fin ne sont pas fournis. Les valeurs acceptables sont indiquées dans le tableau suivant :
Nom de la colonne
Obligatoire
Description
ID
Non
Identifiant unique du segment de budget de la campagne. Cette information doit être fournie lorsque vous modifiez un segment de budget. Si vous ne renseignez pas ce champ, le segment de budget sera considéré comme nouveau.
Nom
Oui
Nom à afficher du segment de budget de campagne.
Type
Oui
Type du montant du budget. Les valeurs acceptées sont les suivantes :
Montant
Impressions
Montant
Oui
Montant positif du budget pour le type de budget. Il peut s'agir d'une simple valeur entière pour les impressions ou d'une valeur à virgule flottante pour un montant monétaire. Les devises seront affichées dans la devise de l'annonceur en unités standards (et non en 1/1 000 000e d'unité monétaire).
Date de début
Non
Code temporel de la date de début de la période de diffusion du segment budgétaire au format MM/JJ/AAAA HH:mm. Une date de début non définie est représentée par une valeur de champ vide.
Date de fin
Non
Code temporel de la date de fin de la période de diffusion du segment budgétaire au format MM/JJ/AAAA HH:mm. Une date de fin non définie est représentée par une valeur de champ vide.
Source de budget externe
Oui
Source du segment de budget. Les valeurs acceptées sont les suivantes :
Aucun
Mediaocean
ID de budget externe
Uniquement pour les segments de budget Mediaocean
Si cette option est définie, toutes les impressions diffusées pour ce segment de budget incluront cet ID sur la facture si le client a activé la facturation au niveau du segment de budget.
ID du groupe de factures
Non
Si cette option est définie, tous les segments de budget ayant le même ID de budget externe et le même ID de regroupement de factures seront regroupés sur une même facture si le client a activé la facturation au niveau des segments de budget.
Code client Prisma
Uniquement pour les segments de budget Mediaocean
Ne peut être défini que pour les segments de budget Mediaocean. Le centre de paiement Google permet de rechercher et de filtrer ce champ.
Code produit Prisma
Uniquement pour les segments de budget Mediaocean
Ne peut être défini que pour les segments de budget Mediaocean. Le centre de paiement Google permet de rechercher et de filtrer ce champ.
Code d'estimation Prisma
Uniquement pour les segments de budget Mediaocean
Ne peut être défini que pour les segments de budget Mediaocean. Le centre de paiement Google permet de rechercher et de filtrer ce champ.
Type Prisma
Uniquement pour les segments de budget Mediaocean
Ne peut être défini que pour les segments de budget Mediaocean. Type Prisma du segment. Les valeurs acceptées sont les suivantes :
Écran
Rechercher
Vidéo
Audio
Réseau social
Fee
Fournisseur Prisma
Uniquement pour les segments de budget Mediaocean
Ne peut être défini que pour les segments de budget Mediaocean. Entité associée à ce budget (DSP, site, etc.)
Ciblage démographique par genre
Non
chaîne, liste
Oui
Liste des genres à cibler. Sélectionnez une ou plusieurs des valeurs acceptables :
Femme
Homme
Inconnu
Âge pour le ciblage démographique
Non
chaîne, liste
Oui
Ciblez une tranche d'âge d'utilisateurs. Spécifiez une plage "de/à" en sélectionnant un seul âge de début et un seul âge de fin, et indiquez si vous souhaitez inclure les âges inconnus (vrai/faux). Consultez la liste des tranches d'âge "De" et "À" acceptables. Exemple 1 : pour cibler les utilisateurs âgés de 18 à 55 ans et inclure les âges inconnus, spécifiez le format {De; À ; Inclure les âges inconnus Vrai/Faux} = 18;55;true; Exemple 2 : pour cibler uniquement les utilisateurs de plus de 35 ans et exclure les âges inconnus, spécifiez la valeur suivante : = 35;+;false;. Valeurs acceptables pour "De" :
18
25
35
45
55
65
Valeurs acceptables pour "À" :
25
35
45
55
65
+
Ciblage démographique : revenus du foyer
Non
chaîne, liste
Oui
Ciblez une plage de revenus du foyer. Spécifiez une plage "de/à" en sélectionnant une seule plage de revenus "Top_of_Range" et une seule plage de revenus "Bottom_of_Range", et en indiquant si vous souhaitez inclure les foyers dont les revenus sont inconnus (true/false). Consultez la liste des plages Top_of_Range/Bottom_of_Range acceptables. Exemple 1 : Pour cibler les 10 % à 50 % des foyers les plus riches et inclure les foyers dont les revenus sont inconnus, spécifiez le format {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true; Exemple 2 : Pour cibler uniquement les 50 % des foyers les plus pauvres et exclure les foyers dont les revenus sont inconnus, spécifiez le format {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true; Valeurs acceptables pour Top_of_Range/Bottom_of_Range :
Les 10 % supérieurs
11 – 20 %
21 – 30 %
31 – 40 %
41 – 50 %
50 % inférieur
Ciblage démographique : statut parental
Oui
chaîne, liste
Oui
Liste des statuts parentaux à cibler. Sélectionnez une ou plusieurs des valeurs acceptables.
Parent
Sans enfant
Inconnu
Ciblage géographique : inclure
Non
chaîne, liste
Oui
Liste des zones géographiques à inclure dans le ciblage.
Cette colonne utilise les ID de ressource TargetingOption de l'API Display & Video 360 pour le type de ciblage TARGETING_TYPE_GEO_REGION.
Format de la liste : (TargetingOption.targetingOptionId ; TargetingOption.targetingOptionId ; etc.). Cette liste est générée par ordre numérique croissant.
Ciblage géographique - Exclure
Non
chaîne, liste
Oui
Liste des zones géographiques à exclure du ciblage.
Cette colonne utilise les ID de ressource TargetingOption de l'API Display & Video 360 pour le type de ciblage TARGETING_TYPE_GEO_REGION.
Format de la liste : (TargetingOption.targetingOptionId ; TargetingOption.targetingOptionId ; etc.). Cette liste est générée par ordre numérique croissant.
Ciblage linguistique : inclure
Non
chaîne, liste
Oui
Liste des langues à inclure dans le ciblage.
Cette colonne utilise les ID de ressource TargetingOption de l'API Display & Video 360 pour le type de ciblage TARGETING_TYPE_LANGUAGE.
Format de la liste : (TargetingOption.targetingOptionId ; TargetingOption.targetingOptionId ; etc.). Cette liste est générée par ordre numérique croissant.
Ciblage linguistique - Exclure
Non
chaîne, liste
Oui
Liste des langues à exclure du ciblage.
Cette colonne utilise les ID de ressource TargetingOption de l'API Display & Video 360 pour le type de ciblage TARGETING_TYPE_LANGUAGE.
Format de la liste : (TargetingOption.targetingOptionId ; TargetingOption.targetingOptionId ; etc.). Cette liste est générée par ordre numérique croissant.
Libellés de contenu numérique : exclure
Non
chaîne, liste
Oui
Liste des libellés de contenu numérique à exclure. Format de la liste : (G;PG; etc.).
G
PG
T
MA
?
Paramètre de sensibilité de brand safety
Non
chaîne
Oui
Choisissez le paramètre de sensibilité pour bloquer l'inventaire en fonction du sujet du contenu environnant.
Ne pas bloquer
Utiliser Campaign Manager 360 Verification
Utiliser les températures personnalisées
Paramètres personnalisés de brand safety
Obligatoire lorsque le paramètre personnalisé de brand safety est défini sur "Utiliser des paramètres personnalisés"
chaîne, liste
Oui
Si le paramètre de sensibilité de brand safety est défini sur "Utiliser des paramètres personnalisés", spécifiez la liste des classificateurs de contenu standards. Par exemple, (Sexual;Alcohol;Tobacco;etc.).
Sexuel
Contenu désobligeant
Téléchargements et partage
Armes
Jeux d'argent et de hasard
Violence
Contenu suggestif
Grossièretés
Alcools
Drogues
Tabac
Politique
Religion
Tragédie
Accidents de transport
Problèmes sociaux sensibles
Contenu choquant
Services de validation tiers
Non
chaîne
Oui
Fournisseur de services de validation tiers.
Aucun
Integral Ad Science
DoubleVerify
Adloox
Libellés de vérification tierce
Non
chaîne, liste
Oui
Si la valeur de "Services de validation tiers" n'est pas "Aucun", spécifiez une liste de libellés compatibles avec le fournisseur sélectionné.
Ciblage en fonction de la visibilité Active View
Non
chaîne
Oui
Ciblez des pourcentages de visibilité prévus. Les pourcentages sont représentés sous forme de valeurs flottantes. L'une des valeurs suivantes : {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Ciblage par position : affichage à l'écran
Non
chaîne, liste
Oui
Ciblage des positions des annonces display à l'écran. Sélectionnez une ou plusieurs des valeurs acceptables :
Partie au-dessus de la ligne de flottaison
Partie en dessous de la ligne de flottaison
Inconnu
Ciblage par position : vidéo à l'écran
Non
chaîne, liste
Oui
Ciblage des positions d'annonces vidéo à l'écran. Sélectionnez une ou plusieurs des valeurs acceptables :
Partie au-dessus de la ligne de flottaison
Partie en dessous de la ligne de flottaison
Inconnu
Ciblage par position : position dans le contenu pour les annonces display
Non
chaîne, liste
Oui
Positions de contenu des annonces display à cibler. Sélectionnez une ou plusieurs des valeurs acceptables :
In-Article
In-Feed
InBanner
Interstitiel
Inconnu
Ciblage par position : position de la vidéo dans le contenu
Non
chaîne, liste
Oui
Positions de contenu d'annonces vidéo à cibler. Sélectionnez une ou plusieurs des valeurs acceptables :
In-Article
In-Feed
InBanner
Interstitiel
OutStream inconnu
Annonce vidéo pré-roll
Mid-roll
Annonce vidéo post-roll
InStream inconnu
Ciblage par sources d'inventaire : options de vendeur autorisé
Obligatoire lorsque le type est "Display", "Vidéo" ou "Audio"
chaîne
Oui
Paramètre permettant de cibler les vendeurs directs autorisés, les vendeurs directs et revendeurs autorisés, ou les vendeurs autorisés et inconnus. "Direct autorisé" signifie que seules les offres des vendeurs autorisés seront ciblées. "Vendeurs directs et revendeurs autorisés" signifie cibler les vendeurs directs et les revendeurs autorisés. "Éditeur autorisé et non participant" signifie que vous ciblerez les vendeurs autorisés, les revendeurs et les vendeurs inconnus.
Vendeurs directs autorisés
Vendeurs directs et revendeurs autorisés
Éditeur autorisé et non participant
Ciblage par sources d'inventaire - Inclure
Non
chaîne, liste
Oui
Liste des sources d'inventaire, des places de marché et des sous-places de marché à inclure dans le ciblage.
Cette colonne utilise les ID de ressources InventorySource de l'API Display & Video 360, les ID de places de marché publiées et les ID de ressources TargetingOption de l'API Display & Video 360 pour le type de ciblage TARGETING_TYPE_SUB_EXCHANGE.
Format de la liste : (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)
Ciblage par sources d'inventaire - Exclure
Non
chaîne, liste
Oui
Liste des sources d'inventaire, des places de marché et des sous-places de marché à exclure du ciblage.
Cette colonne utilise les ID de ressources InventorySource de l'API Display & Video 360, les ID de places de marché publiées et les ID de ressources TargetingOption de l'API Display & Video 360 pour le type de ciblage TARGETING_TYPE_SUB_EXCHANGE.
Format de la liste : (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)
Ciblage par sources d'inventaire - Cibler de nouvelles places de marché
Non
chaîne
Oui
Paramètre permettant de cibler les nouvelles places de marché.
Vrai
Faux
Ciblage par environnement
Non
chaîne, liste
Oui
Liste des environnements à cibler. Sélectionnez une ou plusieurs des valeurs acceptables. Veuillez noter que vous ne pouvez pas sélectionner "Site Web non optimisé" si vous ne sélectionnez pas également "Web".
Web
Site Web non optimisé
Application
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 2026/02/24 (UTC).
[null,null,["Dernière mise à jour le 2026/02/24 (UTC)."],[],[]]