Миграция с DT v1.0

Получение файлов

Процесс загрузки DTv2 аналогичен процессу загрузки DTv1, но в ходе миграции вам потребуется внести некоторые ключевые изменения.

Обработка файлов

DTv2 обрабатывает почасовые файлы (показы, клики и мультимедийный контент) и ежедневные файлы (таблицы активности и соответствия). Почасовые файлы (имя файла содержит YYYYMMDDHH) обрабатываются по времени UTC. Ежедневные файлы (имя файла содержит YYYYMMDD) обрабатываются по вашему местному часовому поясу (см. формат имени файла ). Смещение между вашим местным временем и UTC будет различаться в зависимости от вашего местоположения.

Файлы обрабатываются независимо друг от друга, и время их обработки может варьироваться. Нередко файл, обработанный в более позднее время, завершает обработку раньше, чем файл, обработанный в более раннее время (например, файл, обработанный в 6-м часу, завершает обработку раньше, чем файл, обработанный в 5-м часу). Не полагайтесь на порядок файлов при обработке, иначе процесс может зависнуть.

События могут отображаться в файлах, обработанных ранее или позже относительно времени их возникновения. События не всегда обрабатываются в тот час, в котором они произошли.

Порядок столбцов

Пожалуйста, не полагайтесь на порядок столбцов как на механизм обработки ваших файлов. Мы хотим, чтобы ваша обработка была устойчива к изменениям; если вы запросите дополнительные столбцы или если мы внесем изменения в будущем, порядок и количество столбцов в ваших отчетах могут измениться. Перед попыткой записи данных прочтите строку заголовка каждого файла и сопоставьте ее с полями в вашем хранилище данных.

Дубликаты файлов

Иногда для одной и той же даты и часа создаются дубликаты файлов. Если несколько файлов имеют одинаковую метку даты/часа, используйте тот, у которого указано больше минут/секунд, исходя из метки времени в имени файла. Дубликаты файлов создаются потому, что внутренние процессы определили наличие проблемы с исходным файлом.

Поля

Названия полей и формат их имен изменились, но при миграции полей DCM, включая таблицы соответствия, выполняется сопоставление старых и новых (где это возможно). Если вы не используете DBM, эти поля будут пустыми, и вы можете их игнорировать.

В вашем файле также могут отображаться поля DBM. Если вы являетесь пользователем DBM, эти поля будут заполняться только при наличии соответствующего разрешения на уровне рекламодателя DBM, к которому привязаны рекламодатели. При миграции полей DBM выполняется сопоставление старых и новых полей (где это возможно). Файлы сущностей DBM, считанные с компьютера, по-прежнему будут использоваться для целей сопоставления.

Названия категорий

Стандарты именования для DTv1 и DTv2 различаются, в частности, вы не можете изменить префикс существующего имени корзины, чтобы получить имя корзины DTv2. Имя корзины будет предоставлено вам представителем службы поддержки при настройке вашей учетной записи.

Как правило, имена сегментов DTv2 выглядят следующим образом gs://dcdt_-dcm_account1234

Вы можете просмотреть содержимое своего хранилища в браузере, перейдя по ссылке https://cloud.google.com/console#/storage/browser/dcdt_-dcm_account1234

Формат имени файла

Каждое имя файла будет содержать строку цифр, например:
dcm_account1234_impression_2016022601_20160225_234912_218211994.csv.gz
2016022601 представлено в формате ГГГГММДДХХ. Это время UTC для событий в этом файле (часы пронумерованы от 0 до 23).
20160225_234912 имеет формат ГГГГММДД_ГГММСС. Это время, когда был сгенерирован отчет.
218211994 — это идентификатор файла.

Файлы активности

Вы получаете один файл с данными об активности в день, и имя файла выглядит следующим образом:
dcm_account1234_activity_20160727_20160728_035750_268669761.csv.gz
Этот файл содержит данные за 27 июля 2016 года и был сгенерирован в 3:57:50 28 июля 2016 года.

Нажмите на файлы

Вы получаете двадцать четыре файла Click в день, и имя файла выглядит следующим образом:
dcm_account1234_click_2016072717_20160728_012331_268381796.csv.gz
Обратите внимание на часы UTC после строки даты в имени файла; часы нумеруются от 0 до 23, поэтому число 17 здесь указывает на то, что события в этом файле относятся к периоду с 17:00 до 17:59 (24-часовой формат времени) или с 17:00 до 18:00.
Этот файл содержит данные за период с 17:00 до 18:00 27 июля 2016 года и был сгенерирован в 1:23:31 28 июля 2016 года.

