Data Transfer v2.0: ファイル形式

すべてのデータ転送ファイルはカンマ区切り値(CSV)形式で保存されます。Data Transfer はカスタマイズ可能なため、以下のフィールドの一部がファイルに含まれない場合があります。

  • ファイルの 1 行目は常に、列名を含むヘッダー行です。
  • 特殊文字を含むフィールドの場合、フィールドの内容は引用符で囲まれます。
  • 欠損値は空白のままになります。
  • 行は並べ替えられません。
  • ディスプレイ &ビデオ 360 のフィールドのマッチテーブルは、エンティティ読み取りファイル形式です。 ディスプレイ &ビデオ 360 のマッチテーブルの詳細
  • DBM 項目が入力されるのは、広告主が DCM と DBM の間でリンクされ、権限が付与されている場合に限られます。 広告主ごとに権限が必要です。すべての新しい広告主をデフォルトで有効にすることをパートナーに許可することもできます。 ディスプレイ&ビデオ 360 で、[広告主(またはパートナー)] > [基本情報] > [CM の設定] に移動し、[ディスプレイ&ビデオ 360 のデータを DCM のデータ転送に含める] を有効にします。

ファイルの命名規則

ファイル名は、dcm ID(account、Floodlight など)、データ転送タイプ(impression、click、activity、rich_media)、処理されたファイルの日時(YYYYMMDDHH)、レポートの生成日(YYYYMMDD)、レポートの生成時間(HHMMSS)、レポートの実行 ID を組み合わせたものです(アンダースコアで区切られます)。

たとえば、アカウントのインプレッション ファイルは dcm_account_XXXX_impression_2015122400_20151225_123000_2413119.csv.gz のようになります。XXXX はアカウント ID を表し、ファイルは 2015 年 12 月 24 日の 0 時間目です。レポートは、12 月 25 日午後 12 時 30 分に実行 ID 2413119 で生成されました。

フィールド タイプ インプレッション クリック アクティビティ リッチメディア 説明
ランディング ページ URL ID 文字列 × × × ランディング ページ URL の一意の ID。landing_page_url マッチテーブルのランディング ページ URL ID と結合します。
参照元 URL 文字列 × × × 広告が表示された URL が含まれます(可能な場合)。空でも、広告サーバーの URL を返す場合もあります。
インプレッション ID 文字列 × インプレッション、クリック、リッチメディア、Data Transfer のファイルデータの結合に使用される一意の ID
アセット ID 長い × × アセットの一意の ID。
アクティブ ビュー: 測定対象のインプレッション 長い × × × インプレッションが視認性の測定対象だったかどうか。インプレッションは、(a)広告のクリエイティブにアクティブ ビュー タグが設定され、かつ(b)インプレッションの発生時にタグが Google マーケティング プラットフォーム サーバーと正常に通信している場合にカウントされます。

