Migration à partir de DT v1.0

Obtenir Files

Le processus d'ingestion pour DTv2 est semblable à celui de DTv1, mais vous devrez modifier certains éléments clés lors de 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 en heure UTC. Les fichiers quotidiens (dont le nom contient AAAAMMJJ) sont traités dans votre fuseau horaire local pour la date et l'heure du reporting voir le format du nom de fichier. Le décalage entre votre heure locale et l'heure UTC varie en fonction de votre position géographique.

Les fichiers sont également traités indépendamment, et leur temps de traitement peut varier. Il est fréquent qu'un fichier d'une heure ultérieure soit traité avant un fichier d'une heure antérieure (par exemple, l'heure 6 avant l'heure 5). Ne vous fiez pas à l'ordre des fichiers pour votre processus d'ingestion, car il pourrait être interrompu.

Les événements peuvent apparaître dans des fichiers traités plus tôt ou plus tard par rapport à leur heure d'événement. Les événements ne sont pas toujours traités au cours de l'heure à laquelle ils se sont produits.

L'ordre des colonnes

Veuillez ne pas vous fier à l'ordre des colonnes pour utiliser vos fichiers. Nous souhaitons que votre traitement soit résistant aux changements. Si vous demandez des colonnes supplémentaires ou si nous apportons des modifications à l'avenir, l'ordre et le nombre de colonnes de vos rapports peuvent changer. Lisez la ligne d'en-tête de chaque fichier et mappez-la aux champs de votre entrepôt de données avant d'essayer d'écrire des données.

Fichiers en double

Il arrive que des fichiers en double soient écrits pour la même date et la même heure. Si plusieurs fichiers ont le même horodatage (date/heure), utilisez celui dont les minutes / secondes sont les plus récentes, en fonction de l'horodatage du nom de fichier. Des fichiers en double sont créés, car les processus de backend ont détecté un problème avec le fichier d'origine.

Champs

Les noms et le format des noms de champs ont tous changé, mais une correspondance entre les anciens et les nouveaux noms (le cas échéant) est disponible dans la section Migration des champs DCM, y compris les tables de correspondance. Si vous n'êtes pas un utilisateur DBM, ces champs seront vides et vous pourrez les ignorer.

Vous pouvez également voir des champs DBM dans votre fichier. Si vous êtes un utilisateur DBM, ces champs ne seront renseignés que lorsque l'autorisation appropriée sera accordée au niveau de l'annonceur DBM auquel les annonceurs sont associés. Une correspondance entre les anciens et les nouveaux champs (le cas échéant) est disponible sur la page Migration des champs DBM. Les fichiers de lecture des entités DBM seront toujours utilisés à des fins de mappage.

Noms de buckets

Les normes de dénomination pour DTv1 et DTv2 sont différentes. Plus précisément, vous ne pouvez pas modifier le préfixe du nom de votre bucket existant pour déterminer le nom du bucket DTv2. Le nom de l'ensemble vous sera fourni par votre représentant de l'assistance lors de la configuration de votre compte.

En général, les noms de buckets DTv2 ressemblent à gs://dcdt_-dcm_account1234.

Vous pouvez consulter le contenu de votre bucket dans un navigateur en accédant à https://cloud.google.com/console#/storage/browser/dcdt_-dcm_account1234.

Format du nom de fichier

Chaque nom de fichier comporte 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 des événements de ce fichier (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 a été généré.
218211994 est l'ID du fichier.

Fichiers d'activité

Vous recevez un fichier d'activité par jour. Le nom de fichier 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é le 28 juillet 2016 à 3:57:50.

Cliquez sur Fichiers.

Vous recevez 24 fichiers "Clics" par jour. Le nom de fichier se présente comme suit :
dcm_account1234_click_2016072717_20160728_012331_268381796.csv.gz
Notez l'heure UTC après la chaîne de date dans le nom de fichier. Les heures sont numérotées de 0 à 23. Par conséquent, un 17 indique que les événements de ce fichier se sont produits entre 17h00 et 17h59.
Ce fichier contient les données de 17h à 18h le 27 juillet 2016 et a été généré le 28 juillet 2016 à 1h23min31s.

Fichiers d'impression

Vous recevez 24 fichiers d'impression par jour. Le nom de fichier se présente comme suit :
dcm_account7312_impression_2016072717_20160728_012355_268381795.csv.gz
À l'exception du nom de fichier, le fonctionnement est identique à celui des fichiers de clics.

Fichiers de tableaux de correspondance

Les fichiers de table de correspondance sont générés une fois par jour. Voici à quoi ressemble leur nom :
dcm_account1234_match_table_activity_cats_20160727_20160728_032226_268648829.csv.gz
Ce fichier contient les données du 27 juillet 2016 et a été généré le 28 juillet 2016 à 3h22min26s.
Remarque : Pour certaines nouvelles tables de correspondance, les données sont statiques et aucun fichier téléchargeable quotidien n'est produit. 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

Nom du champ 1.0 Nom du champ DT v2.0
Temps Obsolète
User-ID ID utilisateur
Référence annonceur Référence annonceur
ID d'achat Obsolète
ID de commande ID de la campagne
Identifiant d'annonce Identifiant de l'annonce
Creative-ID ID de rendu
Creative-Version Version d'annonce
Creative-Size-ID Obsolète (récupéré à partir de la table de correspondance en tant que taille de la création en pixels)
ID du site ID du site (DCM)
ID de page ID d'emplacement
Mot clé Obsolète
Country-ID Code pays
État/Province Région
Indicatif régional Obsolète
Browser-ID ID du navigateur/de la plate-forme
Version du navigateur Version du navigateur/de la plate-forme
OS-ID ID du système d'exploitation
DMA-ID ID de zone de marché désignée
City-ID ID de la ville
Zip-Code Code postal
Time-UTC-Sec Obsolète
Local-User-ID Obsolète
Activity-Type Obsolète (extrait de la table de correspondance "activity_cats")
Sous-type d'activité Obsolète (extrait de la table de correspondance "activity_cats")
Other-Data Autres données
Ordinal Valeur ORD
Heure du clic Durée d'interaction
Event-ID Conversion ID
SV1 Valeur de segment 1
PartnerID1 ID du partenaire 1
PartnerID2 ID du partenaire 2
Quantité Nombre total de conversions
Revenus Revenu total

Noms de fichiers des tables de correspondance

Nom de 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

Faire correspondre les champs des tableaux

activity_cats

Nom du champ 1.0 Nom du champ 2.0 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

Nom du champ 1.0 Nom du champ 2.0 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

Nom du champ 1.0 Nom du champ 2.0 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

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

annonceurs

Nom du champ 1.0 Nom du champ 2.0 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

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

Performance Max

Nom du champ 1.0 Nom du champ 2.0 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

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

pays

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

creatives

Nom du champ 1.0 Nom du champ 2.0 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

Nom du champ 1.0 Nom du champ 2.0 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

Nom du champ 1.0 Nom du champ 2.0 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

Nom du champ 1.0 Nom du champ 2.0 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

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

keyword_values

Nom du champ 1.0 Nom du champ 2.0 Type
Ad-ID Ad ID entier
Keyword-Expression Keyword chaîne
Nom du champ 1.0 Nom du champ 2.0 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

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

emplacements

Nom du champ 1.0 Nom du champ 2.0 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

Nom du champ 1.0 Nom du champ 2.0 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 float
Comments Placement Comments chaîne

sites

Nom du champ 1.0 Nom du champ 2.0 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

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

custom_floodlight_variables

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