Tables privées
Partner
table
Nom du champ | Type | Description |
---|---|---|
common_data | EntityCommonData | Contient les données courantes sur ce partenaire, telles que son nom et son ID. |
currency_code | string | Code 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_costs | PartnerCosts | Contient des informations sur les coûts par défaut de ce partenaire. |
default_partner_revenue_model | PartnerRevenueModel | Inclut des informations sur le modèle de revenus par défaut de ce partenaire. |
default_target_list | TargetList | Inclut les options de ciblage par défaut du partenaire. Actuellement, seul le ciblage géographique par défaut est accepté. |
Advertiser
table
Nom du champ | Type | Description |
---|---|---|
common_data | EntityCommonData | Contient les données courantes sur cet annonceur, comme son nom et son ID. |
partner_id | Numeric Id | ID de l'objet partenaire parent. Peut être joint avec Partner.common_data.id . |
currency_code | string | Code de devise ISO 4217 à trois lettres (par exemple, USD pour le dollar américain) |
timezone_code | string | Code 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_url | string | URL 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_configuration | Enum | 0=NONE |
dcm_network_id | Numeric Id | ID du réseau CM360. Cette valeur sera manquante si dcm_configuration est défini sur NONE . |
dcm_advertiser_id | Numeric Id | ID de l'annonceur CM360. Cette valeur est manquante si dcm_configuration est défini sur NONE . |
dcm_floodlight_group_id | Numeric Id | Cette 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_tags | boolean | Les tags de publicité comportementale en ligne sont activés lorsque ce paramètre est défini sur true . |
Campaign
table
Nom du champ | Type | Description |
---|---|---|
common_data | EntityCommonData | Contient les données courantes sur cette campagne, telles que son nom et son ID. |
advertiser_id | Numeric Id | ID de l'objet annonceur parent. Associable à Advertiser.common_data.id |
budget | Budget | Budget prévu pour cette campagne. Inclut les heures de début et de fin. |
frequency_cap | FrequencyCap | Limite 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_list | TargetList | Contient des informations sur le ciblage en vigueur pour cette campagne. |
uses_video_creatives | boolean | Si cette valeur est définie sur "true", des ordres d'insertion de vidéos seront recommandés. |
uses_display_creatives | boolean | Si cette règle est définie sur "True", les ordres d'insertion de type display sont recommandés. |
uses_audio_creatives | boolean | Si cette règle est définie sur "True", les ordres d'insertion audio sont recommandés. |
objective | Enum |
Les valeurs sont les suivantes:1 = BRAND_AWARENESS 2 = ONLINE_ACTION 3 = OFFLINE_ACTION 4 = APP_INSTALL |
metric | Enum |
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_description | String | Lorsque la métrique est OTHER , il s'agit de la description courte de la métrique. |
metric_amount_micros | integer | Valeur cible de la métrique en micros. |
InsertionOrder
table
Nom du champ | Type | Description |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | Identifiant de l'objet annonceur parent. Peut être jointe avec Advertiser.common_data.id . |
campaign_id | Numeric Id | ID de l'objet de campagne parent. |
overall_budget | Budget | Budget 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_cap | FrequencyCap | Limite 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_costs | PartnerCosts | |
default_target_list | TargetList |
LineItem
table
Nom du champ | Type | Description |
---|---|---|
common_data |
EntityCommonData |
|
line_item_type | Enum |
0=RTB |
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_micros | integer | Valeur du CPM maximal en micro-unités de la devise de l'annonceur. |
performance_goal | Enum | 0=NONE (vCPM est désactivé)1=CPC |
goal_advertiser_micros | integer | L'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_model | PartnerRevenueModel | Modè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. |
Budget | Budget | Budget global pour cet élément de campagne. Inclut l'heure de début et l'heure de fin. |
frequency_cap | FrequencyCap | Limite 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_costs | PartnerCosts | |
target_list | TargetList | Contient des informations sur le ciblage appliqué pour cet élément de campagne. |
Creative
table
Nom du champ | Type | Description |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | ID de l'objet annonceur parent. Peut être joint avec Advertiser.common_data.id . |
dcm_placement_id | Numeric Id | ID de l'emplacement CM360 associé à cette création. |
width_pixels | integer | Largeur de la création en pixels. |
height_pixels | integer | Hauteur 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_direction | Enum | 0=Not Expandable |
creative_type | Enum |
0=Image or HTML5 |
Pixel
table
Nom du champ | Type | Description |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | ID de l'objet annonceur parent. Peut être joint avec Advertiser.common_data.id . |
partner_id | Numeric Id | ID de l'objet partenaire parent. Peut être joint avec Partner.common_data.id . |
dcm_floodlight_id | Numeric Id | ID Floodlight DFA associé à ce pixel. |
allow_google_redirect | boolean | |
allow_rm_redirect | boolean | Si la valeur est true , le pixel est activé pour la redirection vers/de Right Media. |
remarketing_enabled | boolean | Si 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_secure | boolean | Lorsque 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 champ | Type | Description |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | ID de l'objet annonceur parent. Peut être joint avec Advertiser.common_data.id . |
partner_id | Numeric Id | ID de l'objet partenaire gestionnaire de l'annonceur parent. Peut être jointe avec Partner.common_data.id . |
remarketing_enabled | boolean | Si elle est définie sur true , cette activité est activée pour être utilisée dans le ciblage. |
ssl_required | boolean | Lorsque la valeur est true , les balises doivent être conformes. |
InventorySource
table
Nom du champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique de la source d'inventaire. |
unclassified | boolean | Si cette règle est définie sur true , tous les inventaires non classés sont inclus. |
inventory_name | string | Nom 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_id | Numeric Id | ID 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_id | string | ID 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_micros | integer | Prix plancher effectif de cette source d'inventaire en micros de la devise. |
min_cpm_currency_code | string | Code de devise ISO 4217 à trois lettres utilisé pour min_cpm_micros . |
UserList
table
Nom du champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique de la liste des utilisateurs. |
name | string | Nom de la liste des utilisateurs tel qu'il s'affiche dans l'interface utilisateur. |
data_partner_id | Numeric Id | Peut ê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_pricing | UserListPricing | Le 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 champ | Type | Description |
---|---|---|
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 champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique de la chaîne. |
name | string | Nom 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_deleted | boolean | Si 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_channel | boolean | Lorsque 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 champ | Type | Description |
---|---|---|
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 champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique pour la place de marché. |
name | string | Nom de la place de marché, par exemple Ad Exchange . |
DataPartner
table
Nom du champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique du fournisseur de données tiers. |
name | string | Nom du fournisseur de données tiers, par exemple BlueKai . |
UniversalSite
table
Nom du champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique du site universel. |
name | string | URL ou nom du site, par exemple google.com ou Google Unclassified . |
SiteIdToPlacementId
table
Nom du champ | Type | Description |
---|---|---|
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 champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique de la position géographique. |
canonical_name | string | Chaîne de caractères concaténée par des virgules de l'emplacement et de ses parents. Exemple: "Seattle, Washington, États-Unis". |
geo_name | string | Nom de l'établissement. Exemple : "Seattle". |
country_code | string | Code pays ISO 3166-1 alpha-2 pour cette zone géographique (par exemple, US ). |
region_code | string | Code de subdivision ISO-3166-2 pour cette zone géographique (par exemple, US-WA ). Ce champ est peut-être manquant. |
city_name | string | Nom de la ville correspondant à cet emplacement géographique (par exemple, Seattle ). Ce champ est peut-être manquant. |
postal_code | string | Code postal de cette zone géographique (par exemple, 98033 ). Ce champ peut être manquant. |
dma_code | integer | Code de zone de marché désignée pour cette zone géographique (par exemple, 510 ). Ce champ peut être manquant. |
Language
table
Nom du champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique pour cette langue. |
code | string | Code 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 champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique de ces critères d'appareil. |
is_mobile | boolean | Si 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. |
name | string | Nom familier des critères d'appareil. |
criteria_type | Enum | 0=OPERATING_SYSTEM |
operating_system_id | Numeric Id | Identifie le système d'exploitation. Ce champ n'est renseigné que si criteria_type est défini sur 0 . |
mobile_brand_name | string | Nom de la marque de l'appareil. Ce champ n'est renseigné que si criteria_type est défini sur 1 . |
mobile_model_name | string | Nom du modèle de l'appareil. Ce champ n'est renseigné que lorsque criteria_type est défini sur 1 . Facultatif. |
mobile_make_model_id | Numeric Id | Identifie 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_type | Enum | Indique le type d'appareil. Ce champ n'est renseigné que lorsque criteria_type est défini sur 2 .
|
Browser
table
Nom du champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique de ce navigateur. |
is_mobile | boolean | Si 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. |
name | string | Nom familier du navigateur, par exemple Safari 5 . Il n'inclut pas la chaîne complète du user-agent. |
Isp
table
Nom du champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique de ce fournisseur d'accès à Internet. |
is_mobile | boolean | Si 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. |
name | string | Nom de ce fournisseur d'accès à Internet. |
secondary_criteria_id | integer |
ID alternatif facultatif permettant d'identifier l'entité. |
AppCollection
table
Nom du champ | Type | Description |
---|---|---|
id | Numeric Id | Clé unique pour cette collection d'applications. |
name | string | Nom de cette collection d'applications. |