Données structurées - v3.1 - Éléments de campagne

Pour en savoir plus sur ce format, consultez la présentation.

ChampObligatoireTypeAccessible en écritureDescription
ID de l'élément de campagneObligatoire uniquement lors de la modification d'éléments de campagne existantsentierNonIdentifiant numérique de l'élément de campagne. Si vous ne renseignez pas ce champ, un élément de campagne sera créé avec un identifiant unique. Si vous le souhaitez, lorsque vous créez des éléments de campagne, vous pouvez utiliser un identifiant personnalisé afin d'y attribuer des groupes d'annonces TrueView. Les identifiants personnalisés se présentent sous la forme "ext[identifiant personnalisé]". Par exemple : ext123. Une fois le fichier importé et traité, tous les identifiants personnalisés sont remplacés par des ID attribués par DBM. Les objets sont ensuite associés (par exemple, du groupe d'annonces à un élément de campagne) en fonction des identifiants personnalisés.
ID d'ordre d'insertionOuientierNonID numérique de l'ordre d'insertion. Vous pouvez spécifier un identifiant personnalisé (par exemple, "ext[identifiant d'OI personnalisé]") pour un ordre d'insertion que vous créez en même temps que cet élément de campagne.
TypeOuichaîneOuiType d'entrée. n'est accessible en écriture que lors de la création, pas lors de la modification.
  • Display
  • Vidéo
  • TrueView
  • Audio
Sous-typeOuichaîneOuiChamp obligatoire pour les éléments de campagne TrueView afin de faire la distinction entre le format TrueView standard et le format TrueView incitant à installer une application mobile
  • Simple
  • Installation d'applications mobiles
NomOuichaîneOuiNom de l'entrée.
HorodatageObligatoire pour modifier des entrées existantesentierNonLe code temporel de l'entrée, utilisé par le système pour vérifier que l'entrée n'a pas changé entre le téléchargement et l'importation.
ÉtatOuichaîneOuiParamètre d'état de l'entrée.
  • Actif
  • Suspendu
  • Brouillon
  • Archivé
  • Supprimé
Date de débutOuichaîneOuiHorodatage correspondant à la date de début du vol de l'entrée au format MM/JJ/AAAA HH:mm.
Date de finOuichaîneOuiHorodatage de la date de fin de la période de diffusion de l'entrée au format MM/JJ/AAAA HH:mm.
Type de budgetOuichaîneOuiIndique si le budget est basé sur les impressions ou sur une valeur monétaire. Si la répartition automatique du budget est activée pour l'ordre d'insertion de cette entrée, vous pouvez définir cette option sur "Automatique" pour permettre à DBM de définir automatiquement le budget pour cette entrée.
  • Montant
  • Impressions
  • Illimité
  • Automatique
  • Budget quotidien TrueView
Montant du budgetObligatoire si "Type" correspond à "Display" ou "Vidéo" ou "Audio"floatOuiUn montant de budget positif pour le type de budget. Il peut s'agir d'une simple valeur d'impression entière ou d'un nombre flottant pour un montant en devise. Les devises seront affichées dans la devise de l'annonceur en unités standards (et non au 1/1 000 000 d'une unité monétaire). Si "Automatique" est définie au niveau de l'entrée, vous pouvez spécifier un montant minimal à dépenser (par exemple, "dépenser au moins ce montant").
RythmeOuichaîneOuiIl s'agit de la période utilisée pour dépenser le montant correspondant au rythme de diffusion.
  • Tous les jours
  • Tous les mois
  • Vol
Rythme de diffusionOuichaîneOuiTaux de rythme pour cette entrée.
  • Dès que possible
  • Régulière
  • En avant
Montant du rythmeOuifloatOuiMontant à dépenser au cours de la période définie par le type de rythme.
Fréquence activéeOuichaîneOuiActive/Désactive la limitation du nombre d'expositions en fonction des impressions au niveau de l'élément de campagne.
  • TRUE
  • FAUX
