# 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) へのアクセスを許可した後、以下の手順を実行してデータをインポートします。

## Treasure コンソール の使用

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

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

![](/assets/screenshot-2025-07-26-at-19.19.57.5c48407f83f8dc37f0ae3f82d019928b0bc907c8dac0ce8c875e87017a08d4b9.7be277cd.png)

## Command Line / Workflow の使用

### 設定ファイルの作成

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


```yaml
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 (デフォルト)

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


```yaml
in:
...
out:
  mode: append
```

### replace (td 0.11.10 以降)

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


```yaml
in:
...
out:
  mode: replace
```

### 利用可能な Targets

| **Target** | **説明** |
|  --- | --- |
| company | Company データオブジェクト |
| creative | Creative データオブジェクト |
| inventory_adunit | Inventory AdUnit データオブジェクト |
| line_item | Line Item データオブジェクト |
| order | Order データオブジェクト |
| placement | Placement データオブジェクト |
| report | 保存されたレポートクエリを使用したレポート |


### 利用可能な Target オプション

| **Target  Options** | **start_date** | **end_date** | **report_query** | **last_fetched_datetime** |
|  --- | --- | --- | --- | --- |
| company |  |  |  | x |
| creative |  |  |  | x |
| inventory_adunit |  |  |  | x |
| line_item | x | x |  | x |
| order | x | x |  | x |
| placement |  |  |  | x |
| report |  |  | x |  |


- *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*](https://web.archive.org/web/20221208083905/mailto:google-dfp@affable-beach-161802.iam.gserviceaccount.com)) にアクセスを許可できます。

レポートクエリで使用している日付範囲に注意してください。[こちら](https://developers.google.com/ad-manager/api/reference/v201911/ReportService.DateRangeType?hl=th)から、Google API でサポートされている動的日付範囲のリストを確認できます。