Format des fichiers de lecture des entités - V2

Types partagés

Ces types définissent les champs imbriqués dans certains tableaux. Ces champs n'ont pas de tableaux propres.

Type : Numeric Id

ScalaireDescription
integerNuméro d'identification numérique utilisé comme identifiant des entités. Les ID ne doivent pas être considérés comme des identifiants universels uniques. Par exemple, il est possible que la même valeur d'ID soit utilisée pour une campagne et pour un pixel.

Type : Enum

ScalaireDescription
integerÉnumération de plusieurs options possibles. Les différentes options sont décrites plus en détail dans le type parent.

Type : Time

ScalaireDescription
integerUn code temporel UNIX en microsecondes (1/1 000 000 de seconde), par exemple 1330403779608570, correspond au mardi 28 février 2012 04:36:19.608570.

Type : Currency Micro

ScalaireDescription
integerMontant spécifique à la devise en micros (1/1 000 000 d'une unité de devise). Par exemple,si la devise est l'euro,75000000 correspond à 75 €, et si la devise est le dollar américain, 250000 correspond à 0, 25 $. Aucune conversion n'est effectuée entre les montants en dollars et les autres devises.

Type : Percentage Milli

ScalaireDescription
integerPourcentage affiché en millis (1/1 000 de pourcent). Par exemple,100 correspond à 0,1%.

Type : FileSummary

Nom du champTypeDescription
namestringNom du fichier (sans le nom du bucket ou du répertoire).
num_recordsintegerNombre d'entités dans le fichier.
versionintegerNuméro de version majeure du fichier. Ce nombre peut changer si de nouvelles versions du format de données des entités sont créées à l'avenir.

Type : EntityCommonData

Nom du champTypeDescription
idNumeric IdIdentifiant unique de chaque type d'entité. Par exemple, pour les entités de type "Partenaire", il s'agit de l'ID du partenaire, pour les annonceurs, de l'ID de l'annonceur, etc.
namestringNom visible dans l'UI de l'entité.
activebooleanÉtat défini par l'utilisateur : il est possible que l'entité ne diffuse pas pour d'autres raisons, par exemple si son budget est épuisé, si sa période de diffusion est en cours, etc.
integration_codestringCode d'intégration défini par l'utilisateur

Type : ExchangeSettings

Nom du champTypeDescription
exchange_idNumeric IdID de la place de marché. Peut être associé à SupportedExchange.id
seat_idstringID de siège pour la place de marché
seat_user_namestringNom de l'utilisateur associé à cet emplacement (applicable uniquement aux emplacements Right Media autres que RTB).

Type : ApprovalStatus

Nom du champTypeDescription
auditorEnum0=DOUBLECLICK_BID_MANAGER
1=DOUBLECLICK_AD_EXCHANGE
2=APPNEXUS
3=APPNEXUS_MICROSOFT
4=RIGHT_MEDIA_NON_RTB
statusEnum0=APPROVED
1=REJECTED
2=PENDING
3=NO_AUDIT
4=UN_AUDITABLE
5=UNKNOWN
6=IN_AUDIT
feedbackstringCommentaires de l'auditeur, qui peuvent contenir des informations supplémentaires telles que les motifs de refus.
sync_timeTimeDernière synchronisation de l'entité avec auditor
external_idNumeric IdN'est renseigné que si auditor est APPNEXUS, APPNEXUS_MICROSOFT ou RIGHT_MEDIA_NON_RTB. Il s'agit de l'ID de l'entité dans l'espace de l'auditeur.

Type : Budget

Nom du champTypeDescription
start_time_usecTimeHeure de début de la période budgétaire.
end_time_usecTimeHeure de fin de la période budgétaire.
max_impressionsintegerNombre maximal d'impressions pour ce budget. Si ce champ est manquant, il s'agit d'un budget d'impressions illimité.
max_spend_advertiser_microsintegerDépenses maximales pour ce budget (en microsecondes dans la devise de l'annonceur). Si ce champ est manquant, il s'agit d'un budget de dépenses illimité.
pacing_typeEnum0=FLIGHT
1=DAILY
pacing_max_impressionsintegerNombre maximal d'impressions par intervalle de pacing défini par pacing_type. Si ce champ n'est pas renseigné, le nombre d'impressions n'est pas limité.
pacing_max_spend_advertiser_microsintegerDépense maximale (en micros de la devise de l'annonceur) par intervalle de pacing défini par pacing_type. Si ce champ n'est pas renseigné, aucune limite de dépenses n'est appliquée.
pacing_distributionEnum0=ASAP
1=EVEN
2=AHEAD

Type : FrequencyCap

Nom du champTypeDescription
max_impressionsintegerNombre maximal d'impressions dans chaque intervalle de plafonnement.
time_unitEnumUnité de temps:
0=MINUTE
1=HOUR
2=DAY
3=WEEK
4=MONTH
5=LIFE_TIME
time_rangeintegerNombre de time_units. Par exemple, si time_unit est 1, une valeur de 6 pour time_range correspond à 6 heures.

Type : PartnerCosts

Nom du champTypeDescription
cpm_fee_1_advertiser_microsintegerFrais associés au CPM 1 en micros de la devise de l'annonceur.
cpm_fee_2_advertiser_microsintegerFrais CPM 2 en micros de la devise de l'annonceur.
cpm_fee_3_advertiser_microsintegerFrais associés au CPM 3 en micros de la devise de l'annonceur.
cpm_fee_4_advertiser_microsintegerFrais liés au CPM 4 en micro-unités de la devise de l'annonceur
cpm_fee_5_advertiser_microsintegerFrais associés au CPM 5 en micros de la devise de l'annonceur.
media_fee_percent_1_millisintegerFrais média 1 dans Percentage Milli
media_fee_percent_2_millisintegerFrais média 2 en Percentage Milli
media_fee_percent_3_millisintegerFrais média 3 (Percentage Milli)
media_fee_percent_4_millisintegerFrais média 4 à Percentage Milli
media_fee_percent_5_millisintegerFrais média 5 à Percentage Milli
cpm_fee_1_cost_typeEnum0=DEFAULT_COST_TYPE
1=BID_MANAGER_FEE
2=THIRDPARTY_AD_SERVER
3=DOUBLE_VERIFY
4=ADSAFE
5=ADXPOSE
6=VIZU
7=AGGREGATE_KNOWLEDGE
8=TERACENT
9=EVIDON
10=ATD_FEE
11=DMP_FEE
12=INTEGRAL_AD_SCIENCE_PREBID
13=DOUBLE_VERIFY_PREBID
14=SHOP_LOCAL
15=TRUST_METRICS
16=MEDIACOST_DATA
17=INTEGRAL_AD_SCIENCE_VIDEO
18=MOAT_VIDEO
19=NIELSON_OCR
20=COMSCORE_VCE
21=ADLOOX
22=ADLOOX_PREBID
23=EXTRA_XBID_FEE
24=ADLINGO_FEE
25=CUSTOM_FEE_1
26=CUSTOM_FEE_2
27=CUSTOM_FEE_3
28=CUSTOM_FEE_4
29=CUSTOM_FEE_5

ATD_FEE représente les frais associés au trading desk de l'agence.
cpm_fee_2_cost_typeEnumIdentique à cpm_fee_1_cost_type.
cpm_fee_3_cost_typeEnumIdentique à cpm_fee_1_cost_type.
cpm_fee_4_cost_typeEnumIdentique à cpm_fee_1_cost_type.
cpm_fee_5_cost_typeEnumIdentique à cpm_fee_1_cost_type.
media_fee_percent_1_cost_typeEnumIdentique à cpm_fee_1_cost_type.
media_fee_percent_2_cost_typeEnumIdentique à cpm_fee_1_cost_type.
media_fee_percent_3_cost_typeEnumIdentique à cpm_fee_1_cost_type.
media_fee_percent_4_cost_typeEnumIdentique à cpm_fee_1_cost_type.
media_fee_percent_5_cost_typeEnumIdentique à cpm_fee_1_cost_type.
cpm_fee_1_bill_to_typeEnum0=DEFAULT_BILL_TO_TYPE
1=INVITE_MEDIA
2=PARTNER
cpm_fee_2_bill_to_typeEnumIdentiques à cpm_fee_1_bill_to_type.
cpm_fee_3_bill_to_typeEnumIdentiques à cpm_fee_1_bill_to_type.
cpm_fee_4_bill_to_typeEnumIdentiques à cpm_fee_1_bill_to_type.
cpm_fee_5_bill_to_typeEnumIdentiques à cpm_fee_1_bill_to_type.
media_fee_percent_1_bill_to_typeEnumIdentiques à cpm_fee_1_bill_to_type.
media_fee_percent_2_bill_to_typeEnumIdentiques à cpm_fee_1_bill_to_type.
media_fee_percent_3_bill_to_typeEnumIdentiques à cpm_fee_1_bill_to_type.
media_fee_percent_4_bill_to_typeEnumIdentiques à cpm_fee_1_bill_to_type.
media_fee_percent_5_bill_to_typeEnumIdentique à cpm_fee_1_bill_to_type.

Type : PartnerRevenueModel

Nom du champTypeDescription
typeEnum0=CPM
1=MEDIA_COST_MARKUP
2=TOTAL_MEDIA_COST_MARKUP
amount_advertiser_microsintegerMontant des revenus en micro-unités actuelles de l'annonceur. Cette valeur n'est définie que si le type est CPM.
media_cost_markup_percent_millisintegerMajoration en pourcentage des revenus dans Percentage Milli. Cette valeur n'est définie que si le type est MEDIA_COST_MARKUP ou TOTAL_MEDIA_COST_MARKUP.
post_view_conversion_tracking_fractionfloatFraction de conversions après affichage à comptabiliser pour le suivi des conversions. Avec la valeur 0, seules les conversions post-clic sont comptabilisées.Si la valeur est égale à 1, le suivi de toutes les conversions est effectué.

Type : CostTrackingPixel

Nom du champTypeDescription
pixel_idNumeric IdID du pixel de suivi. Notez que deux CostTrackingPixel peuvent partager le même pixel_id, mais avoir des valeurs de période de visionnage ou de clic différentes.

Cette valeur peut être jointe à Pixel.common_data.id.
view_window_minutesintegerNombre de minutes pendant lesquelles rechercher des conversions après affichage.
click_window_minutesintegerNombre de minutes pendant lesquelles rechercher des conversions post-clic.
floodlight_activity_idIdentifiant numériqueID d'activité Floodlight CM Cette valeur peut être jointe à Pixel.dcm_floodlight_id.

Type : Target

Nom du champTypeDescription
criteria_idNumeric IdPeut être joint à une autre table en fonction du type défini dans TargetList. Cette valeur peut être manquante.
parameterstringParamètre supplémentaire dont la définition dépend du type défini dans TargetList. Cette valeur peut être manquante.
excludedbooleanSi la valeur est true, cela signifie que la cible est exclue. Une valeur manquante signifie false.

Type : TargetUnion

Nom du champTypeDescription
union[Target]Tableau de types Target représentant l'union des cibles.
excludedbooleanSi la valeur est true, cela signifie que l'union cible est exclue. Une valeur manquante signifie false.

Type : TargetList

Nom du champTypeDescription
inventory_sources [Target]Tableau de types Target pour les sources d'inventaire. Target.criteria_id peut être joint à InventorySource.id et Target.parameter est défini.
geo_locations [Target] Tableau de types Target pour les zones géographiques. Target.criteria_id peut être joint à GeoLocation.id et Target.parameter est défini.
ad_position Target Target indiquant la position de l'annonce sur la page de l'éditeur. Les valeurs Target.criteria_id sont
0=ALL_POSITIONS
1=ABOVE_THE_FOLD
2=BELOW_THE_FOLD
3=UNKNOWN_POSITION

. Target.parameter n'est pas défini.
net_speed Target Target indiquant la vitesse du réseau.
Les valeurs Target.criteria_id sont les suivantes:
0=ALL_CONNECTION_SPEEDS
1=BROADBAND (2 Mbit/s et plus).
2=DIALUP (56 kbit/s et plus lent)
3=UNKNOWN_CONNECTION_SPEED
4=EDGE (Enhanced Data for GSM Evolution (2G). 57 kbit/s et plus)
5=UMT (Universal Mobile Telecom System (3G). 384 kbit/s et plus)
6=DSL (Digital Subscriber Line. 768 kbit/s et plus).
7=HSDPA (High-Speed Downlink Packet Access (3.5G). 1,8 Mbit/s et plus).

Target.parameter n'est pas défini.
browsers TargetUnion Type TargetUnion pour les navigateurs. Target.criteria_id peut être joint à Browser.id et Target.parameter est indéfini.
device_criteria [Target]Types Array of Target pour les critères d'appareil Target.criteria_id peut être joint à DeviceCriteria.id et Target.parameter est indéfini.
languages TargetUnionTargetUnion : type pour la langue. Target.criteria_id peut être joint à Language.id et Target.parameter est indéfini.
day_parting TargetUnionType TargetUnion pour la répartition sur la journée. Target.criteria_id comporte six chiffres: (TimeZone)(DayOfWeek)(StartTime)(EndTime)

TimeZone:
0=USER
1=EASTERN
2=PACIFIC
3=LONDON
4=COPENHAGEN
5=SYDNEY
6=AUCKLAND
7=HONG_KONG
8=TOKYO
9=CALCUTTA
10=ADVERTISER


DayOfWeek:
0=MONDAY
1=TUESDAY
2=WEDNESDAY
3=THURSDAY
4=FRIDAY
5=SATURDAY
6=SUNDAY


StartTime:
Minutes écoulées depuis minuit, divisées par 15. Valeur comprise entre 0 et 95.

EndTime
:minutes écoulées depuis minuit, divisées par 15. Valeur comprise entre 1 et 96.

Par exemple, une valeur de 200380 signifie du lundi de 00h45 à 20h00, heure du Pacifique.

Target.parameter n'est pas défini.
audience_intersect [TargetUnion]Tableau de types TargetUnion pour l'intersection des audiences, par exemple
[{“union”: [A, B]},
 {“union”: [C, D]},
 {“union”: [E, F],
 “excluded”: true}]
signifie "(A OU B) ET (C OU D) ET NON (E OU F)".

Target.criteria_id peut être joint à UserList.id et Target.parameter correspond à la valeur de récence des pixels en microsecondes. Si cette valeur est manquante, cela signifie que vous ciblez toutes les audiences.
keywords[Target]Tableau de types Target pour les mots clés. Target.criteria_id n'est pas défini et Target.parameter est un seul mot clé.
kct_include_uncrawled_sitesbooleanIndicateur indiquant si les sites Web non indexés doivent être inclus dans le KCT.
page_categories[Target]Tableau de types Target pour les secteurs de pages AdExchange. Target.criteria_id est l'ID numérique d'une verticale et Target.parameter est défini.
universal_channels[Target]Tableau de types Target pour les canaux. Target.criteria_id peut être joint à UniversalChannel.id et Target.parameter n'est pas défini.
sites[Target] Tableau de types Target pour les sites. Target.criteria_id peut être joint à UniversalSite.id ou n'est pas défini si le site ne figure pas dans UniversalSite. Target.parameter est un site tel que google.com, mais qui ne se trouve pas nécessairement dans UniversalSite.
ispsTargetUnionType TargetUnion pour le fournisseur d'accès à Internet. Target.criteria_id peut être joint à ISP.id et Target.parameter est indéfini.

Type : SummaryFile

Nom du champTypeDescription
file[FileSummary]Tableau de zéro ou plusieurs entrées FileSummary. Si ce tableau est vide, cela signifie qu'aucune donnée n'a été générée à cette date.

Type : UserListAdvertiserPricing

Nom du champTypeDescription
pricingUserListPricing
advertiser_idNumeric Id

Type : UserListPricing

Nom du champTypeDescription
cost_typestring
currency_codestringCode de devise ISO 4217 à trois lettres (par exemple, USD pour le dollar américain)
cost_microsCurrency Micro

Tables privées

Partner table

Nom du champTypeDescription
common_dataEntityCommonDataContient les données courantes sur ce partenaire, telles que son nom et son ID.
currency_codestringCode de devise ISO 4217 à trois lettres (par exemple, USD pour le dollar américain)
exchange_settings[ExchangeSettings]Tableau de types ExchangeSettings contenant des informations telles que les ID de siège. Seules les places de marché activées s'affichent.
default_partner_costsPartnerCostsContient des informations sur les coûts par défaut de ce partenaire.
default_partner_revenue_modelPartnerRevenueModelInclut des informations sur le modèle de revenus par défaut de ce partenaire.
default_target_listTargetListInclut les options de ciblage par défaut du partenaire. Actuellement, seul le ciblage géographique par défaut est accepté.

Advertiser table

Nom du champTypeDescription
common_dataEntityCommonDataContient les données courantes sur cet annonceur, comme son nom et son ID.
partner_idNumeric IdID de l'objet partenaire parent. Peut être joint avec Partner.common_data.id.
currency_codestringCode de devise ISO 4217 à trois lettres (par exemple, USD pour le dollar américain)
timezone_codestringCode du fuseau horaire canonique, par exemple "America/Los_Angeles". Si dfa_configuration est défini sur NORMAL ou HYBRID, cette valeur sera identique à celle du fuseau horaire de l'annonceur DFA associé.
landing_page_urlstringURL de la page de destination par défaut.
available_channel_ids[integer]Tableau d'entiers contenant les critères disponibles associés à cet annonceur. Peut être joint avec UniversalChannel.id.
blacklist_channel_id[integer]Tableau d'entiers contenant les catégories de la liste noire pour cet annonceur. Peut être jointe avec UniversalChannel.id.
dcm_configurationEnum0=NONE
1=NORMAL
2=HYBRID
dcm_network_idNumeric IdID du réseau CM360. Cette valeur sera manquante si dcm_configuration est défini sur NONE.
dcm_advertiser_idNumeric IdID de l'annonceur CM360. Cette valeur est manquante si dcm_configuration est défini sur NONE.
dcm_floodlight_group_idNumeric IdCette valeur est manquante si dcm_configuration est défini sur NONE.
dcm_syncable_site_ids[Numeric Id]Tableau des types Numeric Id pour chaque site synchronisable de cet annonceur.
enable_oba_tagsbooleanLes tags de publicité comportementale en ligne sont activés lorsque ce paramètre est défini sur true.

Campaign table

Nom du champTypeDescription
common_dataEntityCommonDataContient les données courantes sur cette campagne, telles que son nom et son ID.
advertiser_idNumeric IdID de l'objet annonceur parent. Associable à Advertiser.common_data.id
budgetBudgetBudget prévu pour cette campagne. Inclut les heures de début et de fin.
frequency_capFrequencyCapLimite de la fréquence d'exposition active pour cette campagne. Cette valeur sera manquante si aucune limite de la fréquence d'exposition n'est définie.
default_target_listTargetListContient des informations sur le ciblage en vigueur pour cette campagne.
uses_video_creativesbooleanSi cette valeur est définie sur "true", des ordres d'insertion de vidéos seront recommandés.
uses_display_creativesbooleanSi cette règle est définie sur "True", les ordres d'insertion de type display sont recommandés.
uses_audio_creativesbooleanSi cette règle est définie sur "True", les ordres d'insertion audio sont recommandés.
objectiveEnum Les valeurs sont les suivantes:
1 = BRAND_AWARENESS
2 = ONLINE_ACTION
3 = OFFLINE_ACTION
4 = APP_INSTALL
metricEnum Indicateur clé de performance. Ce champ permet de suivre la métrique principale que vous utiliserez pour évaluer le succès de votre campagne. Les valeurs possibles sont les suivantes:
1 = IMPRESSIONS
2 = VIEWABLE_IMPRESSIONS
3 = CPM
4 = CPV
5 = UNIQUES
6 = GRP
7 = TRP
8 = VCR
9 = CPA
10 = ROAS
11 = CTR
12 = CPC
13 = CVR
14 = CPI
15 = VIEWABLE_PERCENT
16 = CPIAVC
17 = OTHER
objective_descriptionStringLorsque la métrique est OTHER, il s'agit de la description courte de la métrique.
metric_amount_microsintegerValeur cible de la métrique en micros.

InsertionOrder table

Nom du champTypeDescription
common_dataEntityCommonData
advertiser_idNumeric IdIdentifiant de l'objet annonceur parent. Peut être jointe avec Advertiser.common_data.id.
campaign_idNumeric IdID de l'objet de campagne parent.
overall_budgetBudgetBudget global de cet ordre d'insertion. Inclut l'heure de début et de fin.
scheduled_segments[Budget]Contient tous les segments de budget planifiés. Ce tableau peut être vide ou entièrement absent.
frequency_capFrequencyCapLimite de la fréquence d'exposition active pour cet ordre d'insertion. Cette valeur est manquante si aucun plafond de la fréquence d'exposition n'est défini.
default_partner_costsPartnerCosts
default_target_listTargetList

LineItem table

Nom du champTypeDescription
common_data EntityCommonData
line_item_typeEnum 0=RTB
1=RMX_NON_RTB
2=RTB_EXPANDABLE
3=RTB_MOBILE
4=RTB_VIDEO
5=TRUEVIEW
6=NON_RTB_EXCHANGES
7=RTB_AUDIO
8=GMAIL
9=ADWORDS_UAC
11=OUT_OF_HOME
insertion_order_id Numeric Id ID de l'objet d'ordre d'insertion parent. Peut être joint avec InsertionOrder.common_data.id.
creative_ids[Numeric Id]Tableau des créations attribuées à cet élément de campagne. Peut être jointe avec Creative.common_data.id.
max_cpm_advertiser_microsintegerValeur du CPM maximal en micro-unités de la devise de l'annonceur.
performance_goalEnum0=NONE (vCPM est désactivé)
1=CPC
2=CPA
3=ROI
4=CPCV
5=CPM
6=AVCPM
7=IMP_VALUE_ROAS
8=CIVA
9=IVO_TEN
10=AV_VIEWED
11=INCREMENTAL_CONVERSIONS
goal_advertiser_microsintegerL'objectif vCPM en micro-unités de la devise de l'annonceur. Cette valeur est manquante si performance_goal est défini sur NONE.
partner_revenue_modelPartnerRevenueModelModèle de revenus du partenaire utilisé pour cet élément de campagne.
cost_tracking_pixels[CostTrackingPixel]Tableau de CostTrackingPixels attribués pour suivre cet élément de campagne.
BudgetBudgetBudget global pour cet élément de campagne. Inclut l'heure de début et l'heure de fin.
frequency_capFrequencyCapLimite de la fréquence d'exposition active pour cet élément de campagne. Cette valeur est manquante si aucun plafond de la fréquence d'exposition n'est défini.
partner_costsPartnerCosts
target_listTargetListContient des informations sur le ciblage appliqué pour cet élément de campagne.

Creative table

Nom du champTypeDescription
common_dataEntityCommonData
advertiser_idNumeric IdID de l'objet annonceur parent. Peut être joint avec Advertiser.common_data.id.
dcm_placement_idNumeric IdID de l'emplacement CM360 associé à cette création.
width_pixelsintegerLargeur de la création en pixels.
height_pixelsintegerHauteur de la création en pixels.
approval_status[ApprovalStatus]Tableau contenant des objets ApprovalStatus représentant l'état des créations sur les places de marché qui les approuvent.
expanding_directionEnum0=Not Expandable
1=Expanding Up
2=Expanding Down
3=Expanding Left
4=Expanding Right
5=Expanding Up Left
6=Expanding Up Right
7=Expanding Down Left
8=Expanding Down Right
9=Expanding Up or Down
10=Expanding Left or Right
11=Expanding Any Diagonal
creative_typeEnum 0=Image or HTML5
1=Expandable
2=Video
3=Mobile
4=Native Site
5=Facebook Exchange Page Post (News Feed) Ads
6=Templated App Install Mobile Ads (Banner)
10=Native Site Square
12=Templated App Install Mobile Ads (Interstitial/Video Interstitial)
13=Lightbox
14=Native App Install
15=Native App Install Square
16=Audio
17=Publisher Hosted
18=Native Video
22=Flipbook
23=Templated App Install Video
24=TRACKING

Pixel table

Nom du champTypeDescription
common_dataEntityCommonData
advertiser_idNumeric IdID de l'objet annonceur parent. Peut être joint avec Advertiser.common_data.id.
partner_idNumeric IdID de l'objet partenaire parent. Peut être joint avec Partner.common_data.id.
dcm_floodlight_idNumeric IdID Floodlight DFA associé à ce pixel.
allow_google_redirectboolean
allow_rm_redirectbooleanSi la valeur est true, le pixel est activé pour la redirection vers/de Right Media.
remarketing_enabledbooleanSi la valeur est true, ce pixel sera activé pour le ciblage. Cette valeur n'est présente que si dfa_configuration de l'annonceur parent est défini sur NONE.
is_securebooleanLorsque la valeur est true, ce pixel utilise HTTPS. Cette valeur n'est présente que si dfa_configuration de l'annonceur parent est défini sur NONE.

Floodlight Activity table

Nom du champTypeDescription
common_dataEntityCommonData
advertiser_idNumeric IdID de l'objet annonceur parent. Peut être joint avec Advertiser.common_data.id.
partner_idNumeric IdID de l'objet partenaire gestionnaire de l'annonceur parent. Peut être jointe avec Partner.common_data.id.
remarketing_enabledbooleanSi elle est définie sur true, cette activité est activée pour être utilisée dans le ciblage.
ssl_requiredbooleanLorsque la valeur est true, les balises doivent être conformes.

InventorySource table

Nom du champTypeDescription
idNumeric IdClé unique de la source d'inventaire.
unclassifiedbooleanSi cette règle est définie sur true, tous les inventaires non classés sont inclus.
inventory_namestringNom de la source d'inventaire tel qu'il apparaît dans l'interface utilisateur. Ce champ est peut-être absent. Si la valeur inventory_name est absente et que la valeur unclassified est définie sur "true", cela fait référence à l'inventaire non classé de la place de marché. Si elle est absente et que unclassified est défini sur "false", la source d'inventaire est l'inventaire au niveau de la place de marché.
exchange_idNumeric IdID de la place de marché sur laquelle cette source d'inventaire est disponible. Peut être joint avec SupportedExchange.id.
accessing_advertisers[Numeric Id]Tableau d'ID d'annonceurs, pouvant être joint avec Advertiser.common_data.id, autorisés à utiliser cette source d'inventaire.

Remarque: Si une source d'inventaire est disponible pour TOUS les annonceurs, ce champ ne s'affiche pas.

external_idstringID externe attribué à cette source d'inventaire et défini par la place de marché, généralement appelé ID d'accord ou d'inventaire. Ce champ peut être absent.
min_cpm_microsintegerPrix plancher effectif de cette source d'inventaire en micros de la devise.
min_cpm_currency_codestringCode de devise ISO 4217 à trois lettres utilisé pour min_cpm_micros.

UserList table

Nom du champTypeDescription
idNumeric IdClé unique de la liste des utilisateurs.
namestringNom de la liste des utilisateurs tel qu'il s'affiche dans l'interface utilisateur.
data_partner_idNumeric IdPeut être joint avec DataPartner.id. Ce champ n'est défini que pour les listes d'utilisateurs tierces.
accessing_advertisers[Numeric Id]Tableau d'ID d'annonceurs, pouvant être joint avec Advertiser.common_data.id, autorisés à utiliser cette liste d'utilisateurs.

Remarque: Si une liste d'utilisateurs est disponible pour TOUS les annonceurs, ce champ ne s'affiche pas.

partner_pricingUserListPricingLe type de coût sera toujours "CPM" et le code de devise sera toujours "USD".
advertiser_pricings[UserListAdvertiserPricing]Le type de coût sera toujours "CPM" et le code de devise sera toujours "USD".

CustomAffinity table

Nom du champTypeDescription
id Numeric Id Clé unique de l'affinité personnalisée.
name string Nom de l'affinité personnalisée tel qu'il s'affiche dans l'interface utilisateur.
description string Description de l'affinité personnalisée telle qu'elle s'affiche dans l'UI.
advertiser_id Numeric Id Identifiant de l'objet annonceur parent. Peut être joint avec Advertiser.common_data.id.

UniversalChannel table

Nom du champTypeDescription
idNumeric IdClé unique de la chaîne.
namestringNom du canal tel qu'il apparaît dans l'interface utilisateur.
site_ids [Numeric Id] Tableau contenant les ID des UniversalSite de cette chaîne. Peut être joint avec UniversalSite.id.
accessing_advertisers[Numeric Id]Tableau d'ID d'annonceurs, pouvant être joint avec Advertiser.common_data.id, autorisés à utiliser ce canal.

Remarque: Si une chaîne est disponible pour TOUS les annonceurs, ce champ n'apparaît pas.

is_deletedbooleanSi la valeur est true, aucun nouvel élément de campagne ne pourra cibler ce canal, mais les éléments de campagne existants qui le ciblent déjà continueront de le faire.
is_brand_safe_channelbooleanLorsque la valeur est true, cette catégorie peut être utilisée pour le filtrage de brand safety. Actuellement, true n'est utilisé que pour les quatre niveaux de brand safety intégrés.

NegativeKeywordList table

Nom du champTypeDescription
id Numeric Id Clé unique de la liste de mots clés à exclure.
name string Nom de la liste de mots clés à exclure, tel qu'il s'affiche dans l'interface utilisateur.
advertiser_id Numeric Id ID de l'objet annonceur parent. Peut être joint avec Advertiser.common_data.id.

Tables publiques

SupportedExchange table

Nom du champTypeDescription
idNumeric IdClé unique pour la place de marché.
namestringNom de la place de marché, par exemple Ad Exchange.

DataPartner table

Nom du champTypeDescription
idNumeric IdClé unique du fournisseur de données tiers.
namestringNom du fournisseur de données tiers, par exemple BlueKai.

UniversalSite table

Nom du champTypeDescription
idNumeric IdClé unique du site universel.
namestringURL ou nom du site, par exemple google.com ou Google Unclassified.

SiteIdToPlacementId table

Nom du champTypeDescription
siteId Numeric Id Mappage de l'ID de site universel aux ID d'emplacement Web.
placementId Numeric Id URL ou nom de l'emplacement Web, par exemple google.com ou Google Unclassified.

GeoLocation table

Nom du champTypeDescription
idNumeric IdClé unique de la position géographique.
canonical_namestringChaîne de caractères concaténée par des virgules de l'emplacement et de ses parents. Exemple: "Seattle, Washington, États-Unis".
geo_namestringNom de l'établissement. Exemple : "Seattle".
country_codestringCode pays ISO 3166-1 alpha-2 pour cette zone géographique (par exemple, US).
region_codestringCode de subdivision ISO-3166-2 pour cette zone géographique (par exemple, US-WA). Ce champ est peut-être manquant.
city_namestringNom de la ville correspondant à cet emplacement géographique (par exemple, Seattle). Ce champ est peut-être manquant.
postal_codestringCode postal de cette zone géographique (par exemple, 98033). Ce champ peut être manquant.
dma_codeintegerCode de zone de marché désignée pour cette zone géographique (par exemple, 510). Ce champ peut être manquant.

Language table

Nom du champTypeDescription
idNumeric IdClé unique pour cette langue.
codestringCode ISO 639-1 de cette langue, ou l'un des codes zh_CN pour le chinois (simplifié), zh_TW pour le chinois (traditionnel) ou other pour les autres langues.

DeviceCriteria table

Nom du champTypeDescription
idNumeric IdClé unique de ces critères d'appareil.
is_mobilebooleanSi la valeur est définie sur "true", ce critère ne couvre que les appareils mobiles. Si la valeur est "false", cette entrée ne couvre que les appareils non mobiles, même si son nom (par exemple, "Autre") ne l'indique pas.
namestringNom familier des critères d'appareil.
criteria_typeEnum0=OPERATING_SYSTEM
1=MOBILE_MAKE_MODEL
2=DEVICE_TYPE
operating_system_idNumeric IdIdentifie le système d'exploitation. Ce champ n'est renseigné que si criteria_type est défini sur 0.
mobile_brand_namestringNom de la marque de l'appareil. Ce champ n'est renseigné que si criteria_type est défini sur 1.
mobile_model_namestringNom du modèle de l'appareil. Ce champ n'est renseigné que lorsque criteria_type est défini sur 1. Facultatif.
mobile_make_model_idNumeric IdIdentifie le numéro de modèle de l'appareil. Ce champ n'est renseigné que lorsque criteria_type est défini sur 1. Facultatif.
device_typeEnumIndique le type d'appareil. Ce champ n'est renseigné que lorsque criteria_type est défini sur 2.

0=COMPUTER
1=OTHER
2=SMARTPHONE
3=TABLET
4=SMARTTV
5=CONNECTEDTV
6=SET_TOP_BOX
7=CONNECTEDDEVICE

Browser table

Nom du champTypeDescription
idNumeric IdClé unique de ce navigateur.
is_mobilebooleanSi la valeur est "true", ce critère ne s'applique qu'aux appareils mobiles. Si la valeur est "false", cette entrée ne couvre que les appareils non mobiles, même si son nom (par exemple, "Autre") ne l'indique pas.
namestringNom familier du navigateur, par exemple Safari 5. Il n'inclut pas la chaîne complète du user-agent.

Isp table

Nom du champTypeDescription
idNumeric IdClé unique de ce fournisseur d'accès à Internet.
is_mobilebooleanSi la valeur est définie sur "true", ce critère ne couvre que les appareils mobiles. Si la valeur est "false", cette entrée ne couvre que les appareils non mobiles, même si son nom (par exemple, "Autre") ne l'indique pas.
namestringNom de ce fournisseur d'accès à Internet.
secondary_criteria_idinteger ID alternatif facultatif permettant d'identifier l'entité.

AppCollection table

Nom du champTypeDescription
idNumeric IdClé unique pour cette collection d'applications.
namestringNom de cette collection d'applications.