Migration à partir de DT v1.0

Récupération des fichiers...

Le processus d'ingestion de DTv2 est semblable à celui de DTv1, mais vous aurez besoin de certains éléments clés. pendant la migration.

Traitement des fichiers...

DTv2 traite les fichiers horaires (impression, clic et rich media) et les fichiers quotidiens (tableaux d'activité et de correspondance). Les fichiers horaires (dont le nom contient AAAAMMJJHH) sont traités à l'heure UTC. Les fichiers quotidiens (dont le nom contient AAAAMMJJ) sont traités selon votre fuseau horaire local du rapport zone voir le format du nom de fichier. Le décalage entre votre heure locale et l'heure UTC varie en fonction de votre emplacement.

Les fichiers sont également traités de manière indépendante, et leur temps de traitement peut varier. Il est courant qu'une pour terminer le traitement avant un fichier antérieur (par exemple, l'heure 6 avant l'heure 5). Ne vous fiez pas à l'ordre des fichiers pour votre processus d'ingestion, sinon celui-ci risque de se bloquer.

Les événements peuvent apparaître dans les fichiers traités précédemment ou ultérieurement en fonction de l'heure de l'événement. Les événements ne sont pas toujours traités dans l'heure à laquelle ils se sont produits.

Ordre des colonnes

Ne vous fiez pas à l'ordre des colonnes pour utiliser vos fichiers. Nous voulons que votre traitement soit résilient au changement, si vous demandez des colonnes supplémentaires ou si nous apportons des modifications par la suite, l'ordre et le nombre de colonnes de vos rapports peuvent changer. Lisez la ligne d'en-tête de chaque fichier et associez-la aux champs de votre entrepôt de données avant d'essayer écrire des données.

Fichiers en double

Parfois, des fichiers en double sont écrits pour la même date et la même heure. Si plusieurs fichiers contiennent le le même horodatage, utilisez celui dont les minutes/secondes sont les plus récentes, en fonction du nom de fichier. du code temporel. Des fichiers en double ont été créés, car les processus backend ont déterminé qu'il y avait un problème avec le fichier d'origine.

Champs

Les noms et le format des noms de champs ont tous changé, mais il existe un mappage entre les anciens et les nouveaux (si disponibles) lors de la migration des champs DCM, y compris les tableaux de correspondance. Si vous n'utilisez pas DBM, ces champs seront vides et vous pourrez ignorer ce champ.

Des champs DBM peuvent également s'afficher dans votre fichier. Si vous utilisez DBM, ces champs ne sont renseignés lorsque l'autorisation correspondante est accordée au niveau de l'annonceur DBM auquel les annonceurs sont associés. Le cas échéant, le système met en correspondance l'ancien et le nouveau (si disponible) lors de la migration des champs DBM. Fichiers de lecture des entités DBM seront toujours utilisés à des fins de mappage.

Noms des buckets

Les normes de dénomination pour DTv1 et DTv2 sont différentes, en particulier, vous ne pouvez pas modifier le préfixe sur le nom du bucket existant pour calculer le nom du bucket DTv2. Le nom du bucket vous sera attribué votre représentant de l'assistance technique une fois votre compte configuré.

Les noms de buckets DTv2 ressemblent généralement à gs://dcdt_-dcm_account1234.

Vous pouvez voir le contenu de votre bucket dans un navigateur en consultant https://cloud.google.com/console#/storage/browser/dcdt_-dcm_account1234

Format du nom de fichier

Chaque nom de fichier est composé d'une chaîne de chiffres, par exemple:
dcm_account1234_impression_2016022601_20160225_234912_218211994.csv.gz
2016022601 est au format AAAAMMJJHH. Il s'agit de l'heure UTC pour les événements (les heures sont numérotées de 0 à 23).
20160225_234912 est au format AAAAMMJJ_HHMMSS. Il s'agit de l'heure à laquelle le rapport générées.
218211994 est l'ID du fichier.

Fichiers d'activité

Vous avez un fichier d'activité par jour et son nom se présente comme suit:
dcm_account1234_activity_20160727_20160728_035750_268669761.csv.gz
Ce fichier contient les données du 27 juillet 2016 et a été généré à 3:57:50 le 28 juillet 2016.

Cliquez sur "Fichiers".

Vous recevez 24 fichiers Click par jour, et le nom du fichier se présente comme suit:
dcm_account1234_click_2016072717_20160728_012331_268381796.csv.gz
Notez l'heure UTC située après la chaîne de date dans le nom du fichier. les heures sont numérotées de 0 à 23, 17 indique que les événements de ce fichier concernent la période allant de 17 h 00 à 17 h 59 (heure 24 heures) ou de 17 h 00 à 18 h 00.
Ce fichier contient les données pour la période allant de 17h à 18h, le 27 juillet 2016, et a été généré à 13h23:31 le 28 juillet 2016.

Fichiers d'impressions

Vous recevez 24 fichiers "Impression" par jour et leur nom se présente comme suit:
dcm_account7312_impression_2016072717_20160728_012355_268381795.csv.gz
Hormis le nom du fichier, le comportement est le même que celui des fichiers de clic.

Fichiers de tableaux de correspondance

Les fichiers des tableaux de correspondance sont générés une fois par jour et leur nom se présente comme suit:
dcm_account1234_match_table_activity_cats_20160727_20160728_032226_268648829.csv.gz
Ce fichier contient les données pour le 27 juillet 2016 et a été généré à 3:22:26 le 28 juillet 2016.
Remarque: Pour certaines nouvelles tables des correspondances, les données sont statiques, et aucun fichier téléchargeable quotidien n'est créé. vous pouvez obtenir les données de ces fichiers à partir des pages de référence, par exemple Types d'événements standards Rich Media

Champs de transfert de données

1.0 Nom du champ Nom du champ DT v2.0
Heure Obsolète
User-ID User-ID
Référence annonceur Référence annonceur
ID d'achat Obsolète
ID de commande ID de la campagne
Identifiant d'annonce Identifiant d'annonce
ID-création ID de rendu
Version de création Version d'annonce
ID-taille-création Obsolète (issu du tableau de correspondance en tant que taille en pixels de la création)
ID du site ID du site (DCM)
ID de page ID d'emplacement
Mot clé Obsolète
ID du pays Code pays
État/Province Région
Indicatif Obsolète
ID du navigateur ID du navigateur/de la plate-forme
Browser-Version Version du navigateur/de la plate-forme
ID-OS ID du système d'exploitation
DMA-ID ID de zone de marché désignée
ID de la ville ID de la ville
Code postal Code postal
Temps-UTC-s Obsolète
ID utilisateur local Obsolète
Type d'activité Obsolète (extrait du tableau de correspondance "activity_cats")
Sous-type d'activité Obsolète (extrait du tableau de correspondance "activity_cats")
Autres données Autres données
Ordinal Valeur ORD
Heure du clic Durée d'interaction
ID de l'événement ID de conversion
SV1 Valeur de segment 1
PartnerID1 ID du partenaire 1
PartnerID2 ID du partenaire 2
Quantité Nombre total de conversions
Revenus Revenu total

Noms des fichiers des tableaux de correspondance

Nom du fichier 1.0 Nom du fichier 2.0
activity_cat activity_cats
activity_type activity_types
ad ads
ad_page_assignments ad_placement_assignments
advertiser advertisers
browser browsers
campaign campaigns
cities cities
countries countries
creative creatives
creative_ad_assignments creative_ad_assignments
custom_creative_fields custom_creative_fields
dartsearch paid_search
designated_market_area designated_market_areas
keyval keyword_values
met_event rich_media_events
operating_system operating_systems
page placements
page_cost/page_flight_cost placement_cost
site sites
states states
user-defined_spot_vars custom_floodlight_variables

Champs du tableau de correspondance

activity_cats

1.0 Nom du champ 2.0 Nom du champ Type
Spot-ID Floodlight Configuration entier
Activity-Type-ID Activity Group ID entier
Activity-Type Activity Type chaîne
Activity-ID Activity ID entier
Activity Sub-Type Activity Sub-Type chaîne
Report-Name Activity chaîne
Tag-Method-ID Tag Counting Method ID entier

activity_types

1.0 Nom du champ 2.0 Nom du champ Type
Spot-ID Floodlight Configuration entier
Activity-Group-ID Activity Group ID entier
Activity-Type Activity Type chaîne
Report-Name Activity Group chaîne

ads

1.0 Nom du champ 2.0 Nom du champ Type
Advertiser-ID Advertiser ID entier
Buy-ID Campaign ID entier
Ad-ID Ad ID entier
Ad-Description Ad chaîne
Click-URL Ad Click URL chaîne
Ad-Type Ad Type chaîne
Creative-Size-ID Creative Pixel Size chaîne
Ad-Comments Ad Comments chaîne

ad_placement_assignments

1.0 Nom du champ 2.0 Nom du champ Type
Ad-ID Ad ID entier
Page-ID Placement ID entier

annonceurs

1.0 Nom du champ 2.0 Nom du champ Type
Spot-ID Floodlight Configuration entier
Advertiser-ID Advertiser ID entier
Advertiser Advertiser chaîne
Advertiser-Group-ID Advertiser Group ID entier
Advertiser-Group Advertiser Group chaîne

navigateurs

1.0 Nom du champ 2.0 Nom du champ Type
Browser-ID Browser/Platform ID entier
Browser Browswer/Platform chaîne

Performance Max

1.0 Nom du champ 2.0 Nom du champ Type
Advertiser-ID Advertiser ID entier

Order-ID (anciennement Buy-ID )

Campaign ID entier
Order (anciennement Buy) Campaign chaîne
Start-Date Campaign Start Date date
End-Date Campaign End Date date
Billing-Invoice-Code Billing Invoice Code chaîne

villes

1.0 Nom du champ 2.0 Nom du champ Type
City-ID City ID entier
City City chaîne
Creative-Library-Enabled Deprecated (now always 1) entier

pays

1.0 Nom du champ 2.0 Nom du champ Type
Country-ID Deprecated entier
Country Deprecated chaîne

annonces

1.0 Nom du champ 2.0 Nom du champ Type
Advertiser-ID Advertiser ID entier
Rendering-ID Rendering ID entier
UI-Creative-ID obsolète entier
Creative Creative chaîne
Last-Modified-Date Creative Last Modified Date date
Creative-Type Creative Type chaîne
Creative-Sub-Type Deprecated chaîne
Creative-Size-ID Creative Pixel Size chaîne
Image-URL Creative Image URL chaîne
Creative-Version Creative Version integer

creative_ad_assignments

1.0 Nom du champ 2.0 Nom du champ Type
Ad-ID Ad ID entier
Creative-ID Creative ID entier
Start-Date Creative Start Date date
End-Date Creative End Date date
Rotation-Type Creative Rotation Type chaîne
Creative-Group-1 Creative Groups 1 chaîne
Creative-Group-2 Creative Groups 2 chaîne
Click-URL Ad Click URL chaîne

custom_creative_fields

1.0 Nom du champ 2.0 Nom du champ Type
Advertiser-ID Advertiser ID entier
Creative-ID Creative ID entier
Custom-Field-Number Creative Custom Field Number entier
Custom-Field-Name Creative Custom Field Name chaîne
Custom-Field-Value Creative Custom Field Value chaîne

custom_rich_media

1.0 Nom du champ 2.0 Nom du champ Type
Advertiser-ID Advertiser ID entier
Met-Event-ID Rich Media Event ID entier
Met-Event-Name Rich Media Event chaîne
Met-Event-Type-ID Rich Media Event Type ID entier
Met-Event-Type-Name Rich Media Event Type chaîne

designated_market_areas

1.0 Nom du champ 2.0 Nom du champ Type
DMA-ID Designated Market Area (DMA) ID entier
DMA Designated Market Area chaîne

keyword_values

1.0 Nom du champ 2.0 Nom du champ Type
Ad-ID Ad ID entier
Keyword-Expression Keyword chaîne
1.0 Nom du champ 2.0 Nom du champ Type
Ad-ID Ad ID entier
Advertiser-ID Advertiser ID entier
Buy-ID Campaign ID entier
DS-Ad-ID Paid Search Ad ID entier
Extended-Keyword-ID Paid Search Keyword ID entier
Keyword-ID Paid Search Legacy Keyword ID entier
DS-Campaign-Name Paid Search Campaign chaîne
KW-Ad-Group-Name Paid Search Ad Group chaîne
Bid-Strategy-Name Paid Search Bid Strategy chaîne
Landing-Page-URL Paid Search Landing Page URL chaîne
Keyword-Name Paid Search Keyword chaîne
Match-Type Paid Search Match Type chaîne

operating_systems

1.0 Nom du champ 2.0 Nom du champ Type
OS-ID Operating System ID entier
OS Operating System chaîne

emplacements

1.0 Nom du champ 2.0 Nom du champ Type
Buy-ID Campaign ID entier
Site-ID Site ID (DCM) entier
Page-ID Placement ID entier
Page Site keyname chaîne
Site-Placement Placement chaîne
Content-Category Content Category chaîne
Strategy Placement Strategy chaîne
Start-Date Placement Start Date date
End-Date Placement End Date date
Group-Type Type de groupe d'emplacements chaîne
Group-Parent-ID ID du package/roadblock entier
Price-Type Placement Cost Structure chaîne
Cap-Cost Placement Cap Cost Option float
CPA-Activity-ID Activity ID entier

placement_cost

1.0 Nom du champ 2.0 Nom du champ Type
Page-ID Placement ID entier
Effective-Date Placement Start Date date
End-Date Placement End Date date
Units Placement Total Booked Units entier
Rate Placement Rate nombre décimal
Comments Placement Comments chaîne

sites

1.0 Nom du champ 2.0 Nom du champ Type
Site-ID Site ID (DCM) entier
Site Site (DCM) chaîne
Directory-Site-ID Site ID (Site Directory) entier
Directory-Site Site (Site Directory) chaîne

états

1.0 Nom du champ 2.0 Nom du champ Type
State/Province State/Region chaîne
State/Province Name State/Region Full Name chaîne

custom_floodlight_variables

1.0 Nom du champ 2.0 Nom du champ Type
Spot-ID Floodlight Configuration ID entier
Variable-ID Floodlight Variable ID chaîne
Variable-Name Floodlight Variable Name chaîne