Expositions de fréquenceObligatoire si "Fréquence activée" est "TRUE"entierOuiNombre entier positif correspondant au nombre d'impressions dans un nombre d'expositions donné, c'est-à-dire le "x" dans "Afficher x impressions sur une période".
Période d'expositionObligatoire si "Fréquence activée" est "TRUE"chaîneOuiSpécifie l'unité de période pour la limite de la fréquence d'exposition. Pour les éléments de campagne TrueView, les périodes acceptées sont les jours, les semaines et les mois.
  • Minutes
  • Heures
  • Jours
  • Semaines
  • Mois
  • Durée de vie
Nombre d'expositionsObligatoire si "Fréquence activée" est "TRUE"entierOuiNombre entier positif pour la durée correspondant à la période d'exposition, c'est-à-dire le y dans "Afficher x impressions sur y période". Ce montant n'est pas accepté pour les éléments de campagne TrueView.
Fréquence de vue TrueView activéeObligatoire si "Type" correspond à "TrueView"chaîneOuiActive/Désactive la limitation du nombre d'expositions basée sur les vues pour l'élément de campagne TrueView
  • TRUE
  • FAUX
Expositions du nombre d'expositions des vues TrueViewObligatoire si "Fréquence de vue TrueView activée" est "TRUE"entierOuiNombre entier positif correspondant au nombre de vues TrueView, c'est-à-dire le "x" dans "Afficher x vues pendant la période"
Période d'exposition des vues TrueViewObligatoire si "Fréquence de vue TrueView activée" est "TRUE"chaîneOuiSpécifie l'unité de période pour la limite de la fréquence d'exposition basée sur les vues TrueView.
  • Jours
  • Semaines
  • Mois
Modèle de revenus du partenaireOuichaîneOuiLe modèle de revenus du partenaire est le mécanisme de contrôle du calcul des revenus dans Bid Manager. Utilisez le modèle de revenus du partenaire pour suivre la majoration de vos frais de service.
  • TMCM – Majoration du coût médias total
  • MCM – Majoration du coût médias
  • CPM (coût pour mille impressions)
Montant des revenus du partenaireOuifloatOuiValeur flottante positive correspondant au modèle de revenus du partenaire.
Type de comptabilisation des conversionsObligatoire si "Type" correspond à "Display" ou "Vidéo" ou "Audio"chaîneOuiChoisissez les types de conversions à comptabiliser.
  • Tout compter
  • Compter les conversions post-clic
  • Nombre (%)
Nombre de conversions comptabilisées pour la comptabilisation des conversionsObligatoire si "Type" correspond à "Display" ou "Vidéo" ou "Audio"floatOuiSpécifiez le pourcentage pour 'Nombre %' Type de comptabilisation des conversions. Formatez le pourcentage sous forme de nombre décimal (3,123 % = 3,123) avec une précision limitée aux milliers (trois chiffres après la virgule).
ID de pixel de conversionNonchaîne, liste de listesOuiSpécifiez les pixels de conversion sous la forme d'une liste de listes. Chaque pixel est spécifié en tant qu'ID de pixel, fenêtre après affichage (en minutes) et fenêtre post-clic (en minutes). Format de liste = (Pixel.common_data.id; view_window_minutes; click_window_minutes;).
FraisNonchaîne, liste de listesOuiTous les frais pour cette entrée. Format de la liste = (Catégorie des frais ; Montant des frais ; Type de frais ; Facturés ;).
  • Catégorie de frais
    • CPM
    • Multimédia
  • Montant des frais
    • Float
    • Nombre de pixels en tant que valeur flottante
  • Type de frais
    • (chaîne, voir tableau des frais)
  • Facturé
    • Vrai
    • Faux
    • vide

Exemple '(CPM; 2; Frais Bid Manager; False) (Media; 13; Default; True);'
Les valeurs acceptables sont indiquées dans le tableau suivant:

Remarque: Les frais premium liés au CPM sont réservés par le système et ne peuvent pas être modifiés. La cardinalité des frais premium est conservée entre les mutations en insérant des frais associés au CPM par défaut si nécessaire.

