ディスプレイ＆ビデオ 360 の転送をスケジュール設定する

ディスプレイ＆ビデオ 360 用の BigQuery Data Transfer Service コネクタを使用すると、ディスプレイ＆ビデオ 360 のレポートと構成のデータを定期的に読み込むジョブのスケジュールと管理を自動化できます。

サポートされるレポート

ディスプレイ＆ビデオ 360 用の BigQuery Data Transfer Service は、次のレポートオプションをサポートしています。

Data Transfer v2（ディスプレイ＆ビデオ DTv2）ファイル

ディスプレイ＆ビデオ 360 のレポートが BigQuery のテーブルとビューに変換される仕組みについては、ディスプレイ＆ビデオ 360 のデータ変換をご覧ください。

ディスプレイ＆ビデオ 360 は、データ転送ファイルを最長 60 日間保持します。

レポートオプション	サポート
繰り返しの頻度	毎日、データ転送が最初に作成される時刻（デフォルト）時刻を構成できます。
更新ウィンドウ	過去 2 日間設定不可
最大バックフィル期間	過去 60 日間

レポートオプション

サポート

繰り返しの頻度

毎日、データ転送が最初に作成される時刻（デフォルト）

時刻を構成できます。

更新ウィンドウ

過去 2 日間

設定不可

最大バックフィル期間

過去 60 日間

サポートされている構成データ

BigQuery Data Transfer Service では、レポートデータに加えて、ディスプレイ＆ビデオ 360 から次の構成データも転送されます。構成データは Display & Video 360 API v3 から取得されます。

構成データの各種類の詳細については、次のリンクをご覧ください。

ディスプレイ＆ビデオ 360 転送からのデータの取り込み

ディスプレイ＆ビデオ 360 から BigQuery にデータを転送すると、データは日付でパーティション分割された BigQuery テーブルに読み込まれます。データが読み込まれるテーブルパーティションは、データソースの日付に対応します。同じ日付の複数の転送をスケジュールすると、BigQuery Data Transfer Service により、対象の日付のパーティションが最新のデータで上書きされます。同じ日に複数回の転送やバックフィルを実行しても、データは重複せず、他の日付のパーティションに対する影響はありません。

更新ウィンドウ

更新ウィンドウとは、データ転送が行われたときにデータ転送でデータが取得される日数です。たとえば、更新ウィンドウが 3 日であり、毎日転送が行われる場合、BigQuery Data Transfer Service は過去 3 日間のソーステーブルからすべてのデータを取得します。この例では、毎日転送が発生すると、BigQuery Data Transfer Service は、当日のソーステーブルのデータのコピーを含む新しい BigQuery 宛先テーブルパーティションを作成し、バックフィル実行を自動的にトリガーして、過去 2 日間のソーステーブルのデータで BigQuery 宛先テーブルパーティションを更新します。自動トリガーされたバックフィル実行は、BigQuery Data Transfer Service コネクタで増分更新がサポートされているかどうかに応じて、BigQuery の宛先テーブルを上書きするか、増分更新します。

データ転送を初めて実行する際に、更新ウィンドウ内で利用可能なすべてのソースデータを取得します。たとえば、更新ウィンドウが 3 日であり、データ転送を初めて実行する場合は、BigQuery Data Transfer Service によって 3 日以内のすべてのソースデータが取得されます。

更新ウィンドウは TransferConfig.data_refresh_window_days API フィールドにマッピングされます。

更新ウィンドウの期間外のデータ（過去のデータなど）を取得する場合や、転送の停止やギャップからデータを復元する場合は、バックフィル実行を開始またはスケジュールできます。

始める前に

ディスプレイ＆ビデオ 360 のデータ転送を作成する前に、次の前提条件と情報を確認してください。

前提条件

BigQuery Data Transfer Service を有効にするために必要なすべての操作が完了していることを確認します。
ディスプレイ＆ビデオ 360 のデータを保存する BigQuery データセットを作成します。
ディスプレイ＆ビデオ 360 のパートナー ID または広告主 ID があることを確認します。パートナー ID は階層内で親になります。
Display and Video API のパートナーまたは広告主のデータにアクセスするための読み取り権限があることを確認します。
組織でディスプレイ＆ビデオ 360 の Data Transfer v2（ディスプレイ＆ビデオ 360 DTv2）ファイルにアクセスできることを確認します。これらのファイルは、ディスプレイ＆ビデオ 360 チームによって Cloud Storage バケットに配信されています。ディスプレイ＆ビデオ 360 DTv2 ファイルへのアクセス権のリクエストは、ディスプレイ＆ビデオ 360 と直接契約しているかどうかによって異なります。どちらの場合も、追加料金が適用される場合があります。
- ディスプレイ＆ビデオ 360 と契約している場合は、ディスプレイ＆ビデオ 360 のサポートに連絡して、ディスプレイ＆ビデオ 360 DTv2 ファイルを設定してください。
- ディスプレイ＆ビデオ 360 と契約していない場合は、ディスプレイ＆ビデオ 360 DTv2 ファイルへのアクセスについて代理店にお問い合わせください。
- この手順を完了すると、パートナーと広告主のどちらの設定かによって、次のいずれかの Cloud Storage バケット名を受け取ります。
  - gs://dcdt_-dbm_partnerPARTNER_ID
  - gs://dcdt_-dbm_advertiserADVERTISER_ID
注: Google Cloud チームには、ユーザーに代わってディスプレイ＆ビデオ 360 DTv2 ファイルを生成したり、このようなファイルに対するアクセス権を付与したりする権限はありません。ディスプレイ＆ビデオ 360 DTv2 ファイルへのアクセスについては、ディスプレイ＆ビデオ 360 のサポートまたは代理店にお問い合わせください。
Pub/Sub の転送実行通知を設定するには、pubsub.topics.setIamPolicy 権限が必要です。詳細については、BigQuery Data Transfer Service の実行通知をご覧ください。

