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

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

サポートされるレポート

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

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

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

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

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

レポートオプション

サポート

Schedule

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

時刻を設定できます。

更新ウィンドウ

過去 2 日間

設定不可

最大バックフィル期間

過去 60 日間

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

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

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

始める前に

ディスプレイ＆ビデオ 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 コンソールで [BigQuery] ページに移動します。

[BigQuery] に移動
BigQuery のナビゲーションメニューで、[データ転送] をクリックします。
[転送を作成] をクリックします。
[転送を作成] ページで、次の操作を行います。
- [ソースタイプ] セクションの [ソース] で、[ディスプレイ＆ビデオ 360 - プレビュー] を選択します。
- [転送構成名] セクションの [表示名] に、転送名を入力します。転送名には、後で修正が必要になった場合に識別できる任意の名前を使用できます。
[スケジュールオプション] セクションで:
- [すぐに開始可能] または [設定した時刻に開始] を選択して、開始日と実行時間を指定します。
- [繰り返しの頻度] で、転送を実行する頻度のオプションを選択します。[日数] を選択した場合は、有効な時刻を UTC で入力します。
  - 時間
  - 日数
  - オンデマンド
[転送先の設定] セクションの [宛先データセット] メニューで、データを保存するために作成したデータセットを選択します。
[データソースの詳細] セクションで、次の操作を行います。
- [ディスプレイ＆ビデオ 360] 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 疑似列を使用する必要があります。詳細については、パーティション分割テーブルのクエリをご覧ください。