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

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

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

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

DTv2 обрабатывает почасовые файлы (показы, клики и мультимедийные материалы) и ежедневные файлы (таблицы активности и соответствия). Ежечасные файлы (имя файла содержит ГГГГММДДЧЧ) обрабатываются по времени UTC. Ежедневные файлы (имя файла содержит ГГГГММДД) обрабатываются в часовом поясе вашего местного отчета , см. формат имени файла . Смещение между вашим местным временем и 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 года и был создан в 13:23:31 28 июля 2016 года.

Файлы впечатлений

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

Файлы таблиц совпадений

Файлы таблицы соответствий создаются один раз в день, и имена файлов выглядят следующим образом:
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 пользователя
Идентификатор рекламодателя Идентификатор рекламодателя
Идентификатор покупки Устарело
Идентификатор заказа Идентификатор кампании
Идентификатор объявления Идентификатор объявления
Креативный идентификатор Идентификатор рендеринга
Креативная версия Креативная версия
Идентификатор размера объявления Устарело (получено из таблицы соответствия как размер креативного пикселя)
Идентификатор сайта Идентификатор сайта (DCM)
Идентификатор страницы Идентификатор места размещения
Ключевое слово Устарело
Идентификатор страны Код страны
Штат/Провинция Штат/регион
Код города Устарело
Идентификатор браузера Идентификатор браузера/платформы
Браузерная версия Версия браузера/платформы
OS-ID Идентификатор операционной системы
DMA-ID Идентификатор обозначенной рыночной зоны (DMA)
Город-ID Идентификатор города
Почтовый индекс Почтовый индекс
Время-UTC-сек. Устарело
Локальный идентификатор пользователя Устарело
Тип деятельности Устарело (получено из таблицы соответствий «activity_cats»)
Подтип деятельности Устарело (получено из таблицы соответствий «activity_cats»)
Другие данные Другие данные
Порядковый номер Значение ORD
Время клика Время взаимодействия
Идентификатор события Идентификатор конверсии
СВ1 Значение сегмента 1
PartnerID1 Идентификатор партнера 1
PartnerID2 Идентификатор партнера 2
Количество Всего конверсий
Доход Общий доход

Имена файлов таблицы соответствия

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 целое число

типы активности

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

Creative_ad_assignments

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 нить

custom_rich_media

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 нить

обозначенные_рыночные_области

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 нить