Catégorie de fraisType de fraisOption "Facturé"
CPM/MédiasPar défautNon autorisé (laisser vide)
CPM/MédiasAd server tiersNon autorisé (laisser vide)
CPM/MédiasDoubleVerifyAutorisé (vrai/faux)
CPM/MédiasAdSafeNon autorisé (laisser vide)
CPM/MédiasAdXposeNon autorisé (laisser vide)
CPM/MédiasVizuNon autorisé (laisser vide)
CPM/MédiasAggregate KnowledgeNon autorisé (laisser vide)
CPM/MédiasTeracentNon autorisé (laisser vide)
CPM/MédiasEvidonNon autorisé (laisser vide)
CPM/MédiasFrais associés au trading desk de l'agenceNon autorisé (laisser vide)
CPM/MédiasAdlooxAutorisé (vrai/faux)
CPMShopLocalObligatoire (True)
CPMTrustMetricsNon autorisé (laisser vide)
CPMVidéo Integral Ad ScienceAutorisé (vrai/faux)
CPMVidéo MOATNon autorisé (laisser vide)
MultimédiaFrais Bid ManagerObligatoire (True)
MultimédiaDonnées de coût médiasNon autorisé (laisser vide)
CPMFrais premiumNon autorisé (laisser vide)
Code d'intégrationNonchaîneOuiCode facultatif destiné au suivi.
DétailsNonchaîneOuiDétails de l'entrée au format de chaîne.
Type de stratégie d'enchèresObligatoire si "Type" correspond à "Display" ou "Vidéo" ou "Audio"chaîneOui Sélectionnez l'une des stratégies d'enchères applicables:
  • Réduire: tout en dépensant le budget total, réduire le CPA/CPC
  • Maximiser: tout en dépensant le budget total, maximiser la valeur d'impression ou la qualité des impressions
  • Dépasser: atteindre ou dépasser l'objectif de X CPA/CPC
  • Optimiser le vCPM: optimiser pour une enchère au CPM visible de X
  • Fixe: spécifiez une enchère fixe de X.
Valeur de stratégie d'enchèresObligatoire sauf si "Type de stratégie d'enchères" est "Réduire", "Agrandir" ou "Type" correspond à "TrueView"floatOuiPour les types de stratégies "Baat", "Optimiser le vCPM" et "Fixe", choisissez une valeur pour l'enchère de l'objectif.
Notez qu'aucune valeur de stratégie d'enchères n'est requise pour le type de stratégie d'enchères "Réduire". ou "Agrandir"
Unité de stratégie d'enchèresObligatoire si "Type de stratégie d'enchères" est "Beat" ,"Réduire" ou "Agrandir"chaîneOuiPour les types de stratégie "Balayage", "Réduire" ou "Maximiser", sélectionnez l'unité correspondante:
  • CPA
  • CPC
  • valeur/coût impressions personnalisées
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • INCREMENTAL_CONVERSIONS
Stratégie d'enchères "Ne pas dépasser"Obligatoire si "Type" correspond à "Display" ou "Vidéo" ou "Audio"floatOuiDéfinir une règle "Ne pas dépasser" du CPM. Si 0, "ne pas dépasser" n'est pas activée. Cette option n'est disponible que si la stratégie d'enchères est définie sur "Réduire", "Agrandir". ou « Beat ».
Attributions des créationsNonchaîne, listeOuiListe des ID de création à attribuer à l'entrée. Format de la liste = (Creative.common_data.id;Creative.common_data_id;etc.).
Ciblage géographique - InclureNonchaîne, listeOuiListe des zones géographiques à inclure dans le ciblage. Format de la liste = (GeoLocation.id; GeoLocation.id;etc.).
Ciblage géographique - ExclureNonchaîne, listeOuiListe des zones géographiques à exclure du ciblage. Format de la liste = (GeoLocation.id;GeoLocation.id; etc.).
Ciblage linguistique - InclureNonchaîne, listeOuiListe des langues à inclure dans le ciblage. Format de la liste = (Language.id;Language.id;etc.).
Ciblage linguistique - ExclureNonchaîne, listeOuiListe des langues à exclure du ciblage. Format de la liste = (Language.id;Language.id;etc.).
Ciblage par types d'appareil – InclureNonchaîne, listeOuiListe des appareils à inclure dans le ciblage. Format de la liste = (DeviceCritères.id;DeviceCritères.id;etc.).
Ciblage par types d'appareil - ExclureNonchaîne, listeOuiListe des appareils à exclure du ciblage. Format de la liste = (DeviceCritères.id;DeviceCritères.id;etc.).
Ciblage par navigateur - InclureNonchaîne, listeOuiListe des navigateurs à inclure dans le ciblage. Format de la liste = (Browser.id;Browser.id;etc.).
Ciblage par navigateur - ExclureNonchaîne, listeOuiListe des navigateurs à exclure du ciblage. Format de la liste = (Browser.id;Browser.id;etc.).
Libellés de brand safetyNonchaîne, listeOuiListe des libellés de contenu numérique à cibler. Format de la liste = (G;PG; etc.).
  • G
  • PG
  • T
  • MA
  • ?
