# Facebook Offline Conversions Export Integration CLI

この機能はベータ版です。詳細については、カスタマーサクセス担当者にお問い合わせください。

Facebook Offline Conversions BETAを使用して、Treasure Dataから直接FacebookにジョブResult(オフラインイベントデータの形式)を送信し、Facebookの広告が店舗での購入、電話注文、予約など、実世界でどの程度の成果をもたらしているかを測定できます。

## 前提条件

- Treasure Dataの基本的な知識
- Facebook Offline ConversionsとFacebook Offline Eventの基本的な知識
- イベントデータをアップロードするには、Facebook上で以下のいずれかへのアクセスが必要です:
  - Business Manager管理者
  - Offline Event Setを作成したAdmin System User
  - Offline Event Setに接続されている`ad_account`の管理者


## コマンドラインからの接続の作成

CLIを使用して接続を設定できます。


```bash
td query --database your_database --result configuration query
```

次の表は、設定キーとその説明を示しています。

| **Config Key** | **Type** | **Required** | **Description** |
|  --- | --- | --- | --- |
| `type` | string | yes | facebook_offline_conversions |
| `access_token` | string | Yes | システムユーザーまたはlong-livedアクセストークン |
| `app_secret` | string | No | Facebookアプリシークレット |
| `event_set_id` | long | Yes | Facebook offline event set ID |
| `upload_tag` | string | Yes | イベントアップロードを追跡するために使用 |
| `match_keys` | string | Yes | Facebook上でユーザーとマッチングするために使用される識別情報。カンマ区切りの文字列で指定します。例: `email,phone,fn,ln,st,country…` |
| `namespace_id` | long | No | `extern_id`または`tpid`を解決するために使用されるスコープ。別のデータセットまたはデータパートナーIDを指定できます。例: `12345` |
| `skip_invalid` | boolean | No | 無効なレコードが検出された場合にジョブを終了する(revertなし)ために使用。例えば、レコードに必須列(`event_name`、`event_time`など)が欠けている場合 |
| `retry_limit` | int | No | 各API呼び出しの最大リトライ回数。デフォルト: 6 |
| `initial_retry_wait_msecs` | long | No | 最初のリトライの待機時間。デフォルト: `60000`ミリ秒 |
| `max_retry_wait_msecs` | long | No | リトライ間の最大待機時間。デフォルト:`30000`ミリ秒 |
| `connection_timeout_secs` | long | No | API呼び出し時の接続タイムアウト時間。デフォルト: `300`秒 |
| `write_timeout_secs` | long | No | リクエストへのデータ書き込みの待機時間。デフォルト: 180 |
| `read_timeout_secs` | long | No | レスポンスからのデータ読み取りの待機時間。デフォルト: 60 |


### 例: クエリの実行とOffline Event Setへの結果のエクスポート


```bash
td query --database my_db \
--result '{
           "type": "facebook_offline_conversions",
           "access_token": "xxx"
           "app_secret": "yyy"
           "event_set_id: 361738844830373,
           "upload_tag": "store_data"
         }' \
'SELECT email, fn, ln, event_time, event_name, value, currency from your_table'
```

サポートされている[クエリカラム名](https://api-docs.treasuredata.com/en/tools/presto/presto_troubleshooting/#invalid-table-alias-or-column-reference-error)について詳しく学んでください。

## 実行のスケジュール設定

以下を必ずご確認ください:

- [Scheduling Data Connector Job Execution from the CLI](/ja/int/scheduling-a-data-connector-job-execution-from-the-cli)