# Adobe Target Export Integration

この統合は現在ベータ版であり、機能と安定性を改善するためにフィードバックを積極的に収集しています。

## 概要

Adobe Targetコネクタを使用すると、マーケターはTDプラットフォームから顧客プロファイルデータをAdobe Targetに直接アップロードできます。

## 前提条件

- TD Toolbeltを含むTreasure Dataの基本的な知識
- Adobe Targetの基本的な知識
- Adobe Profile API認証を有効にする場合は、Adobe Client CodeとAdobe Profile API Access Token


## 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/)

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

- 更新は通常1時間以内に行われますが、反映されるまでに最大24時間かかる場合があります。


## Adobe TargetからClient CodeとProfile API Authentication Tokenを取得する

- `experience.adobe.com`にログインし、Targetを選択します


![](/assets/adobe-target-export-integration-2025-04-08.0ba51b3c15eb88f107ca6557dbc2a3cd6c13cc722d8a5b7ca27981a7f4b2b0ab.ebd83bd6.png)

- Targetホームから Adminstration -> Implementation -> Copy Client Code を選択します


![](/assets/adobe-target-export-integration-2025-04-08-1.1ca72c9b00ec03b405741ce9420bcf9f1071b3e489e3d18e3e4cf87fc14f0c22.ebd83bd6.png)

- Implementationページを下にスクロールして Profile API セクションに移動します。必要に応じて Require Authentication をクリックして有効にします。その後、Generate Authentication Token をクリックしてトークンをコピーし、コネクタ設定用に保存します。


![](/assets/adobe-target-export-integration-2025-04-08-2.705293583a04b33c0d763f118c4e18e9735aacd3507afbed113addda4fe3c472.ebd83bd6.png)

## 新しい認証を作成する

クエリを実行する前に、TD Consoleでデータ接続を作成および設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。次の手順を実行してください。

![](/assets/screenshot-2025-03-12-at-15.30.47.293b3283d88db427e1cba7fcfb19832eb888847b5f77d665756fc0756b52b1b9.fe495661.png)

1. TD Consoleを開きます。
2. **Integrations Hub > Catalog** に移動します。
3. **Adobe Target** を検索して選択します。アイコンにカーソルを合わせて **Create Authentication** を選択します。
4. **Credentials** タブが選択されていることを確認し、統合の認証情報を入力します。以下のいずれかを選択してください。


![](/assets/screenshot-2025-03-26-at-10.49.59.b1ff7e4e0884a7c29b3d09488d26dd8591ab2524d2b0d248e6b15239346a13ce.0efdb04c.png)
5. **Continue** を選択します。
6. 接続の名前を入力します。**Done** を選択します。

**認証フィールド**

| Parameter | Description |
|  --- | --- |
| Client Code | Adobe Targetが提供する一意の識別子で、Adobe API認証に使用されます。Target管理設定から取得します |
| Adobe Profile API Authentication Token | オプション。Adobe Profile API認証が有効になっている場合にのみ必要です |


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

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

1. **Data Workbench** > **Queries** に移動します。
2. **New Query** を選択し、クエリを定義します。
3. **Export Results** を選択してデータのエクスポートを設定します。
4. 既存のAdobe Target認証を選択するか、前述の方法で新しい認証を作成します。
5. **Done** を選択します。


### コネクタ設定パラメータ

| **Field** | **Description** |
|  --- | --- |
| **Bulk Update API Version** | 使用するAPIバージョン。   - **v1**: バルクプロファイル更新のみをサポート。(mbox.idはv1のみでサポート) - **v2 (デフォルト)**: プロファイルが見つからない場合は作成します。 |
| **Guaranteed Upload** | Adobe Targetコネクタはファイルごとにプロファイルデータファイルをアップロードします。チェックすると、次のファイルをアップロードする前に、Adobe Serverサイドで最後にアップロードされたファイルの処理が正常に完了するまで待機します。 |
| **Skip invalid records?** | チェックすると、無効なレコードをスキップして次のレコードの処理を続行します。チェックしない場合、ジョブは停止します。 |


## クエリ結果データ仕様の詳細ガイド

Adobe Targetにユーザープロファイルデータを正常にアップロード/変更するには、特定のデータ仕様に準拠したエクスポートクエリを作成する必要があります。

### 1. エクスポートクエリ仕様

| Specification | Description |
|  --- | --- |
| **Required Fields** | エクスポートクエリには、以下の識別子フィールドのうち少なくとも1つが存在する必要があります:   - pc_id (Targetが生成したvisitorID)   - third_party_id (クライアントアプリケーションが指定したIDで、`mbox3rdPartyId`としてmbox呼び出しを通じてTargetに渡されます)  pc_idとthird_party_idフィールドは文字列データ型である必要があります。 |
| **Custom Fields** | 必須フィールドにリストされていないフィールドは、自動的にprofile paramにマッピングされます。これらはTargetで`profile.paramName`として表示されます。 |


## CLIを使用したエクスポート統合

CLIを使用して結果をAdobe Targetにエクスポートすることもできます。

`td query`コマンドの`--result`オプションを使用して、Adobe Targetサーバーへのエクスポート情報を指定する必要があります。`td query`コマンドの詳細については、[この記事](/tools/cli-and-sdks/querying-and-importing-data-to-treasure-data-from-the-command-line)を参照してください。

オプションの形式はJSONで、一般的な構造は次のとおりです。


```
type: 'adobe_target'
client_code: xxxx
profile_api_token: xxxxx
api_version: v1
guaranteed_upload: false
skip_invalid_records: true
```

### 使用例


```bash
$ td query --result '{"type":"adobe_target","client_code":"xxx","profile_api_token":"xxx", "api_version": "v1","guaranteed_upload":false,"skip_invalid_records":true}' -d sample_datasets "select ........ from ........" -T presto
```

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

| **Config Key** | **Type** | **Required** | **Description** |
|  --- | --- | --- | --- |
| type | string | yes | 値は **adobe_target** である必要があります |
| client_code | string | yes | Adobe Targetのclient code |
| `profile_api_token` | string | yes if Adobe profile api turn on | Adobe Profile APIトークン |
| api_version | string | no | **v1, v2** から選択。デフォルトは **v2** |
| `guaranteed_upload` | boolean | no | デフォルト値はfalse。trueに設定すると、次のプロファイルデータのアップロードは、Adobe Target側で現在のアップロードプロセスが完了するまで待機します |
| `skip_invalid_records` | boolean | no | trueに設定すると(デフォルト)、無効なレコードをスキップして有効なレコードのアップロードを続行します。     falseに設定すると、無効なレコードに遭遇したときにジョブを終了します。 |


## 注意事項

API経由でアップロードされたpcIDを取得したい場合は、正確な場所を特定するために[profile fetch](https://experienceleague.adobe.com/en/docs/target-dev/developer/api/profile-apis/profile-fetch) URLにedgeドメインを追加してください。Adobe Targetは、ユーザーの場所に関係なく応答時間を最適化するために、地理的に分散されたサービングアーキテクチャを実装しています。pcIdプロファイルは最も近いedgeにルーティングされます。データがルーティングされるedgeドメインのバッチアップロードステータスを確認してください。

詳細については、Adobe Targetのドキュメントを参照してください [https://experienceleague.adobe.com/en/docs/target-dev/developer/implementation/privacy/allowlist-edges](https://experienceleague.adobe.com/en/docs/target-dev/developer/implementation/privacy/allowlist-edges)