DT v1.0 からの移行

Files を入手する

DTv2 の取り込みプロセスは DTv1 と似ていますが、移行時に変更する必要がある重要な点がいくつかあります。

ファイルの処理

DTv2 は、1 時間ごとのファイル（インプレッション、クリック、リッチメディア）と 1 日ごとのファイル（アクティビティと照合テーブル）を処理します。1 時間ごとのファイル（ファイル名に YYYYMMDDHH が含まれる）は UTC 時間で処理されます。日次ファイル（ファイル名に YYYYMMDD が含まれる）は、ローカルのレポートの日時で処理されます（ファイル名の形式を参照）。現地時間と UTC のオフセットは、地域によって異なります。

ファイルは個別に処理され、処理時間はファイルによって異なります。後の時間のファイルが、前の時間のファイルよりも先に処理を完了することはよくあります（たとえば、5 時のファイルよりも 6 時のファイルが先に完了する）。取り込みプロセスでファイルの順序に依存しないでください。依存すると、プロセスが停止する可能性があります。

イベントは、イベント時間よりも早く処理されたファイルまたは遅く処理されたファイルに表示されることがあります。イベントは、発生した時間内に必ずしも処理されるとは限りません。

列の順序

ファイルの利用メカニズムとして列の順序に依存しないでください。処理が変更に強いものになるように、追加の列をリクエストした場合や、将来的に変更が行われた場合、レポートの列の順序と数が変わる可能性があります。各ファイルのヘッダー行を読み取り、データ書き込みを試みる前に、データ ウェアハウスのフィールドにマッピングします。

重複するファイル

同じ日付と時刻のファイルが重複して書き込まれることがあります。同じ日付/時刻スタンプを持つファイルが複数ある場合は、ファイル名のタイムスタンプに基づいて、最新の分 / 秒を持つファイルを使用します。バックエンド プロセスで元のファイルに問題があると判断されたため、重複するファイルが作成されます。

フィールド

フィールド名とフィールド名の形式はすべて変更されましたが、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 は YYYYMMDDHH 形式です。これは、そのファイル内のイベントの UTC 時間です（時間は 0 ～ 23 で番号付けされます）。
20160225_234912 は YYYYMMDD_HHMMSS 形式です。これは、レポートが生成された時刻です。
218211994 はファイル ID です。

アクティビティ ファイル

アクティビティ ファイルは 1 日に 1 つ作成され、ファイル名は
dcm_account1234_activity_20160727_20160728_035750_268669761.csv.gz
のようになります。 このファイルには 2016 年 7 月 27 日のデータが含まれており、2016 年 7 月 28 日の 3 時 57 分 50 秒に生成されました。

[ファイル] をクリックします。

1 日に 24 個のクリック ファイルが生成されます。ファイル名は次のようになります。
dcm_account1234_click_2016072717_20160728_012331_268381796.csv.gz
ファイル名の文字列の後に続く UTC 時間に注意してください。時間は 0 ～ 23 の番号で表されます。たとえば、17 は、このファイル内のイベントが 17:00 ～ 17:59（24 時間表記）または午後 5 時～午後 6 時のものであることを示します。
このファイルには、2016 年 7 月 27 日午後 5 時から午後 6 時までのデータが含まれており、2016 年 7 月 28 日午前 1 時 23 分 31 秒に生成されました。

表示回数ファイル

インプレッション ファイルは 1 日に 24 個生成され、ファイル名は
のようになります。 dcm_account7312_impression_2016072717_20160728_012355_268381795.csv.gz
ファイル名以外は、クリック ファイルと同じ動作をします。

マッチテーブル ファイル

マッチ テーブル ファイルは 1 日に 1 回生成され、ファイル名は次のようになります。
dcm_account1234_match_table_activity_cats_20160727_20160728_032226_268648829.csv.gz
このファイルには 2016 年 7 月 27 日のデータが含まれており、2016 年 7 月 28 日の 3 時 22 分 26 秒に生成されました。
注: 一部の新しい照合テーブルではデータが静的で、毎日ダウンロード可能なファイルは生成されません。これらのファイルのデータは、リッチメディアの標準イベントタイプなどのリファレンス ページから取得できます。

データ転送フィールド

1.0 フィールド名 DT v2.0 のフィールド名
時間 非推奨
User-ID ユーザー ID
広告主 ID 広告主 ID
Buy-ID 非推奨
Order-ID キャンペーン ID
広告 ID 広告 ID
Creative-ID レンダリング ID
Creative-Version 広告パターン
Creative-Size-ID 非推奨（クリエイティブのピクセルサイズとして一致テーブルから取得）
Site-ID サイト ID（DCM）
Page-ID プレースメント ID
キーワード 非推奨
Country-ID 国コード
都道府県 都道府県
市外局番 非推奨
Browser-ID ブラウザ / プラットフォーム ID
Browser-Version ブラウザ / プラットフォームのバージョン
OS-ID オペレーティング システム ID
DMA-ID 指定マーケット エリア（DMA）ID
City-ID 都市 ID
Zip-Code 郵便番号
Time-UTC-Sec 非推奨
Local-User-ID 非推奨
Activity-Type 非推奨（'activity_cats' マッチテーブルから取得）
Activity-Sub-Type 非推奨（'activity_cats' マッチテーブルから取得）
Other-Data その他のデータ
序数 ORD 値
クリック回数 接点の時間
Event-ID コンバージョン ID
SV1 セグメント値 1
PartnerID1 パートナー 1 ID
PartnerID2 パートナー 2 ID
数量 （合計コンバージョン数）
収益 Total Revenue