Файлы показов

Вы получаете двадцать четыре файла с результатами показов в день, и имя файла выглядит следующим образом:
dcm_account7312_impression_2016072717_20160728_012355_268381795.csv.gz
За исключением имени файла, это работает так же, как и Click Files.

Файлы таблиц соответствия

Файлы таблиц соответствия генерируются один раз в день, и имена файлов выглядят следующим образом:
dcm_account1234_match_table_activity_cats_20160727_20160728_032226_268648829.csv.gz
Этот файл содержит данные за 27 июля 2016 года и был сгенерирован в 3:22:26 28 июля 2016 года.
Примечание: Для некоторых новых таблиц матчей данные являются статическими, и ежедневный файл для скачивания не создается; данные для этих файлов можно получить на справочных страницах, например, для стандартных типов событий Rich Media .

Поля передачи данных

1.0 название поля Название поля DT v2.0
Время Устаревший
ID пользователя ID пользователя
Идентификатор рекламодателя Идентификатор рекламодателя
Buy-ID Устаревший
Идентификатор заказа Идентификатор кампании
Идентификатор объявления Идентификатор объявления
Creative-ID Идентификатор рендеринга
Креативная версия Креативная версия
Creative-Size-ID Устарело (получено из таблицы соответствия как Creative Pixel Size)
Идентификатор сайта Идентификатор сайта (DCM)
Идентификатор страницы Идентификатор размещения
Ключевое слово Устаревший
Идентификатор страны Код страны
Штат/Провинция Штат/Регион
Код города Устаревший
Browser-ID Идентификатор браузера/платформы
Версия браузера Версия браузера/платформы
OS-ID Идентификатор операционной системы
DMA-ID Идентификатор обозначенной рыночной зоны (DMA ID)
Идентификатор города Идентификатор города
Почтовый индекс Почтовый индекс
Время-UTC-секунды Устаревший
Идентификатор локального пользователя Устаревший
Тип деятельности Устарело (получено из таблицы соответствия 'activity_cats')
Подтип деятельности Устарело (получено из таблицы соответствия 'activity_cats')
Прочие данные Другие данные
Порядковый Значение ORD
Время клика Время взаимодействия
Идентификатор события Идентификатор конверсии
СВ1 Значение сегмента 1
PartnerID1 Идентификатор партнера 1
PartnerID2 Партнер 2 ID
Количество Общее количество конверсий
Доход Общий доход

Названия файлов таблиц соответствия

1.0 имя файла 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

Поля таблицы матчей

activity_cats

1.0 название поля 2.0 название поля Тип
Spot-ID Floodlight Configuration целое число
Activity-Type-ID Activity Group ID целое число
Activity-Type Activity Type нить
Activity-ID Activity ID целое число
Activity Sub-Type Activity Sub-Type нить
Report-Name Activity нить
Tag-Method-ID Tag Counting Method ID целое число

activity_types

1.0 название поля 2.0 название поля Тип
Spot-ID Floodlight Configuration целое число
Activity-Group-ID Activity Group ID целое число
Activity-Type Activity Type нить
Report-Name Activity Group нить

реклама

1.0 название поля 2.0 название поля Тип
Advertiser-ID Advertiser ID целое число
Buy-ID Campaign ID целое число
Ad-ID Ad ID целое число
Ad-Description Ad нить
Click-URL Ad Click URL нить
Ad-Type Ad Type нить
Creative-Size-ID Creative Pixel Size нить
Ad-Comments Ad Comments нить

ad_placement_assignments

1.0 название поля 2.0 название поля Тип
Ad-ID Ad ID целое число
Page-ID Placement ID целое число

рекламодатели

1.0 название поля 2.0 название поля Тип
Spot-ID Floodlight Configuration целое число
Advertiser-ID Advertiser ID целое число
Advertiser Advertiser нить
Advertiser-Group-ID Advertiser Group ID целое число
Advertiser-Group Advertiser Group нить

браузеры

1.0 название поля 2.0 название поля Тип
Browser-ID Browser/Platform ID целое число
Browser Browswer/Platform нить

кампании

1.0 название поля 2.0 название поля Тип
Advertiser-ID Advertiser ID целое число

Order-ID (ранее Buy-ID )

Campaign ID целое число
Order (ранее Buy ) Campaign нить
Start-Date Campaign Start Date дата
End-Date Campaign End Date дата
Billing-Invoice-Code Billing Invoice Code нить