Paramètre de sensibilité pour la brand safetyNonchaîneOuiSélectionnez le paramètre de sensibilité pour bloquer l'inventaire en fonction du thème du contenu environnant.
  • Ne pas bloquer
  • Utiliser DoubleClick Verification
  • Utiliser une configuration personnalisée
Paramètres personnalisés de brand safetyObligatoire si "Paramètre personnalisé de brand safety" est "Utiliser un modèle personnalisé"chaîne, listeOuiSi le paramètre de sensibilité pour la brand safety est défini sur "Utiliser un paramètre personnalisé", spécifiez la liste des classificateurs de contenu standards. Exemple : (Adulte;Alcool;Tabac;etc.).
  • Adulte
  • Contenu désobligeant
  • Téléchargements et Partage en cours
  • 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 tiersNonchaîneOuiFournisseur de services de validation tiers.
  • Aucun
  • Integral Ad Science
  • DoubleVerify
  • Adloox
Libellés de validation tiersNonchaîne, listeOuiSi l'option "Services de validation tiers" n'est pas définie sur "Aucun", spécifiez une liste de libellés acceptés par le fournisseur sélectionné.
Ciblage de la chaîne - InclureNonchaîne, listeOuiListe des canaux à inclure dans le ciblage. Format de la liste = (UniversalChannel.id;UniversalChannel.id; etc.).
Ciblage de catégories - ExclureNonchaîne, listeOuiListe des canaux à inclure dans le ciblage. Format de la liste = (UniversalChannel.id;UniversalChannel.id; etc.).
Ciblage par sites - InclureNonchaîne, listeOuiListe des sites à inclure dans le ciblage. Cette liste peut inclure un ensemble d'ID de sites ou de chaînes d'URL, si celles-ci ne figurent pas dans le tableau "Site universel". Format de la liste = (UniversalSite.Id;'http://uneurl.com';etc.).
Ciblage par sites - ExclureNonchaîne, listeOuiListe des sites à exclure du ciblage. Cette liste peut inclure un ensemble d'ID de sites ou de chaînes d'URL, si celles-ci ne figurent pas dans le tableau "Site universel". Format de la liste = (UniversalSite.Id;'http://uneurl.com';etc.).
Ciblage des applications - InclureNonchaîne, listeOuiListe des applications à inclure dans le ciblage. Cette liste peut inclure un ensemble d'ID UniversalSite ou de chaînes de packages d'applications, s'ils ne figurent pas dans le tableau "UniversalSite". Format de la liste = (UniversalSite.Id; 'some.app.package';etc.).
Ciblage des applications – ExclureNonchaîne, listeOuiListe des applications à exclure du ciblage. Cette liste peut inclure un ensemble d'ID UniversalSite ou de chaînes de packages d'applications, s'ils ne figurent pas dans le tableau "UniversalSite". Format de la liste = (UniversalSite.Id; 'some.app.package';etc.).
Ciblage par catégorie – InclureNonchaîne, listeOuiListe des catégories à inclure dans le ciblage, à partir des ID de secteurs AdX. Format de la liste = (Verticals.Id;Verticals.Id; etc.).
Ciblage par catégorie - ExclureNonchaîne, listeOuiListe des catégories à exclure du ciblage, issues des ID de secteurs AdX. Format de la liste = (Verticals.Id;Verticals.Id; etc.).
Ciblage par mots clés - InclureNonchaîne, listeOuiListe de chaînes de mots clés à inclure dans le ciblage.
Ciblage par mots clés – ExclureNonchaîne, listeOuiListe de chaînes de mots clés à exclure du ciblage.
Ciblage d'audience - Audiences similairesObligatoire si "Type" correspond à "Display" ou "Vidéo" ou "Audio"chaîneOui Activez les audiences similaires pour les listes propriétaires ciblées positivement.
  • TRUE
  • FAUX
