この統合は現在ベータ版であり、機能と安定性を改善するためにフィードバックを積極的に収集しています。
Adobe Targetコネクタを使用すると、マーケターはTDプラットフォームから顧客プロファイルデータをAdobe Targetに直接アップロードできます。
- TD Toolbeltを含むTreasure Dataの基本的な知識
- Adobe Targetの基本的な知識
- Adobe Profile API認証を有効にする場合は、Adobe Client CodeとAdobe Profile API Access Token
セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。
リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります: https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/
- 更新は通常1時間以内に行われますが、反映されるまでに最大24時間かかる場合があります。
experience.adobe.comにログインし、Targetを選択します
- Targetホームから Adminstration -> Implementation -> Copy Client Code を選択します
- Implementationページを下にスクロールして Profile API セクションに移動します。必要に応じて Require Authentication をクリックして有効にします。その後、Generate Authentication Token をクリックしてトークンをコピーし、コネクタ設定用に保存します。
クエリを実行する前に、TD Consoleでデータ接続を作成および設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。次の手順を実行してください。
- TD Consoleを開きます。
- Integrations Hub > Catalog に移動します。
- Adobe Target を検索して選択します。アイコンにカーソルを合わせて Create Authentication を選択します。
- Credentials タブが選択されていることを確認し、統合の認証情報を入力します。以下のいずれかを選択してください。
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からデータをエクスポートするには、次の手順に従ってください。
- Data Workbench > Queries に移動します。
- New Query を選択し、クエリを定義します。
- Export Results を選択してデータのエクスポートを設定します。
- 既存のAdobe Target認証を選択するか、前述の方法で新しい認証を作成します。
- Done を選択します。
| Field | Description |
|---|---|
| Bulk Update API Version | 使用するAPIバージョン。 - v1: バルクプロファイル更新のみをサポート。(mbox.idはv1のみでサポート) - v2 (デフォルト): プロファイルが見つからない場合は作成します。 |
| Guaranteed Upload | Adobe Targetコネクタはファイルごとにプロファイルデータファイルをアップロードします。チェックすると、次のファイルをアップロードする前に、Adobe Serverサイドで最後にアップロードされたファイルの処理が正常に完了するまで待機します。 |
| Skip invalid records? | チェックすると、無効なレコードをスキップして次のレコードの処理を続行します。チェックしない場合、ジョブは停止します。 |
Adobe Targetにユーザープロファイルデータを正常にアップロード/変更するには、特定のデータ仕様に準拠したエクスポートクエリを作成する必要があります。
| 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を使用して結果をAdobe Targetにエクスポートすることもできます。
td queryコマンドの--resultオプションを使用して、Adobe Targetサーバーへのエクスポート情報を指定する必要があります。td queryコマンドの詳細については、この記事を参照してください。
オプションの形式はJSONで、一般的な構造は次のとおりです。
type: 'adobe_target'
client_code: xxxx
profile_api_token: xxxxx
api_version: v1
guaranteed_upload: false
skip_invalid_records: true$ 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 URLにedgeドメインを追加してください。Adobe Targetは、ユーザーの場所に関係なく応答時間を最適化するために、地理的に分散されたサービングアーキテクチャを実装しています。pcIdプロファイルは最も近いedgeにルーティングされます。データがルーティングされるedgeドメインのバッチアップロードステータスを確認してください。
詳細については、Adobe Targetのドキュメントを参照してください https://experienceleague.adobe.com/en/docs/target-dev/developer/implementation/privacy/allowlist-edges