マッチテーブル ファイル名を照合する

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 integer
Activity-Type-ID Activity Group ID integer
Activity-Type Activity Type 文字列
Activity-ID Activity ID 整数
Activity Sub-Type Activity Sub-Type 文字列
Report-Name Activity 文字列
Tag-Method-ID Tag Counting Method ID integer

activity_types

1.0 フィールド名 2.0 フィールド名 タイプ
Spot-ID Floodlight Configuration integer
Activity-Group-ID Activity Group ID integer
Activity-Type Activity Type 文字列
Report-Name Activity Group 文字列

ads

1.0 フィールド名 2.0 フィールド名 タイプ
Advertiser-ID Advertiser ID integer
Buy-ID Campaign ID integer
Ad-ID Ad ID integer
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 integer
Page-ID Placement ID integer

広告主様

1.0 フィールド名 2.0 フィールド名 タイプ
Spot-ID Floodlight Configuration integer
Advertiser-ID Advertiser ID integer
Advertiser Advertiser 文字列
Advertiser-Group-ID Advertiser Group ID 整数
Advertiser-Group Advertiser Group 文字列

ブラウザ

1.0 フィールド名 2.0 フィールド名 タイプ
Browser-ID Browser/Platform ID integer
Browser Browswer/Platform 文字列

キャンペーン

1.0 フィールド名 2.0 フィールド名 タイプ
Advertiser-ID Advertiser ID integer

Order-ID （以前は Buy-ID ）

Campaign ID integer
Order（以前の Buy） Campaign 文字列
Start-Date Campaign Start Date date
End-Date Campaign End Date date
Billing-Invoice-Code Billing Invoice Code 文字列

cities

1.0 フィールド名 2.0 フィールド名 タイプ
City-ID City ID integer
City City 文字列
Creative-Library-Enabled Deprecated (now always 1) integer

実施国数

1.0 フィールド名 2.0 フィールド名 タイプ
Country-ID Deprecated integer
Country Deprecated 文字列

creatives

1.0 フィールド名 2.0 フィールド名 タイプ
Advertiser-ID Advertiser ID integer
Rendering-ID Rendering ID integer
UI-Creative-ID 非推奨 integer
Creative Creative 文字列
Last-Modified-Date Creative Last Modified Date 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 integer
Creative-ID Creative ID integer
Start-Date Creative Start Date date
End-Date Creative End Date 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 integer
Creative-ID Creative ID integer
Custom-Field-Number Creative Custom Field Number integer
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 integer
Met-Event-ID Rich Media Event ID integer
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 integer
DMA Designated Market Area 文字列

keyword_values

1.0 フィールド名 2.0 フィールド名 タイプ
Ad-ID Ad ID integer
Keyword-Expression Keyword 文字列
1.0 フィールド名 2.0 フィールド名 タイプ
Ad-ID Ad ID integer
Advertiser-ID Advertiser ID integer
Buy-ID Campaign ID integer
DS-Ad-ID Paid Search Ad ID integer
Extended-Keyword-ID Paid Search Keyword ID integer
Keyword-ID Paid Search Legacy Keyword ID integer
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 文字列

operating_systems

1.0 フィールド名 2.0 フィールド名 タイプ
OS-ID Operating System ID integer
OS Operating System 文字列

プレースメント

1.0 フィールド名 2.0 フィールド名 タイプ
Buy-ID Campaign ID integer
Site-ID Site ID (DCM) integer
Page-ID Placement ID integer
Page Site keyname 文字列
Site-Placement Placement 文字列
Content-Category Content Category 文字列
Strategy Placement Strategy 文字列
Start-Date Placement Start Date date
End-Date Placement End Date date
Group-Type プレースメント グループ タイプ 文字列
Group-Parent-ID パッケージ/ロードブロッキング ID integer
Price-Type Placement Cost Structure 文字列
Cap-Cost Placement Cap Cost Option float
CPA-Activity-ID Activity ID integer

placement_cost

1.0 フィールド名 2.0 フィールド名 タイプ
Page-ID Placement ID integer
Effective-Date Placement Start Date date
End-Date Placement End Date date
Units Placement Total Booked Units integer
Rate Placement Rate float
Comments Placement Comments 文字列

サイト

1.0 フィールド名 2.0 フィールド名 タイプ
Site-ID Site ID (DCM) integer
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 integer
Variable-ID Floodlight Variable ID 文字列
Variable-Name Floodlight Variable Name 文字列