Ciblage d'audience - InclureNonchaîne, liste de pairesOuiListe des listes d'audience à inclure dans le ciblage. Pour les listes d'audience propriétaires, chaque audience est indiquée sous la forme d'une paire ID de liste utilisateur et paramètre de récence. Une paire est (1;1d;), où 1d est un exemple de récence représentant 1 jour de récence. La récence n'est pas disponible pour les audiences tierces. Le format de liste est donc (3;);(4;);. À "AND" et "OU" d'audiences, suivez l'exemple ci-dessous: pour combiner des paires avec et sans récence : ((1;1d;);(2;365d;);((3;);(4;5m;);(5;tous;;)'.

Ciblage d'audience - ExclureNonchaîne, liste de pairesOuiListe des listes d'audience à exclure du ciblage. Si l'audience est une liste d'audience propriétaire, chaque audience est listée sous la forme d'une paire ID de liste d'utilisateurs et d'un paramètre de récence. Une paire est (1;1d;), où 1d est un exemple de récence représentant 1 jour de récence. Toutefois, pour les audiences tierces, la récence n'est pas disponible. Le format de la liste est donc (3;);(4;);. List format= (UserList.id; recency optional;);


Affinité et Ciblage sur le marché – InclureNonchaîne, listeOuiListe des listes d'audiences d'affinité et/ou sur le marché à inclure. List format= ID de liste d'utilisateurs; UserList ID;
Affinité et Ciblage sur le marché - ExclureNonchaîne, listeOuiListe des listes d'audiences d'affinité et/ou sur le marché à exclure. List format= ID de liste d'utilisateurs; UserList ID;
Ciblage par affinité personnaliséeNonchaîne, listeOuiListe de listes personnalisées à cibler. List format= ID de liste d'utilisateurs; UserList ID;
Ciblage par sources d'inventaire – InclureObligatoire si "Type" correspond à "Display" ou "Vidéo" ou "Audio"chaîne, listeOuiListe des inventaires à inclure dans le ciblage. Format de la liste = (InventorySource.id; InventorySource.id;).
Ciblage par sources d'inventaire - ExclureNonchaîne, listeOuiListe des inventaires à exclure du ciblage. Format de la liste = (InventorySource.id; InventorySource.id;).
Ciblage par tranche horaireNonchaîne, listeOuiListe d'ID








un entier compris entre 0 et 95, qui représente des créneaux de 15 minutes
commencer < end
Pour les nouvelles entités, les heures seront définies dans le fuseau horaire de vos utilisateurs (par exemple, "Local"). Pour les entités existantes, le fuseau horaire ne sera pas modifié.
Ciblage par environnementObligatoire si "Type" correspond à "Display" ou "Vidéo" ou "Audio"chaîne, listeOuiListe des environnements à cibler. Format de liste = (Web pour ordinateur ; application mobile, etc.).
Pour l'environnement display:
  • Web pour ordinateur
  • Web mobile
  • Application mobile
  • Interstitiel pour application mobile
  • Web pour ordinateur et pour mobile
Pour les vidéos:
  • Vidéo en ligne pour ordinateur
  • Jeu en ligne pour ordinateur
  • Inventaire intégré aux articles Web pour ordinateur
  • In-Feed (Web pour ordinateur)
  • Vidéo en ligne pour mobile
  • Vidéo pour application mobile
  • Interstitiel vidéo pour application mobile
Pour l'audio:
  • Audio Web pour ordinateur
  • Audio pour le Web mobile
  • Audio de l'application mobile
