Skip to content
/
Google AD Manager Via Dat...
Last updated

Google AD Manager Via Data Transfer Reports Import Integration

Google Doubleclick for Publisher (DFP) のデータオブジェクトを Treasure Data にインポートできます。

前提条件

  • Treasure Data の基礎知識
  • Google DFP の基礎知識
  • 認証済みの Treasure Data Service Account から Google DFP アカウントへのアクセス

Treasure Data へのアクセス許可

Treasure Data の DFP input connector は、Google DFP アカウントからデータを読み取るための権限が必要です。 Google DFP コンソールから「Admin」テーブルをクリックし、「Global settings」を選択してから「All network settings」を選択すると、右側のパネルの「Service account user」セクションに service account user へのアクセスを許可するボタンが表示されます。

弊社の service account email (google-dfp@affable-beach-161802.iam.gserviceaccount.com) へのアクセスを許可した後、以下の手順を実行してデータをインポートします。

TD Console の使用

Integrations Hub > Catalog に移動し、Google Ad Manager via Data Transfer Reports for Import を検索して選択します。

ダイアログが開きます。Google DFP コンソールで「Admin」>「Global settings」>「All network settings」>「Network code」をクリックすると確認できる DFP ネットワーク情報を入力します。

Command Line / Workflow の使用

設定ファイルの作成

以下の例に示すように、Google DFP アカウントのアクセス情報を含む設定ファイル (例: load.yml) を準備します:

in:
  type: google_dfp
  target: order
  network_code: 1234567
  auth_method: SERVICE_ACCOUNT
  start_date: 2017-01-02T12:00:00
  end_date: 2017-11-10T10:00:00
out:
  mode: replace

この例は、Google DFP の Order データオブジェクトをダンプします:

  • target: インポートする Google DFP データオブジェクト。
    • 利用可能な target のリストについては、付録を参照してください。
  • network_code: Google DFP ネットワークコード
  • auth_method: Google service account による認証をサポート (必須、サポートされる値: SERVICE_ACCOUNT)
  • start_date: この日付からデータをインポート (オプション)、フォーマット: yyyy-MM-dd'T'hh:mm:ss
  • end_date: この日付からデータをインポート (オプション)、フォーマット: yyyy-MM-dd'T'hh:mm:ss

start_date と end_date は、Order target で利用可能 (かつオプション) です。各 target で利用可能なすべてのオプションのリストについては、付録を参照してください。

利用可能な out モードの詳細については、付録を参照してください。

append (デフォルト)

これはデフォルトのモードで、レコードはターゲットテーブルに追加されます。

in:
...
out:
  mode: append

replace (td 0.11.10 以降)

このモードは、ターゲットテーブルのデータを置き換えます。このモードでは、ターゲットテーブルに対して手動で行われたスキーマ変更はそのまま保持されます。

in:
...
out:
  mode: replace

利用可能な Targets

Target説明
companyCompany データオブジェクト
creativeCreative データオブジェクト
inventory_adunitInventory AdUnit データオブジェクト
line_itemLine Item データオブジェクト
orderOrder データオブジェクト
placementPlacement データオブジェクト
report保存されたレポートクエリを使用したレポート

利用可能な Target オプション

Target Optionsstart_dateend_datereport_querylast_fetched_datetime
companyx
creativex
inventory_adunitx
line_itemxxx
orderxxx
placementx
reportx
  • start_date (オプション): この日付からデータをインポート (オプション)、フォーマット: yyyy-MM-dd'T'hh:mm:ss
  • end_date (オプション): この日付からデータをインポート (オプション)、フォーマット: yyyy-MM-dd'T'hh:mm:ss
  • report_query (必須): Google DFP コンソールで保存されたレポートクエリのクエリ名 (または ID)
  • last_fetched_datetime (オプション): この日時以降 (これを含まない) に最終更新時刻があるデータのみをインポートします。この値は epoch ミリ秒形式です。例: '1509511116000' (2017年11月8日 15:33:20)

Report Target

report target は、report_query で指定されたクエリを実行してレポートを取得し、データをデータベースにインポートします。したがって、クエリは事前に弊社のシステムからアクセス可能である必要があります。「User able to edit」フィールドで、弊社の Google DFP service account email (google-dfp@affable-beach-161802.iam.gserviceaccount.com) にアクセスを許可できます。

レポートクエリで使用している日付範囲に注意してください。こちらから、Google API でサポートされている動的日付範囲のリストを確認できます。

Previous page
Next page