BigQuery連携機能で出力されるデータの仕様を紹介します。
BigQuery連携のデータ出力仕様
- BigQuery連携開始後の初回データ連携は翌日から開始します。
- BigQuery連携は9時から開始される「プライマリ」と15時から開始される「セカンダリ」の1日2回行われます。
それぞれの内容についてはBigQuery連携のプライマリ連携とセカンダリ連携を確認してください。
連携するアカウントや広告主の追加はこの2回の連携開始時刻までに行われていれば当日の連携対象となります。 - データの出力履歴はBigQuery連携画面で確認することができます。
BigQuery連携画面の使い方を参考に出力履歴の表で確認してください。 - 当日に登録を行ったアカウントは連携対象外です。
- 各媒体の各レポート種別のデータ出力対象期間は初回データ連携時は「初回データ取得」、初回データ連携以降は「毎日のデータ取得」と同様です。媒体別の仕様は各媒体のデータ仕様で確認してください。
- BigQuery連携時、「atom_src」「atom」の2つのデータセットを作成します。
データ集計やレポート作成には「atom」のデータセットを利用することを推奨しています。-
atom_src
BigQueryのストレージに以下のデータが格納されます。
・ATOMで保持しているマスタデータや配信実績データを未加工で連携したデータ
・ATOMに登録されている案件設定などのデータ -
atom
「atom_src」のテーブルを元に利用しやすい状態に加工したビュー（クエリが定義された仮想テーブル）。
データ集計やレポート作成にはこちらのデータセットを利用してください。
-
atom_src
- 広告主やアカウントを削除すると翌日以降のデータの連携を停止します。
削除された日の前日までに連携されたデータはBigQueryに残ります。
例）9月20日にアカウントを削除した場合、 9月19日までのデータはBigQueryに残ります。
BigQuery連携のプライマリ連携とセカンダリ連携
BigQuery連携はプライマリ連携とセカンダリ連携の2回に分けて行われます。詳細は以下のとおりです。
| プライマリ | セカンダリ | |
|---|---|---|
| 開始時間 | 9:00 | 15:00 |
| 所要時間 | 1時間程度 | 1時間-2時間程度 |
| レポート種別 | すべてのレポート種別 | すべてのレポート種別 |
| 出力対象期間 | 2ヶ月 | 2ヶ月（初回の連携となるアカウントのみ14ヶ月） ※セカンダリでは初回連携対象の2ヶ月より過去の期間のデータ連携も行います |
BigQueryのデータセット「atom」に出力される各テーブルの分析軸・指標一覧
シェア系指標の集計時の計算方法一覧
BigQueryには以下の指標が出力されません。必要となる場合は以下を参考に集計してください。
| フィールド名 | 指標名 | 集計時の計算方法 |
|---|---|---|
| impression_share | インプレッションシェア | インプレッション数 ÷ 広告が表示可能だった回数 ※1 |
| absolute_top_impression_percentage | ページ最上部インプレッションの割合 | ページの最上部に広告が表示された回数 ※2 ÷ インプレッション数 |
| top_impression_percentage | ページ上部インプレッションの割合 | ページの上部に広告が表示された回数 ※3 ÷ インプレッション数 |
| search_absolute_top_impression_share | ページ最上部インプレッションシェア | ページの最上部に広告が表示可能だった回数 ※4 ÷ インプレッション数 |
| search_top_impression_share | ページ上部インプレッションシェア | ページの上部に広告が表示可能だった回数 ※5 ÷ インプレッション数 |
| budget_lost_impression_share | インプレッション損失率(予算) | 予算不足が原因で失われた表示機会の回数 ※6 ÷ 広告が表示可能だった回数 |
| quality_lost_impression_share | インプレッション損失率(掲載順位) | 広告の掲載順位が原因で失われた表示機会の回数 ※7 ÷ 広告が表示可能だった回数 |
| criteo_overall_competition_win | Overall Competition Win | インプレッション数 ÷ Criteo広告が表示可能だった回数 ※8 |
- ※1 広告が表示可能だった回数 = インプレッション数 ÷ インプレッションシェア
- ※2 ページの最上部に広告が表示された回数 = ページ最上部インプレッションの割合 × インプレッション数
- ※3 ページの上部に広告が表示された回数 = ページ上部インプレッションの割合 × インプレッション数
- ※4 ページの最上部に広告が表示可能だった回数 = (ページ最上部インプレッションの割合 × インプレッション数) ÷ ページ最上部インプレッションシェア
- ※5 ページの上部に広告が表示可能だった回数 = (ページ上部インプレッションの割合 × インプレッション数) ÷ ページ上部インプレッションシェア
- ※6 予算不足が原因で失われた表示機会の回数 = (インプレッション数 ÷ インプレッションシェア) × インプレッション損失率(予算)
- ※7 広告の掲載順位が原因で失われた表示機会の回数 = (インプレッション数 ÷ インプレッションシェア) × インプレッション損失率(掲載順位)
- ※8 Criteo広告が表示可能だった回数 = インプレッション数 ÷ Overall Competition Win