ディスプレイ&ビデオ 360 の転送をスケジュール設定する
ディスプレイ&ビデオ 360 用の BigQuery Data Transfer Service コネクタを使用すると、ディスプレイ&ビデオ 360 のレポートと構成のデータを定期的に読み込むジョブのスケジュールと管理を自動化できます。
サポートされるレポート
ディスプレイ&ビデオ 360 用の BigQuery Data Transfer Service は、次のレポート オプションをサポートしています。
ディスプレイ&ビデオ 360 のレポートが BigQuery のテーブルとビューに変換される仕組みについては、ディスプレイ&ビデオ 360 のデータ変換をご覧ください。
ディスプレイ&ビデオ 360 は、データ転送ファイルを最長 60 日間保持します。
レポート オプション | サポート |
---|---|
繰り返しの頻度 | 毎日、データ転送が最初に作成される時刻(デフォルト) 時刻を構成できます。 |
更新ウィンドウ | 過去 2 日間 設定不可 |
最大バックフィル期間 | 過去 60 日間 |
サポートされている構成データ
BigQuery Data Transfer Service では、レポートデータに加えて、ディスプレイ&ビデオ 360 から次の構成データも転送されます。構成データは Display & Video 360 API v3 から取得されます。
- パートナー
- 広告主
- LineItem
- LineItemTargeting
- Campaign
- CampaignTargeting
- InsertionOrder
- InsertionOrderTargeting
- AdGroup
- AdGroupTargeting
- AdGroupAd
- クリエイティブ
構成データの各種類の詳細については、次のリンクをご覧ください。
ディスプレイ&ビデオ 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
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 で入力します。
- 時間
- 日数
- オンデマンド
[転送先の設定] セクションの [宛先データセット] メニューで、データを保存するために作成したデータセットを選択します。
[データソースの詳細] セクションで、次の操作を行います。
[保存] をクリックします。
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
疑似列を使用する必要があります。詳細については、パーティション分割テーブルのクエリをご覧ください。