города

1.0 название поля 2.0 название поля Тип
City-ID City ID целое число
City City нить
Creative-Library-Enabled Deprecated (now always 1) целое число

страны

1.0 название поля 2.0 название поля Тип
Country-ID Deprecated целое число
Country Deprecated нить

творческие

1.0 название поля 2.0 название поля Тип
Advertiser-ID Advertiser ID целое число
Rendering-ID Rendering ID целое число
UI-Creative-ID устаревший целое число
Creative Creative нить
Last-Modified-Date Creative Last Modified Date дата
Creative-Type Creative Type нить
Creative-Sub-Type Deprecated нить
Creative-Size-ID Creative Pixel Size нить
Image-URL Creative Image URL нить
Creative-Version Creative Version integer

креативные_рекламные_задания

1.0 название поля 2.0 название поля Тип
Ad-ID Ad ID целое число
Creative-ID Creative ID целое число
Start-Date Creative Start Date дата
End-Date Creative End Date дата
Rotation-Type Creative Rotation Type нить
Creative-Group-1 Creative Groups 1 нить
Creative-Group-2 Creative Groups 2 нить
Click-URL Ad Click URL нить

custom_creative_fields

1.0 название поля 2.0 название поля Тип
Advertiser-ID Advertiser ID целое число
Creative-ID Creative ID целое число
Custom-Field-Number Creative Custom Field Number целое число
Custom-Field-Name Creative Custom Field Name нить
Custom-Field-Value Creative Custom Field Value нить

пользовательские мультимедийные материалы

1.0 название поля 2.0 название поля Тип
Advertiser-ID Advertiser ID целое число
Met-Event-ID Rich Media Event ID целое число
Met-Event-Name Rich Media Event нить
Met-Event-Type-ID Rich Media Event Type ID целое число
Met-Event-Type-Name Rich Media Event Type нить

designated_market_areas

1.0 название поля 2.0 название поля Тип
DMA-ID Designated Market Area (DMA) ID целое число
DMA Designated Market Area нить

значения ключевых слов

1.0 название поля 2.0 название поля Тип
Ad-ID Ad ID целое число
Keyword-Expression Keyword нить
1.0 название поля 2.0 название поля Тип
Ad-ID Ad ID целое число
Advertiser-ID Advertiser ID целое число
Buy-ID Campaign ID целое число
DS-Ad-ID Paid Search Ad ID целое число
Extended-Keyword-ID Paid Search Keyword ID целое число
Keyword-ID Paid Search Legacy Keyword ID целое число
DS-Campaign-Name Paid Search Campaign нить
KW-Ad-Group-Name Paid Search Ad Group нить
Bid-Strategy-Name Paid Search Bid Strategy нить
Landing-Page-URL Paid Search Landing Page URL нить
Keyword-Name Paid Search Keyword нить
Match-Type Paid Search Match Type нить

операционные_системы

1.0 название поля 2.0 название поля Тип
OS-ID Operating System ID целое число
OS Operating System нить

стажировки

1.0 название поля 2.0 название поля Тип
Buy-ID Campaign ID целое число
Site-ID Site ID (DCM) целое число
Page-ID Placement ID целое число
Page Site keyname нить
Site-Placement Placement нить
Content-Category Content Category нить
Strategy Placement Strategy нить
Start-Date Placement Start Date дата
End-Date Placement End Date дата
Group-Type Тип группы размещения нить
Group-Parent-ID Идентификатор пакета/блока дороги целое число
Price-Type Placement Cost Structure нить
Cap-Cost Placement Cap Cost Option плавать
CPA-Activity-ID Activity ID целое число

стоимость размещения

1.0 название поля 2.0 название поля Тип
Page-ID Placement ID целое число
Effective-Date Placement Start Date дата
End-Date Placement End Date дата
Units Placement Total Booked Units целое число
Rate Placement Rate плавать
Comments Placement Comments нить

сайты

1.0 название поля 2.0 название поля Тип
Site-ID Site ID (DCM) целое число
Site Site (DCM) нить
Directory-Site-ID Site ID (Site Directory) целое число
Directory-Site Site (Site Directory) нить

штаты

1.0 название поля 2.0 название поля Тип
State/Province State/Region нить
State/Province Name State/Region Full Name нить

custom_floodlight_variables

1.0 название поля 2.0 название поля Тип
Spot-ID Floodlight Configuration ID целое число
Variable-ID Floodlight Variable ID нить
Variable-Name Floodlight Variable Name нить