Active View avec ciblage en fonction de la visibilitéNonchaîneOuiCiblez les pourcentages de visibilité prévue. Les pourcentages sont représentés par des flottants. L'une des valeurs suivantes : {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Position de l'annonce pour le ciblage en fonction de la visibilité – InclureNonchaîneOuiCiblez les positions de l'annonce. Sélectionnez une ou aucune des valeurs acceptables:
  • Tous
  • ATF
  • BTF
  • Inconnu
Position de l'annonce avec ciblage en fonction de la visibilité - ExclureNonchaîneOuiExcluez des positions d'annonces dans le ciblage. Sélectionnez une ou aucune des valeurs acceptables:
  • ATF
  • BTF
  • Inconnu
Ciblage par position des annonces vidéoNonchaîne, listeOuiListe des positions d'annonces vidéo à cibler. Sélectionnez une ou plusieurs valeurs acceptées:
  • inconnu
  • Annonce vidéo pré-roll
  • Annonce vidéo mid-roll
  • Post-roll
Ciblage par taille de lecteur vidéoNonchaîne, listeOuiListe des tailles de lecteur d'annonces vidéo à cibler. Sélectionnez une ou plusieurs valeurs acceptées:
  • inconnu
  • modestement
  • L
  • HD
Ciblage démographique par sexeNonchaîne, listeOuiListe des sexes à cibler. Sélectionnez une ou plusieurs valeurs acceptées:
  • Femme
  • Homme
  • Inconnu
Ciblage démographique par tranche d'âgeNonchaîne, listeOuiCibler la tranche d'âge d'un utilisateur Spécifiez une plage "De" ou "À" en sélectionnant un seul âge "À partir de l'âge" et un seul âge "À", puis si vous souhaitez inclure les âges inconnus (vrai ou faux). Consultez la liste des tranches d'âge autorisées.
Exemple 1: Pour cibler les 18-55 ans et inclure des âges inconnus, spécifiez le format {From; À ; Inclure Vrai/Faux inconnu} = 18;55;true;
Exemple 2: pour ne cibler que les utilisateurs de plus de 35 ans et exclure les âges inconnus, spécifiez = 35;+;false;.
Valeurs acceptées pour "De" :
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

Valeurs acceptées pour le destinataire:
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
Ciblage en fonction de la vitesse de la connexionNonchaîneOuiCiblez une vitesse de connexion spécifique. Sélectionnez l'une des valeurs acceptables:
  • Tous
  • 2G
  • 3G
  • DSL
  • 4G
Ciblage par opérateur - InclureNonchaîne, listeOuiListe des FAI ou des opérateurs à cibler. Format de la liste = {ISP.id; ISP.id;}
Ciblage par opérateur - ExclureNonchaîne, listeOuiListe des FAI ou des opérateurs à exclure. Format de la liste = {ISP.id; ISP.id;}
Option d'ajustement des enchères pour mobile TrueViewNonchaîneOuiSoit "Augmenter", ou "Diminuer".
  • Augmenter
  • Diminuer
Pourcentage d'ajustement des enchères pour mobile TrueViewNonentierOuiAjustement des enchères pour augmenter vos chances de diffuser vos annonces sur mobile Les ajustements acceptables concernent l'option d'ajustement des enchères "Augmenter" : [0;900%]. et pour "Diminuer" : [0;90%] ou 100%
Ciblage par exclusion de catégories TrueViewNonchaîne, listeOuiListe des catégories à exclure. Format de la liste = Games; Tragédie et conflit etc.
  • Vidéos intégrées
  • Streaming en direct
  • Jeux
  • Événements tragiques et zones de guerre
  • Problèmes sociaux sensibles
  • Familles
  • Toutes les audiences
  • Jeunes adolescents
  • Adolescents
  • Adultes
  • Pas encore évalué
  • Contenu à caractère sexuel
  • Sensationnel et choquant
  • Grossièretés et langage inapproprié
Ciblage par sources d'inventaire TrueViewNonchaîne, listeOuiListes des sources d'inventaire TrueView à inclure
  • Recherche YouTube
  • Vidéos YouTube
  • Partenaires vidéo