# Taboola Export Integration

Taboola Output Connectorは、Taboolaの広告プラットフォームからオーディエンスデータをエクスポートするために設計されています。具体的には、このコネクタは以下の機能をサポートする必要があります。

1. **DEVICE_ID**や**EMAIL_ID**（User ID Object）などのユーザー識別子を使用して**ファーストパーティオーディエンス**を作成します。
2. **ユーザーの追加/削除**操作を許可することで、オーディエンスメンバーシップを動的に更新します。


## 前提条件

- TD Toolbeltを含むTreasure Dataの基本的な知識。
- Taboolaの基本的な知識。


## 制限事項と既知の問題

- コネクタのスキーマはフラット化されたタイプです。
- **バッチサイズ：** リクエストあたり≤100,000ユーザーを推奨（ユーザーの追加/削除の場合）。
- **利用可能になるまでの遅延：**
  - オーディエンス作成：利用可能になるまで約1時間。
  - オーディエンスのスケーリング：`audience_size`が安定するまで1～3日。​


## Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります:
[https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/](https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/)

## Client IDとClient Secretの取得

Client IDとClient Secretを取得するには、アカウントマネージャーに連絡するか、API認証情報について[support@taboola.com](mailto:support@taboola.com)にお問い合わせください。

[https://developers.taboola.com/backstage-api/reference/authentication-basics#client-id-and-client-secret](https://developers.taboola.com/backstage-api/reference/authentication-basics#client-id-and-client-secret)

## TD Consoleの使用

### 認証の作成

最初のステップは、認証情報のセットで新しい認証を作成することです。

1. **Integrations Hub**を選択します。
2. **Catalog**を選択します。
![](/assets/integrationshub-catalog2.e33c0a4c7d81c40cc83dd056c2143b97b1406220e213cab14ef349d69412ffef.eedebb45.png)
3. CatalogでTaboolaを検索し、アイコンの上にマウスを置いて**Create Authentication**を選択します。
![](/assets/screenshot-2025-10-03-at-14.35.21.e1bc34f7cb21d82456be7bc7231abc4bed65f7b0dde516d57652a9c804fcffd6.f5c65037.png)![](/assets/screenshot-2025-10-03-at-14.35.45.cae6cd1b3d9100b323230cdf141e2052439f3801000f409e2396a48063a13d40.f5c65037.png)
4. **Credentials**タブが選択されていることを確認し、統合の認証情報を入力します。
![](/assets/screenshot-2025-10-03-at-14.37.43.a0e644f00f60275fb7932e57d6532a19974f093c23e29b4f6adb6e2265f1505b.f5c65037.png)
**新しい認証フィールド**
| Parameter | Description |
|  --- | --- |
| Authentication Method | 認証に使用されるドロップダウン方式です。1種類の認証をサポートします：  - OAuth |
| Client ID | TaboolaアカウントのClient IDです。 |
| Client Secret | TaboolaアカウントのClient Secretです。 |
5. **Continue**を選択します。
6. 認証の名前を入力し、**Done**を選択します。


### エクスポート用のクエリ結果の設定

TD Consoleは、データをエクスポートする複数の方法をサポートしています。Data Workbenchからデータをエクスポートするには、次の手順に従ってください。

1. **Data Workbench > Queries**に移動します。
2. **New Query**を選択します。
3. データベースのドロップダウンで、クエリするデータベースを入力します。この例では*test_db*を使用します。
4. クエリペインでSQLクエリを入力します。
5. **Run**を選択してクエリの結果を検証します。


- **クエリ例：**

```sql
SELECT
  'test@treasure-data.com' as email,
  '0000000-0000000-01234567-89ABCDEF' as device
FROM
  your_table
```
- スキーマはフラット化されたタイプとして定義する必要があります。各行は、Taboolaで定義されている意味での[cluster](https://developers.taboola.com/backstage-api/reference/user-object#:~:text=Description-,cluster,-Holds%20a%20collection)です。
- データ仕様


| Field Name | Type | Required | Description |
|  --- | --- | --- | --- |
| email_N または email | String | No | - メールのuser_id（ハッシュ化されているか、されていないかのいずれも可）。
- メールアドレス（*SHA256ハッシュとして*）

 |
| `device_N` または device | String | No | - デバイスのuser_id。
- Device IDまたはMAID（*クリアテキストで*）

 |


### 結果のエクスポート先の指定

1. **Export Results**を選択します。


![](/assets/queries-untitled-query-treasure-data-3.6cb768236972ecbf96e74f2154224779ce0010e2e6f31f183b44fcb233f83720.77d44e6e.png)

1. 外部サービスに結果をエクスポートするには、既存の認証を使用するか、新しい認証を作成できます。次のいずれかを選択します


- Use Existing Integration
- Create New Integration


1. 既存の統合を選択/新しい統合を作成します。
2. フォームに情報を入力します。


![](/assets/screenshot-2025-10-03-at-15.36.52.ffcc820cc4a5555ca40722bd6da108153ee21928266c8cc7500ada71878a74a1.f5c65037.png)

| Field | Description |
|  --- | --- |
| Account ID | TaboolaアプリケーションのアカウントIDです。 |
| Audience Name | オーディエンスの一意の名前です。既存の`audience_name`が使用された場合、サーバーは新しいオーディエンスを作成する代わりに既存のオーディエンスを返します。 |
| TTL in Hours | ユーザーがオーディエンスに留まる時間（時間単位）です。省略された場合、デフォルトは8,760（1年）です。 |
| Operation | データをエクスポートする操作です。2つのオプションがあります：   - Add - Remove |
| Skip on invalid records | 無効なレコードのスキップを有効にします。 |
| Upload Batch Size | 各バッチでユーザーを送信するバッチサイズです。1から100000まで。 |


1. **Done**を選択して設定を保存します。


### クエリ例


```sql
SELECT 'test@treasure-data.com' as email,
       '0000000-0000000-01234567-89ABCDEF' as device
```

### (オプション) Query Export ジョブをスケジュールする

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが `'0 0 1 * 1'` の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

#### TD Console を使用してジョブをスケジュールする

1. **Data Workbench > Queries** に移動します
2. 新しいクエリを作成するか、既存のクエリを選択します。
3. **Schedule** の横にある None を選択します。
![](/assets/image2021-1-15_17-28-51.f1b242f6ecc7666a0097fdf37edd1682786ec11ef80eff68c66f091bc405c371.0f87d8d4.png)
4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:
![](/assets/image2021-1-15_17-29-47.45289a1c99256f125f4d887e501e204ed61f02223fde0927af5f425a89ace0c0.0f87d8d4.png)
| ドロップダウン値 | 説明 |
|  --- | --- |
| Custom cron... | [Custom cron... の詳細](#custom-cron-details)を参照してください。 |
| @daily (midnight) | 指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。 |
| @hourly (:00) | 毎時 00 分に実行します。 |
| None | スケジュールなし。 |


#### Custom cron... の詳細

![](/assets/image2021-1-15_17-30-23.0f94a8aa5f75ea03e3fec0c25b0640cd59ee48d1804a83701e5f2372deae466c.0f87d8d4.png)

| **Cron 値** | **説明** |
|  --- | --- |
| `0 * * * *` | 1 時間に 1 回実行します。 |
| `0 0 * * *` | 1 日 1 回午前 0 時に実行します。 |
| `0 0 1 * *` | 毎月 1 日の午前 0 時に 1 回実行します。 |
| "" | スケジュールされた実行時刻のないジョブを作成します。 |



```
 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)
```

次の名前付きエントリを使用できます:

- Day of Week: sun, mon, tue, wed, thu, fri, sat.
- Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.


各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

| フィールド値  | 例  | 例の説明  |
|  --- | --- | --- |
| 各フィールドに対して上記で表示された制限内の単一の値。 |  |  |
| フィールドに基づく制限がないことを示すワイルドカード
`'*'`。 | `'0 0 1 * *'` | 毎月 1 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 範囲 `'2-5'`
フィールドの許可される値の範囲を示します。 | `'0 0 1-10 * *'` | 毎月 1 日から 10 日までの午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| カンマ区切りの値のリスト `'2,3,4,5'`
フィールドの許可される値のリストを示します。 | `0 0 1,11,21 * *'` | 毎月 1 日、11 日、21 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 周期性インジケータ `'*/5'`
フィールドの有効な値の範囲に基づいて、
スケジュールが実行を許可される頻度を表現します。 | `'30 */2 1 * *'` | 毎月 1 日、00:30 から 2 時間ごとに実行するようにスケジュールを設定します。
`'0 0 */5 * *'` は、毎月 5 日から 5 日ごとに午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| `'*'`
ワイルドカードを除く上記の
いずれかのカンマ区切りリストもサポートされています
`'2,*/5,8-10'` | `'0 0 5,*/10,25 * *'` | 毎月 5 日、10 日、20 日、25 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |


1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。


### クエリを実行する

クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。

設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。

(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

## Audience Studio で Segment をアクティベートする

Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。

1. **Audience Studio** に移動します。
2. parent segment を選択します。
3. ターゲット segment を開き、右クリックして、**Create Activation** を選択します。
4. **Details** パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
5. **Output Mapping** パネルで activation 出力をカスタマイズします。


![](/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png)

- Attribute Columns
  - **Export All Columns** を選択すると、変更を加えずにすべての列をエクスポートできます。
  - **+ Add Columns** を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。**+ Add Columns** を選択し続けて、activation 出力用の新しい列を追加します。
- String Builder
  - **+ Add string** を選択して、エクスポート用の文字列を作成します。次の値から選択します:
    - String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    - Timestamp: エクスポートの日時。
    - Segment Id: segment ID 番号。
    - Segment Name: segment 名。
    - Audience Id: parent segment 番号。


1. **Schedule** を設定します。


![](/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png)

- スケジュールを定義する値を選択し、オプションでメール通知を含めます。


1. **Create** を選択します。


batch journey の activation を作成する必要がある場合は、[Creating a Batch Journey Activation](/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation) を参照してください。

## （オプション）Workflowでのエクスポート結果の設定

Treasure Workflow内で、このデータコネクタを使用してデータをエクスポートすることを指定できます。

ワークフローを使用してデータをエクスポートする方法の詳細については、[TD Toolbeltを使用したワークフローによるデータのエクスポート](https://api-docs.treasuredata.com/en/tools/cli/api/#workflow-commands)を参照してください。

## （オプション）CLIを使用したエクスポート統合

TD Toolbeltが提供するCLIを使用して、クエリ結果をLINEメッセージングにエクスポートすることもできます。

td queryコマンドを使用する場合は、--result RESULT_URLオプションでLINEメッセージングサーバーのURLを指定します。詳細については、[td query](https://api-docs.treasuredata.com/en/tools/cli/api/#td-query)を参照してください。

オプションのフォーマットはJSONで、一般的な構造は次のとおりです。

**パラメータ**

| Name | Description | Value | Default Value | Required |
|  --- | --- | --- | --- | --- |
| type | エクスポート先のサービス名を記述します。 | taboola |  | Yes |
| auth_method | 認証方式はOAuthのいずれかを指定できます。 | 1種類の認証をサポートします：   - oauth | oauth | Yes |
| client_id | TabooアカウントのClient ID | String |  | Yes |
| client_secret | TabooアカウントのClient Secret | String |  | Yes |
| account_id | TaboolaアプリケーションのAccount IDです。 | String |  | Yes |
| audience_name | オーディエンスの一意の名前です。既存の`audience_name`が使用された場合、サーバーは新しいオーディエンスを作成する代わりに既存のオーディエンスを返します。 | String |  | Yes |
| ttl_in_hours | ユーザーがオーディエンスに留まる時間（時間単位）です。省略された場合、デフォルトは8,760（1年）です。 | Integer | 8760 | No |
| operation | データをエクスポートする操作です。Add / Removeの2つのオプションがあります。 | String 2つの操作をサポートします：   - add - remove | add | No |
| skip_invalid_records | 無効なレコードのスキップを有効にします。 | Boolean | true | No |
| batch_size | 各バッチでユーザーを送信するバッチサイズです。 | Integer。1から100000まで | 100000 | No |


### 使用例

**OAuthによる認証**


```
out:  type: taboola  auth_method: oauth  client_id: xxxxxxxx  client_secret: xxxxxxxx  ...
```

**オーディエンスへのユーザーの追加**


```
out:  type: taboola  auth_method: oauth  client_id: xxxxxx  client_secret: xxxxxx  account_id: acount_id  audience_name: audience_name  operation: add  skip_invalid_records: true  batch_size: 100000
```

**オーディエンスからのユーザーの削除**


```
out:  type: taboola  auth_method: oauth  client_id: xxxxxx  client_secret: xxxxxx  account_id: acount_id  audience_name: audience_name  operation: remove  skip_invalid_records: true  batch_size: 100000
```

## 関連項目

- Result Exportは、定期的にターゲットの宛先にデータをアップロードするようにスケジュールできます。[TD Consoleを使用したジョブのスケジューリング](https://docs.treasuredata.com/smart/project-product-documentation/scheduling-jobs-using-td-console)を参照してください。
- すべてのインポートおよびエクスポート統合は、[TD Workflow](https://docs.treasuredata.com/articles/pd/about-treasure-workflow)に追加できます。td>: データオペレータは、クエリ結果を指定された統合にエクスポートできます。詳細については、[Treasure Workflowオペレータのリファレンス](https://docs.treasuredata.com/articles/pd/reference-for-treasure-data-operators/a/h1_76525622)を参照してください。