詳しくは、アクティブ ビューのヘルプをご覧ください
アクティブ ビュー: 測定可能なインプレッション 長い × × × インプレッションがアクティブ ビューで測定可能だったかどうか
アクティブ ビュー: 視認可能インプレッション 長い × × × インプレッションが視認可能だったかどうか
アクティビティ ID 長い × × × コンバージョン イベントに関連する Floodlight タグの ID
イベント期間 長い 1970-01-01 00:00:00 UTC からの時間(マイクロ秒単位)
イベントタイプ 文字列 × イベントに関する詳細が含まれます。表示イベントとクリック イベントの場合は「VIEW」と「CLICK」ですが、コンバージョン イベントの場合は「CONVERSION」または空白になることがあります。
イベント サブタイプ 文字列 × イベントに関する詳細情報が含まれます。表示イベントとクリック イベントの場合は「VIEW」と「CLICK」ですが、コンバージョン イベントの場合は「POSTVIEW」、「POSTCLICK」、空白にすることもできます。
User ID 文字列 トラッキング ID(ユーザーのブラウザ Cookie やモバイル デバイス ID に基づいて表示されますが、公開されることはありません)。プライバシー上の理由から、このフィールドはゼロで表示される場合があります。
広告主 ID 長い 広告主の一意の ID
キャンペーン ID 長い キャンペーンの一意の ID
Floodlight 設定 長い × × × Floodlight 設定の一意の ID
広告 ID 長い 広告プレースメントの一意の ID
レンダリング ID 長い Data Transfer のクリエイティブの一意の ID。UI-Creative-ID に 対応しない
広告パターン 整数 クリエイティブのバージョン番号
サイト ID(DCM) 長い 広告が表示されたサイトの一意の ID
プレースメント ID 長い 広告が掲載されるサイトページ / プレースメントの一意の ID
Country Code 文字列 char(2) 2 文字の ISO 3166-1 国コード
地方 文字列 ユーザーの州(米国/カナダ)の ID
ブラウザ / プラットフォーム ID 長い ブラウザタイプの ID
ブラウザ / プラットフォームのバージョン 文字列 ブラウザのバージョン
オペレーティング システム ID 長い オペレーティング システムの ID
指定マーケット エリア(DMA)ID 長い × × 指定マーケット エリア ID(米国/カナダ)
都市 ID 長い × × 都市 ID
郵便番号 文字列 × × 郵便番号(米国/カナダ)
その他のデータ 文字列 × × × 他にラベル付けされていないアクティビティ文字列の Key-Value データを保存します。(「src="」、「type="、"cat="、"ord="、"u="、"cost="、"qty="、"tran="、"a="、"b=" 以外のすべての Key-Value)。(「カスタム Floodlight 変数」としてさらに商品の内訳を指定することもできます)。
ORD 値 文字列 × × × 広告主の序数 ID(特定のアクティビティ タイプに関連する場合)。「ord=」Key-Value で渡されます(クライアントの Order-ID をセールスタグに保存するためにも使用されます)。
接点の時間 文字列 × × × アクティビティの関連(一致)クリックまたはインプレッション時刻(1970-01-01 00:00:00 UTC からのマイクロ秒単位)
コンバージョン ID 整数 × × × アクティビティがポストクリック(値 1)またはポスト インプレッション(値 2)として一致したか、不一致(値 0)かを示します
セグメント値 1 長い × × 検索広告 360 のキーワード ID
リッチメディアのイベント ID 長い × × × リッチメディア広告の MET イベント ID。
リッチメディアのイベントタイプ ID 長い × × × リッチメディア イベントタイプの ID。マッチの説明については、マッチテーブルのセクションをご覧ください。この場合は、独自のマッチテーブルを作成する必要があります。
イベント タイマー 二塁打 × × × MET タイマー値(etm= 値)、秒単位
イベント カウンタ 長い × × × MET カウンタ値(ecn= 値)
(合計コンバージョン数) 整数 × × × タイプやカテゴリの追加の値(販売数量など)を格納できます。「qty=」Key-Value を使用して渡されます。
Total Revenue 二塁打 × × × タイプやカテゴリの追加の値を格納できます(例: メガ米ドルでの売上金額)。 1,000,000 を掛けると金額として表示されます。
Partner1 ID 文字列 パートナー 1 の暗号化値
Partner2 ID 文字列 Partner2 の暗号化値
DBM ビューの状態 文字列 × × × タグラッパーが第三者による確認や配信に使用されている場合、ビューの状態は、ディスプレイ &ビデオ 360 でインプレッションが成功したかどうか、対象の広告枠に広告が配信されたかどうか、インプレッションがキャンペーン マネージャーでトラッキングされたかどうかを示します。値が「外部」の場合、ディスプレイ &ビデオ 360 が落札し、パブリッシャー サイトにラップされたタグを返したことを表します。値が「内部」の場合は、広告枠がブランド保護とみなされたために配信された広告を示します。 両方のイベントが発生すると、2 つのインプレッション レコードが作成されます。1 つのインプレッション レコードに「外側」の値があり、「内側」の対応するレコードがない場合、第三者のベリフィケーション サービスが入札後にインプレッションをブロックしたことを意味します。値が「3pas_merged」の場合、ラップされたディスプレイ&ビデオ 360 インプレッションがあり、キャンペーン マネージャーによって正常にトラッキングされていることを意味します。値が「3pas_outer」の場合は、トラッキング ping がキャンペーン マネージャーに送信されたものの、応答がなかったことを意味します。 しかし、ディスプレイ &ビデオ 360 が落札を獲得し、第三者広告サーバーからのクリエイティブの送信がリクエストされました。
DBM オークション ID 文字列 × ビュー、クリック、コンバージョンの各タイプ間でイベントを結合するために使用される文字列(例: ABCDEFGH_abcdefgh-0123456789)。livestream_id の値の順序、構造、意味は想定しないでください。
DBM リクエストの日時 長い × Google が広告リクエストを受信した時刻のマイクロ秒単位(1/1,000,000 秒)の Unix タイムスタンプ。例: 1330403779608570 は、2012 年 2 月 28 日火曜日の 04 時 36 分 19.608570 を表します。この値はビュー全体で一貫していますが、クリックとコンバージョンが一意であるとは限りません。イベントに参加するにはオークション ID を使用してください。
DBM 広告主 ID 長い × イベントに関連する広告主のディスプレイ &ビデオ 360 の数値 ID(例: 164332)
DBM 広告掲載オーダー ID 長い × イベントに関連する広告掲載オーダーのディスプレイ &ビデオ 360 の数値 ID(例: 1079941)
DBM 広告申込情報 ID 長い × イベントに関連する広告申込情報のディスプレイ &ビデオ 360 の数値 ID(例: 1155785)
DBM キャンペーン ID 長い × ディスプレイ &ビデオ 360 キャンペーンの一意の ID
DBM クリエイティブ ID 長い × イベントに関連付けられたクリエイティブのディスプレイ &ビデオ 360 数値 ID(例: 367487)
DBM 入札単価(USD) 長い × 入札単価とは、ファーストプライス オークションでの調整が行われる前に、広告申込情報でインプレッションに割り当てた値です。固定 CPM 広告申込情報の場合、これは入札時点における広告申込情報の固定 CPM です。入札は CPM 値としてエクスチェンジに送信されますが、他の指標との整合性を保つため、入札価格はインプレッション単価で表されます。入札単価はナノ米ドル単位です。入札単価は 1,000,000,000 で割って米ドルで表示できます。
DBM 入札単価(Google Partner の通貨) 長い × 入札単価とは、ファーストプライス オークションでの調整が行われる前に、広告申込情報でインプレッションに割り当てた値です。固定 CPM 広告申込情報の場合、これは入札時点における広告申込情報の固定 CPM です。入札は CPM 値としてエクスチェンジに送信されますが、他の指標との整合性を保つため、入札価格はインプレッション単価で表されます。入札価格はパートナーの通貨ナノ単位です。1,000,000,000 で割ると、実際のパートナー通貨で入札単価を確認できます。
DBM 入札単価(広告主の通貨) 長い × 入札単価とは、ファーストプライス オークションでの調整が行われる前に、広告申込情報でインプレッションに割り当てた値です。固定 CPM 広告申込情報の場合、これは入札時点における広告申込情報の固定 CPM です。入札は CPM 値としてエクスチェンジに送信されますが、他の指標との整合性を保つため、入札価格はインプレッション単価で表されます。入札単価は広告主の通貨のナノ単位です。1,000,000,000 で割ると、実際の広告主の通貨で入札単価を確認できます。
DBM URL 文字列 × エクスチェンジから受信した入札リクエストから取得された未加工の URL(例: http://www.example.com)。一部のエクスチェンジでは入札リクエストの URL がマスクされるため、この値は「source_url_hidden」となる場合があります。
DBM サイト ID 長い × URL と一致する最も限定的なユニバーサル サイトのディスプレイ &ビデオ 360 の数値 ID
DBM 言語 文字列 × ビューイベントに関連する言語を表す ISO-639-1 コード、「zh_CN」(中国語(簡体))、「zh_TW」(中国語(繁体))、または「other」
DBM AdX ページカテゴリ 文字列 × Ad Exchange のページカテゴリ ID をスペースで区切って指定します(「65 189」など)。カテゴリは相互に排他的ではない場合があります。
DBM マッチのターゲット キーワード 文字列 × ビューイベントに関連するページと一致するターゲット キーワードのリストを含むカンマ区切りの文字列(例: "apple,orange,banana")。ビューイベントに関連するページは多くのキーワードに一致する場合がありますが、ターゲティングされたキーワードのみが含まれます。キーワードのリストが大きい場合は、返されるキーワードの数に制限が課されることがあります。
DBM Exchange ID 長い × 広告をリクエストしたエクスチェンジのディスプレイ &ビデオ 360 の数値 ID
DBM 帰属広告枠ソースの外部 ID 文字列 × ディスプレイ &ビデオ 360 で、最小価格とオークション タイプに基づき、視聴イベントに関連付けられた広告主にアクセス可能な広告主から最適なものとして選択された、貢献度が割り当てられた広告在庫ソースの外部 ID。
DBM 帰属広告枠ソースの公開 ブール値 × 広告枠ソースをすべての購入者が使用できる場合は true に設定します。それ以外の場合は False。
DBM 広告掲載順位 長い × ページ上の広告の位置を指定します(既知の場合)。1 はスクロールせずに見える範囲、2 はスクロールしなければ見えない範囲を表します。
DBM 国コード 文字列 × 最も推測されたインプレッションの国を表す 2 文字の ISO 3166-1 国コード(「US」など)
DBM 指定マーケット エリア(DMA)ID 長い × 指定マーケット エリアコードがわかっている場合は(例: 807)
DBM 郵便番号 文字列 × 最も推定されたインプレッションの郵便番号(既知の場合)を識別する郵便番号です(例: 「98033」)。複数の国をまたいだ一意性を前提としない
DBM 都道府県 / 地域 ID 長い × レポートとターゲティングで使用可能な州/地域の整数に一致する整数
DBM 市区町村 ID 長い × 最も推定されたインプレッションの都市を識別するディスプレイ &ビデオ 360 の数値 ID。
DBM オペレーティング システム ID 長い × このイベントに関連するオペレーティング システムを識別するディスプレイ &ビデオ 360 の数値 ID。
DBM ブラウザ / プラットフォーム ID 長い × このイベントに関連するブラウザを識別するディスプレイ &ビデオ 360 の数値 ID。
DBM ブラウザ タイムゾーンの時差(分) 長い × ユーザーのブラウザで有効なタイムゾーンと GMT-12 の差(分単位)。たとえば、1320 はブラウザのタイムゾーンの GMT+10 を表します。
DBM ネットスピード 長い × 視聴イベントに関連するネットワーク速度を表すディスプレイ &ビデオ 360 の数値 ID。
1=ダイヤルアップ
2=EDGE/2G
3=UMTS/3G
4=ベーシック DSL
5=HSDPA/3.5G
6=ブロードバンド/4G
7=不明
DBM マッチのターゲット セグメント 文字列 × 訪問者に一致するターゲット ユーザーリストの名前をスペースで区切って指定します(「-4 456」など)。このイベントに関連付けられた広告でターゲットとされていないユーザーリストに訪問者が含まれている場合、ここには含められません
DBM ISP ID 長い × 最も推測された、インプレッションのインターネット サービス プロバイダのディスプレイ &ビデオ 360 の数値 ID。この値がない可能性があります
DBM デバイスタイプ 長い × 特定されたデバイスタイプの数値。0 = パソコン、1 = その他、2 = スマートフォン、3 = タブレット、4 = スマートテレビ、5 = コネクテッド テレビ
DBM モバイル メーカー ID 長い × モバイル メーカーの数値 ID。この値がない可能性があります
DBM モバイルモデル ID 長い × モバイルモデルの数値 ID。この値がない可能性があります
DBM メディア費用(USD) 長い × インプレッションに対して支払われた金額(ナノ米ドル単位)。1,000,000,000 で割って通貨として表示できます。この値はゼロの場合があります
DBM メディア費用(Partner 使用通貨) 長い × インプレッションに対して支払われた金額(パートナーの通貨ナノ単位)。1,000,000,000 で割って通貨として表示できます。この値はゼロの場合があります
DBM メディア費用(広告主の通貨) 長い × インプレッションに対して支払われた金額(広告主の通貨ナノ単位)。1,000,000,000 で割って通貨として表示できます。この値はゼロの場合があります
DBM 収益(USD) 長い × 視聴イベントに関してパートナー アカウントにより発生した、米ドル(ナノ)単位の合計金額。この値はゼロの場合があります
DBM 収益(Google Partner の通貨) 長い × 視聴イベントに関してパートナー アカウントによって得られた、パートナーの通貨ナノで表した合計金額。この値はゼロの場合があります
DBM 収益(広告主の通貨) 長い × 視聴イベントに関してパートナー アカウントにより得られた、広告主の通貨(ナノ単位)で表した合計金額。この値はゼロの場合があります
DBM 合計メディア費用(USD) 長い × 視聴イベントの合計メディア費用(米ドルナノ単位)。この値はゼロの場合があります
DBM 合計メディア費用(Google Partner の通貨) 長い × 視聴イベントの合計メディア費用(パートナーの通貨ナノ単位)。この値はゼロの場合があります
DBM 合計メディア費用(広告主の通貨) 長い × 視聴イベントの合計メディア費用(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM CPM 料金 1(USD) 整数 × CPM 1 の料金(ナノ米ドル単位)。この値はゼロの場合があります
DBM CPM 料金 1(Google Partner の通貨) 長い × CPM 1 の料金(パートナーの通貨ナノ単位)。この値はゼロの場合があります
DBM CPM 料金 1(広告主の通貨) 長い × CPM 1 の料金(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM CPM 料金 2(USD) 長い × CPM 2 の料金(ナノ米ドル単位)。この値はゼロの場合があります
DBM CPM 料金 2(Google Partner の通貨) 長い × CPM 2 の料金(パートナーの通貨ナノ単位)。この値はゼロの場合があります
DBM CPM 料金 2(広告主の通貨) 長い × CPM 2 の料金(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM CPM 料金 3(USD) 長い × CPM 3 の料金(ナノ米ドル単位)。この値はゼロの場合があります
DBM CPM 料金 3(Google Partner の通貨) 長い × CPM 3 の料金(パートナーの通貨ナノ単位)。この値はゼロの場合があります
DBM CPM 料金 3(広告主の通貨) 長い × CPM 3 の料金(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM CPM 料金 4(USD) 長い × CPM 4 の料金(ナノ米ドル単位)。この値はゼロの場合があります
DBM CPM 料金 4(Google Partner の通貨) 長い × CPM 4 の料金(パートナーの通貨ナノ単位)。この値はゼロの場合があります
DBM CPM 料金 4(広告主の通貨) 長い × CPM 4 の料金(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM CPM 料金 5(USD) 長い × CPM 5 の料金(ナノ米ドル単位)。この値はゼロの場合があります
DBM CPM 料金 5(Google Partner の通貨) 長い × CPM 5 の料金(パートナーの通貨ナノ単位)。この値はゼロの場合があります
DBM CPM 料金 5(広告主の通貨) 長い × CPM 5 の料金(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM メディア料金 1(USD) 長い × メディア料金 1(ナノ米ドル単位)。この値はゼロの場合があります
DBM メディア料金 1(Google Partner の通貨) 長い × メディア料金 1(パートナー通貨のナノ単位)。この値はゼロの場合があります
DBM メディア料金 1(広告主の通貨) 長い × メディア料金 1(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM メディア料金 2(USD) 長い × メディア料金 2(ナノ米ドル単位)。この値はゼロの場合があります
DBM メディア料金 2(Google Partner の通貨) 長い × メディア料金 2(パートナーの通貨ナノ単位)。この値はゼロの場合があります
DBM メディア料金 2(広告主の通貨) 長い × メディア料金 2(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM メディア料金 3(USD) 長い × メディア料金 3(ナノ米ドル単位)。この値はゼロの場合があります
DBM メディア料金 3(Google Partner の通貨) 長い × メディア料金 3(パートナー通貨のナノ単位)。この値はゼロの場合があります
DBM メディア料金 3(広告主の通貨) 長い × メディア料金 3(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM メディア料金 4(USD) 長い × メディア料金 4(ナノ米ドル単位)。この値はゼロの場合があります
DBM メディア料金 4(Google Partner の通貨) 長い × メディア料金 4(パートナーの通貨ナノ単位)。この値はゼロの場合があります
DBM メディア料金 4(広告主の通貨) 長い × メディア料金 4(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM メディア料金 5(USD) 長い × メディア料金 5(ナノ米ドル単位)。この値はゼロの場合があります
DBM メディア料金 5(Google Partner の通貨) 長い × メディア料金 5(パートナーの通貨ナノ単位)。この値はゼロの場合があります
DBM メディア料金 5(広告主の通貨) 長い × メディア料金 5(広告主の通貨のナノ単位)。この値はゼロの場合があります
DBM データ料金(USD) 長い × このインプレッションのターゲティングに使用されたデータの費用(米ドルナノ秒単位)
DBM データ料金(Google Partner の通貨) 長い × このインプレッションのターゲティングに使用されたデータの費用(パートナー通貨(ナノ単位))
DBM データ料金(広告主の通貨) 長い × このインプレッションのターゲティングに使用されたデータの費用(広告主の通貨(ナノ単位))
DBM 請求可能な費用(USD) 長い × メディア費用とパートナー費用を含む、パートナーに請求される合計金額(ナノ米ドル単位)
DBM 請求可能な費用(Partner 使用通貨) 長い × メディア費用とパートナー費用など、パートナーに請求される合計金額(パートナーの通貨ナノ単位)
DBM 請求可能な費用(広告主の通貨) 長い × メディア費用とパートナー費用など、パートナーに請求される合計金額(広告主の通貨(ナノ単位))
Google Click ID 文字列 × × × 広告に関連付けられたキャンペーンを識別するために、広告トラッキングで広告クリックとともに渡されるタグ