ディスプレイ＆ビデオ 360 ID を確認する

ディスプレイ＆ビデオ 360 ID を取得するには、Google Cloud コンソールで Cloud Storage の [バケット] ページに移動し、ディスプレイ＆ビデオ 360 データ転送 Cloud Storage バケット内のファイルを調べます。ディスプレイ＆ビデオ 360 ID は、提供された Cloud Storage バケット内のファイルを照合するために使用されます。この ID はファイル名に埋め込まれ、Cloud Storage バケット名には埋め込まれません。例:

dbm_partner123_activity_* という名前のファイルの場合、ID は 123 です。
dbm_advertiser567_activity_* という名前のファイルの場合、ID は 567 です。

ファイル名の接頭辞の検索

場合によって、Cloud Storage バケット内のファイルに、Google マーケティングプラットフォームのサービスチームによって設定された非標準のカスタムファイル名が含まれていることがあります。例:

dbm_partner123456custom_activity_* という名前のファイルの場合、接頭辞は dbm_partner123456custom です。

ファイル名の接頭辞についてサポートが必要な場合は、ディスプレイ＆ビデオ 360 のサポートにお問い合わせください。

ディスプレイ＆ビデオ 360 のデータ転送を設定する

次のオプションのいずれかを選択します。

コンソール

Google Cloud コンソールの [データ転送] ページに移動します。

[データ転送] に移動
[転送を作成] をクリックします。
[転送を作成] ページで、次の操作を行います。
- [ソースタイプ] セクションの [ソース] で、[ディスプレイ＆ビデオ 360] を選択します。
- [転送構成名] セクションの [表示名] に、データ転送の名前を入力します。転送名には、後で修正が必要になった場合に識別できる任意の名前を使用できます。
[スケジュールオプション] セクションで:
- [すぐに開始可能] または [設定した時刻に開始] を選択して、開始日と実行時間を指定します。
- [繰り返しの頻度] で、データ転送を実行する頻度のオプションを選択します。[日数] を選択した場合は、有効な時刻を UTC で入力します。
  - 時間
  - 日数
  - オンデマンド
[転送先の設定] セクションの [宛先データセット] メニューで、データを保存するために作成したデータセットを選択します。
[データソースの詳細] セクションで、次の操作を行います。
- [DV360 DTV2 Cloud Storage bucket] フィールドに、ディスプレイ＆ビデオ 360 DTv2 ファイルを含む Cloud Storage バケットを入力します。このバケットを設定する必要が生じた場合は、ディスプレイ＆ビデオ 360 のサポートにお問い合わせください。
- [DV360 Partner/Advertiser ID] フィールドに、パートナー ID または広告主 ID を入力します。
- （省略可）[通知オプション] セクションで、次の操作を行います。
  - 切り替えボタンをクリックしてメール通知を有効にします。このオプションを有効にすると、転送の実行が失敗した場合、転送管理者にメール通知が送信されます。
  - 切り替えボタンをクリックして、Pub/Sub 通知を有効にします。[Cloud Pub/Sub トピックを選択してください] で、トピック名を選択するか、[トピックを作成する] をクリックします。このオプションで、Pub/Sub の転送実行通知を構成します。
[保存] をクリックします。

bq

bq mk コマンドを入力して、転送作成フラグ --transfer_config を指定します。次のフラグは必須です。

--data_source
--target_dataset
--display_name
--params

  bq mk --transfer_config \
  --project_id=PROJECT_ID \
  --target_dataset=DATASET \
  --display_name=NAME \
  --params='PARAMETERS' \
  --data_source=DATA_SOURCE

ここで

PROJECT_ID: プロジェクト ID。
DATASET: データ転送構成のターゲットデータセット。
NAME: データ転送構成の表示名。転送名には、後で修正が必要になった場合に識別できる任意の名前を使用できます。
PARAMETERS: 作成されるデータ転送構成のパラメータを JSON 形式で指定します。たとえば、--params='{"param":"param_value"}' です。ディスプレイ＆ビデオ 360 の転送では、bucket パラメータと displayvideo_id パラメータが必要です。パラメータ file_name_prefix はオプションで、まれにカスタムファイル名にのみ使用されます。
DATA_SOURCE: データソース - displayvideo。

たとえば、次のコマンドは、ディスプレイ＆ビデオ 360 ID 123456、Cloud Storage バケット dcdt_-dbm_partner123456、ターゲットデータセット mydataset を使用して、My Transfer というディスプレイ＆ビデオ 360 データ転送を作成します。

このデータ転送はデフォルトのプロジェクトで作成されます。

  bq mk --transfer_config \
  --target_dataset=mydataset \
  --display_name='My Transfer' \
  --params='{"bucket":"dcdt_-dbm_partner123456","displayvideo_id": "123456","file_name_prefix":"YYY"}' \
  --data_source=displayvideo

コマンドを実行すると、次のようなメッセージが表示されます。

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

メッセージの指示に従って、認証コードをコマンドラインに貼り付けます。

API

projects.locations.transferConfigs.create メソッドを使用して、TransferConfig リソースのインスタンスを指定します。

データに対するクエリを実行する

データが BigQuery に転送されると、取り込み時間パーティション分割テーブルにそのデータが書き込まれます。詳細については、パーティション分割テーブルの概要をご覧ください。

テーブルを直接クエリするのではなく、自動生成されたビューに対してクエリすることをおすすめします。ただし、テーブルに直接クエリする場合は、クエリで _PARTITIONTIME 疑似列を使用する必要があります。詳細については、パーティション分割テーブルのクエリをご覧ください。