Adobe Experience Platform コネクタ構成ガイド

Adobe Experience Platform Edge Networkは、顧客がAdobe Experience CloudまたはAdobe Experience Platform Edgeサービスと対話するための最適化された方法を提供します。

APIはライブラリのロードに依存しないため、Adobe Experience Platform Edge Networkおよびサポートされるソリューション（Adobe Analytics、Adobe Audience Manager、Adobe Targetなど）との対話を高速に行うことができます。

動作原理

Adobe Experience Platform コネクタは、Adobe Experience Platform サービスとの対話を最適化する方法を提供します。このコネクタはイベントデータをAdobe Experience Platformを通じてAdobe Experience Cloudサービス（Adobe Analytics、Adobe Audience Manager、Adobe Target、Adobe CDPなど）に送信します。

データタイプ

Adobe Experience Platform コネクタは、すべてのTealiumデータタイプをサポートしていますが、データをAdobeに送信する前にコネクタ内で配列とマップが変換されます。

オブジェクトの配列のマッピング

動的な長さのオブジェクトの配列をマッピングするために、コネクタはオブジェクト属性ごとに1つの配列を受け入れます。その後、これらのプロパティを整形されたJSONオブジェクトの配列にマージします。

例えば、Adobe Analyticsのリストを送信したい場合、このコネクタを使用してオブジェクトの配列としてデータを送信できます。コネクタは以下の方法でリストをマッピングします：

• _experience.analytics.customDimensions.lists.list1.list.key を ['productCategories','productCategories','productCategories'] に
• _experience.analytics.customDimensions.lists.list1.list.value を ['clothing','shoes','accessories'] に

コネクタはこれらの配列を以下のJSON形式にマージします：

"xdm": {
    "_experience": {
        "analytics": {
            "customDimensions": {
                "lists": {
                    "list1": {
                        "list": [
                            {
                                "key": "productCategories",
                                "value": "clothing"
                            },
                            {
                                "key": "productCategories",
                                "value": "shoes"
                            },
                            {
                                "key": "productCategories",
                                "value": "accessories"
                            }
                        ]
                    }
                }
            }
        }
    }
}

オプションの空の配列値をコネクタに渡すと、コネクタは対応するオブジェクトの属性で空の値を渡します。例えば、experience.analytics.customDimensions.lists.list1.list.key を ['clothing','','accessories'] にマッピングした場合、リスト配列の2番目のオブジェクトには属性キーが存在しません。

スキーマが属性を必要としており、配列に含まれていない場合、そのオブジェクト全体はAdobeに送信される配列に含まれません。

マップ属性の送信

コネクタ構成では、ID名前空間を持つマップ属性が必要になる場合があります。このデータをAdobeに送信するには、文字列、数字、および文字列の配列属性を使用します。数値には文字列または文字列の配列を使用することをお勧めします。なぜなら、数値の配列にはnullまたは空の値を含めることができないからです。

例えば、以下の segmentMembership の値をAdobeに送信したい場合：

"segmentMembership":{
   "Email":{
      "a@example.com":{
        "version": 1,
      },
      "b@example.com":{
        "status": "exited"
      },
      "c@example.com":{
        "version": 3,
        "status": "in"
      },
   }
}

コネクタで以下の配列をマッピングする必要があります：

• segmentMembership.Email: ["a@example.com","b@example.com","c@example.com"]
• segmentMembership.Email.version: ["1", "", "3"] (2番目のメールのために空の値を含む文字列の配列)
• segmentMembership.Email.status: ['', 'exited', 'in'] (1番目のメールのために空の値を含む)
• segmentMembership.Email.validUntil: null

API情報

このコネクタは以下のベンダーAPIを使用します：

• API名: Adobe Experience Platform API
• APIバージョン: v2.0
• APIエンドポイント: https://server.adobedc.net/ee/v2/interact
• ドキュメント: Adobe Experience Platform API

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数: 秒間6000
• 最古のリクエストからの最大時間: 15分
• リクエストの最大サイズ: 64 KB

コネクタアクション

構成の構成

TealiumでAdobe Experience Platformコネクタを構成する前に、Adobe Developer Consoleで認証情報を生成するために次の手順を完了する必要があります。

1. 新しいAdobe Developer Consoleプロジェクトを作成するか、既存のプロジェクトを使用します。Projects Overviewを参照してください。
2. プロジェクト認証情報に関連付けたいサービスをプロジェクトに追加します。Services Overviewを参照してください。このコネクタには次のAdobeサービスが必要です：
   • Experience Platform API
   • I/O Events
3. サービスをプロジェクトに追加した後、プロジェクト認証情報にアクセスできます。Credentialsを参照してください。プロジェクト概要に移動し、Credentials セクションで OAuth Server-to-Server を選択します。 このコネクタに必要な認証情報は次のとおりです：
   • クライアントID（APIキー）
   • クライアントシークレット
   • 組織ID
4. 認証情報をメモして、コネクタの構成を完了するためにTealiumに戻ります。
5. Tealiumでコネクタマーケットプレースに移動し、新しいコネクタを追加します。コネクタの追加方法についての一般的な説明については、About Connectorsを参照してください。
6. コネクタを追加した後、前の手順で生成した認証情報を使用して次の構成を構成します：
   • クライアントID
     (必須) クライアントID。
   • クライアントシークレット
     (必須) クライアントシークレット。
   • 組織ID
     (必須) 組織ID。
   • Sandbox
     (オプション) APIコールがデフォルトの環境（prod）以外の環境を参照する場合は、次のフィールドに指定してください。

アクション

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

イベント送信

パラメータ

イベント送信（バッチ処理）

パラメータ

ストリームレコードデータ

パラメータ

ストリームレコードデータ（バッチ処理）

パラメータ

使用例

Adobe Analyticsへの分析データの送信

Adobe Experience Platformコネクタを使用してAdobe Analyticsに分析データを送信するには、まずAdobe Experience PlatformでXDMスキーマ、データストリーム、およびサービスを構成する必要があります。Adobeの構成を完了した後、Tealiumでコネクタを構成できます。

XDMスキーマ

Adobe Experience Edgeにデータを送信する際は、Adobe XDMスキーマに準拠していることを確認する必要があります。Adobe Analyticsがイベントを受信すると、ページビューやリンクイベントなど、より構造化されたデータに変換され、簡単に管理できるようになります。XDMデータとAdobe Analyticsについての詳細は、Adobe AnalyticsをAdobe Experience Platform Edgeと共に実装するを参照してください。

ページビューとリンクイベントが適切に処理されるように、AdobeはデータがAdobe Experience Edgeネットワークに送信される前に特定のロジックを適用します。このロジックにより、データが適切にフォーマットされ、必要な変換や集約が適用され、データがXDMスキーマに準拠することが保証されます。その後、データは処理と分析のためにAdobe Analyticsに転送されます。

以下の表は、XDMペイロードのデータ例と、スキーマに基づいてAdobe Analyticsがどのようにデータを解釈するかを示しています：

Adobe Analyticsにデータを送信するために使用できる異なる変数の完全なリストについては、Adobe Experience EdgeでのAnalytics変数マッピングを参照してください。

次の例は、変数 web.webPageDetails.name と experience データがAdobe Analyticsに送信される際のフォーマットを示しています：

"xdm": {
  "web": {
    "webPageDetails": {
      "name": "Home Page"
    }
  },
  "_experience": {
    "analytics": {
      "customDimensions": {
        "props": {
          "prop1": "value1"
        },
        "eVars": {
          "eVar1": "value2"
        }
      }
    }
  }
}

Adobe Experience Platformの構成

1. Adobe Experience Platformで、Data Management > Schemasに移動し、Create Schemaをクリックします。
2. Schema Detailsセクションで、Experience Eventオプションを選択し、Nextをクリックします。
3. スキーマの名前を入力し、Finishをクリックします。
4. Data Management > Schemasで、作成したばかりのスキーマを選択します。
5. スキーマの詳細画面で、Field groupsセクションに移動し、Addをクリックします。Adobe Analytics ExperienceEvent Templateを選択し、Saveをクリックします。

   

6. Data Collection > Datastreamsに移動し、データストリーミングに使用したいデータストリームを選択し、画面右側のEditボタンをクリックします。まだデータストリームを構成していない場合は、新しいものを作成できます。
7. データストリームのConfigure画面で、作成したばかりのEvent Schemaを選択し、Saveをクリックします。

   

8. Datastreams画面で、Add Serviceをクリックし、ドロップダウンリストからAdobe Analyticsオプションを選択し、Add Report Suiteをクリックします。
9. Report Suite IDを入力し、Saveをクリックします。レポートスイートIDは、Adobe Analytics > Admin > Report Suitesに移動して見つけることができます。

Adobe Experience Platform Datastream、サービス、スキーマの構成についての詳細は、Adobeのドキュメントの次の記事を参照してください：

• Datastreamの構成
• UIでスキーマを作成および編集する
• Adobe Analyticsの構成
• Analyticsフィールドマッピング

TealiumでAdobe Experience Platformコネクタを構成する

1. 構成の構成セクションでAdobe Experience Platformコネクタの構成手順を完了します。
2. Actionステップで、使用するアクションを選択します。
3. 次のパラメータでアクションを構成します：
   • Datastream ID: 以前に作成したデータストリームIDを選択します。
   • XDM Schema: 対応するデータストリームのXDMスキーマを選択します。Adobe Experience Platformでは、データストリームはすでに単一のXDMスキーマにリンクされているはずです。このスキーマはドロップダウンリストで確認できるはずです。
   • Identity Namespaces: マップしたい名前空間を選択します。プロファイルの断片間でレコードデータを照合する際、Adobe Experience Platformはアイデンティティ値と名前空間を使用してプロファイルデータをマージします。XDMスキーマに identityMap のようなマップオブジェクトが含まれている場合、名前空間を選択する必要があります。
   • XDM Schema Parameters: XDMスキーマパラメータに関連付ける属性を選択します。
     • _id: イベントを識別するランダムな一意のIDです。このIDにマップする特定の属性がない場合は、tealium_randomを使用します。
     • timestamp: イベントが発生した瞬間を表すUTCタイムスタンプです。予想される形式は YYYY-MM-DDTHH:MM:SSZです。
     • マップする必要がある追加の属性を追加します。Adobe Analyticsにデータを送信するために使用できる異なる変数の完全なリストについては、Adobe Experience EdgeでのAnalytics変数マッピングを参照してください。
4. Finishをクリックします。

次の画像はTealiumでの例示的なマッピングを示しています：

Adobe Audience Managerにオーディエンスデータを送信する

Adobe Experience Platformコネクタを使用してAdobe Audience Managerにオーディエンスデータを送信するには、まずAdobe Experience PlatformでXDMスキーマの詳細を構成する必要があります。Adobeの構成を完了した後、Tealiumでコネクタを構成できます。

Adobe Audience ManagerとXDMフィールドのマッピングの完全なリストについては、AdobeのドキュメントのAudience Managerフィールドマッピングを参照してください。

次の例は、オーディエンスデータがAdobe Audience Managerに送信される際にXDMスキーマにマッピングされる方法を示しています。

  "xdm": {
      "identityMap": {
        "ECID": {
          "_id": "12345"
        },
        "CORE": {
          "_id": "67890"
        }
      },
      "segmentMemberships": {
        "AAMTraits": ["trait1", "trait2"],
        "AAMSegments": ["segment1", "segment2"]
      },
      "profileStitch": [],
      "device": {
        "type": "desktop"
      },
      "placeContext": {
        "geo": {
          "countryCode": "US"
        }
      },
      "environment": {
        "browserDetails": {
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3"
        }
      }
  }

Adobe Experience Platformの構成

Adobe Audience Managerは、Experience EventとIndividual Profileスキーマを使用して、リアルタイムデータとプロファイルデータの2種類のデータを受け入れます。以下の例は、Experience EventのユースケースにAdobe Experience Platformを構成する方法を示しています。Individual Profileを使用する場合は、以下の手順を完了して、ステップ2でIndividual Profileオプションを選択してください。

1. Adobe Experience Platformで、Data Management > Schemas に移動し、Create Schema をクリックします。
2. Schema Details セクションで、リアルタイムデータ構成のために Experience Event オプションを選択し、Next をクリックします。
3. スキーマの名前を入力し、Finish をクリックします。
4. Data Management > Schemas で、作成したばかりのスキーマを選択します。
5. スキーマの詳細画面で、Field groups セクションに移動し、Adobe Audience Manager Template を選択して Save をクリックします。

   

6. Data Collection > Datastreams に移動し、データストリーミングに使用するデータストリームを選択し、画面右側の Edit ボタンをクリックします。まだデータストリームが構成されていない場合は、新しいものを作成できます。
7. データストリームの Configure 画面で、作成したばかりの Event Schema を選択し、Save をクリックします。
8. Datastreams 画面で、Add Service をクリックし、ドロップダウンリストから Adobe Audience Manager オプションを選択して Save をクリックします。

Adobe Experience Platform Datastream、サービス、スキーマの構成に関する詳細は、Adobeのドキュメントの以下の記事を参照してください：

• データストリームの構成
• UIでスキーマを作成および編集する
• Adobe Audience Manager
• Adobe Audience Managerフィールドマッピング

TealiumでAdobe Experience Platformコネクタを構成する

Adobe Audience Managerにデータを送信するためにコネクタを構成するには、TealiumでAdobe Experience Platformコネクタを構成するセクションの手順を完了してください。

Adobe Audience Managerで利用可能なデータマッピングとそれに対応するXDMフィールドについての詳細は、AdobeのドキュメントのAudience Managerフィールドマッピングを参照してください。

Adobe Targetにデータを送信する

Adobe Experience Platformコネクタを使用してAdobe Targetにオーディエンスデータを送信するには、まずAdobe Experience PlatformでXDMスキーマの詳細を構成する必要があります。Adobeの構成を完了した後、Tealiumでコネクタを構成できます。

Adobe TargetとXDMフィールドマッピングの完全なリストについては、AdobeのドキュメントのAudience Targetフィールドマッピングを参照してください。

以下の例は、Adobe Targetに送信されたデータがXDMスキーマにどのようにマッピングされるかを示しています。

"xdm": {
        "channel": {
            "_id": "web"
        },
        "environment": {
            "browserDetails": {
                "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3"
            }
        },
        "_experience": {
            "target": {
                "clientCode": "adobetarget",
                "mboxName": "mbox1",
                "activities": [
                    {
                        "activityID": "12345"
                    }
                ]
            }
        },
        "device": {
            "type": "desktop"
        },
        "placeContext": {
            "geo": {
                "countryCode": "US"
            }
        },
        "commerce": {
            "order": {
                "priceTotal": 100.0
            }
        },
        "web": {
            "webReferrer": {
                "url": "https://www.example.com"
            }
        }
    }

Adobe Identity Serviceへのプロファイリングデータの送信

Adobe Experience Platformコネクタを使用してプロファイリングデータをAdobe Identity Serviceに送信するには、まずAdobe Experience PlatformでXDMスキーマの詳細を構成する必要があります。Adobeの構成を完了した後、Tealiumでコネクタを構成できます。

Adobe Experience Platform内でIdentity Serviceを使用するための次の概念が役立ちます：

• Identity（アイデンティティ）：ログインID、ECID、ロイヤリティIDなど、個体（通常は個人）に固有のデータ。
• Identity namespaces（アイデンティティ名前空間）：アイデンティティのコンテキストまたはタイプを区別します。例えば、name@email.comをメールアドレスとして、または443522を数値のCRM IDとして区別します。アイデンティティ名前空間は個々のアイデンティティを検索し、アイデンティティ値のコンテキストを提供するために使用されます。これにより、異なる主要IDを持つがメールアイデンティティ名前空間で同じ値を共有する2つのプロファイル断片が同一の個人であると判断できます。
• Identity Graph（アイデンティティグラフ）：異なるアイデンティティ間の関係のマップで、どの顧客アイデンティティがどのように繋がっているかを視覚化し、よりよく理解することができます。グラフはIdentity Serviceによって自動的に作成され、異なるアイデンティティ名前空間をマッピングし、異なるチャネルを通じて顧客がブランドとどのようにやり取りしているかの視覚的表現を提供します。
• Experience Cloud ID (ECID)：Adobe Experience PlatformとAdobe Experience Cloudアプリケーション全体で使用される共有アイデンティティ名前空間です。ECIDは顧客アイデンティティの基盤を提供し、デバイスの主要IDおよびアイデンティティグラフの基本ノードとして使用されます。

マージポリシー

Adobe Experience Platformでは、複数のソースからデータ断片をまとめて、個々の顧客の完全なビューを作成することができます。マージポリシーは、Adobe Experience Platformがデータを優先する方法と、顧客の統合ビューを作成するためにどのデータを組み合わせるかを決定するルールのセットです。

各プロファイル断片には、個人に存在可能なアイデンティティのうちの1つのアイデンティティに関する情報のみが含まれています。そのデータを組み合わせて顧客プロファイルを形成する際には、情報が競合する可能性があり、優先順位を指定する必要があります。

マージ方法を選択することで、データセット間でマージ競合が発生した場合に優先するデータセット属性を指定できます。マージ方法には、データセット優先とタイムスタンプ順があります。データセット優先はデータセットに基づいて断片を優先し、タイムスタンプ順は最新の断片を優先します。

アイデンティティスティッチングは、データ断片を識別し、それらを組み合わせて完全なプロファイルレコードを形成するプロセスです。アイデンティティスティッチングのためのプロファイルをマージする方法には、「なし」と「プライベートグラフ」の2つの方法があります。なしを選択すると、単一の顧客が複数のプロファイルを持つことがあり、異なるオーディエンスに適格であり、複数のマーケティングメッセージが発生する可能性があります。プライベートグラフを選択すると、同一個人に関連する複数のアイデンティティがステッチされ、単一のプロファイルと1つのマーケティングメッセージが生成されます。

次の例は、アイデンティティデータがAdobe Identity Serviceに送信されたときにXDMスキーマにどのようにマッピングされるかを示しています。Adobe Identity Serviceは、メールアドレスmyemail@example.comを持つプロファイルを検索します。一致するプロファイルが見つかると、myNEWemail@example.comのメールアドレスと77828292900000の電話番号を追加します。Identity Serviceが一致するものを見つけられない場合、両方のメールアドレスと電話番号を持つ新しいプロファイルを作成します。

{
    "_id": "gjsadfghdfkyweiu2ydudyieds3wuyi2kadsjlksddrdesdhslksdwqe",
    "timestamp": "2023-11-17T02:59:57Z",
    "identityMap": {
        "Email": [
          {
            "id": "myemail@example.com",
            "primary": true
          }
        ]
      },
      "personalEmail": {
        "address": "myNEWemail@example.com"
      },
      "mobilePhone": {
        "number": "77828292900000"
      }
    }
}

Adobe Experience PlatformでIdentity Serviceを構成する方法についての詳細は、Adobeのドキュメントの次の記事を参照してください：

• Identity Service Overview
• Identity Namespace Overview
• Merge Policies Overview
• Adobe Data Collection

Adobe Experience Platformの構成

Adobe Experience Platformで顧客データを更新するには、Adobe製品全体からのデータのスティッチングが必要になる場合があります。たとえば、Adobe Journey Optimizerで実行されているメールキャンペーンのためにプロファイルが作成され、その後、Interactive Data Collectionエンドポイントを通じて送信された異なるイベントで更新される場合があります。

1. Adobe Experience PlatformでData Management > Schemasに移動し、使用するスキーマを選択するか、Create Schemaをクリックして新しいスキーマを作成します。
   • 新しいスキーマ
     1. Schema Detailsセクションで、Experience EventまたはIndividual Profileオプションを選択し、Nextをクリックします。
     2. スキーマの名前を入力し、Finishをクリックします。
   • 既存のスキーマ
     1. スキーマの詳細画面で、Field groupsセクションに移動し、Personal Contact Detailsを選択してSaveをクリックします。
     2. このスキーマを使用するときに更新したいプロファイル属性を追加します。たとえば、メールアドレスと電話番号を追加するには：
        • personalEmailプロパティを展開し、addressをクリックし、スキーマ画面の右側にあるField PropertiesセクションでIdentityチェックボックスをクリックします。
        • mobilePhoneプロパティを展開し、numberをクリックし、スキーマ画面の右側にあるField PropertiesセクションでIdentityチェックボックスをクリックします。
2. Saveをクリックします。

   

3. Data Management > Datasetsに移動し、Create Datasetをクリックします。
4. Create Dataset from Schemaをクリックし、リストからスキーマを選択してNextをクリックします。
5. データセットの名前を入力し、Finishをクリックします。
6. Customer > Profilesに移動し、Merge Policiesタブを選択してCreate merge policyをクリックします。
7. スキーマ名を入力します。スキーマクラスをXDM Individual Profileとして、IDスティッチングをPrivate Graphとして残し、Saveをクリックします。
8. Connection > Sourcesに移動し、Adobe Data Collectionを検索してSet Upをクリックします。

詳細については、Adobe Data Collectionを参照してください。

TealiumでAdobe Experience Platformコネクタを構成する

Adobe Identity Serviceにデータを送信するためにコネクタを構成するには、TealiumでAdobe Experience Platformコネクタを構成するセクションの手順を完了します。

イベントエクスペリエンススキーマを使用している場合は、Send Eventアクションを作成します。個々のプロファイルスキーマを使用している場合は、Stream Record Dataアクションを作成する必要があります。

次の画像はTealiumでの例示的なマッピングを示しています：

Adobe Experience Platformでプロファイル更新を確認する

Adobe Experience Platformで更新されたプロファイルを確認するには、Customer > Profilesに移動します。すべてのプロファイル属性を表示するには、Attributesタブをクリックします。

Adobe Experience Platformでイベントコールをデバッグする

イベントコールをデバッグするには、Connection > Sources に移動し、Dataflows タブをクリックします。

データストリーム用に自動的に作成されたデータフローをクリックし、レコードが失敗しているかどうかを確認します。イベントが処理されていない場合、データフローはまだ表示されないかもしれません。

エラーが見つかった場合は、Dataflow Run Start の値をクリックしてエラーの詳細を表示します。

この例では、イベントが処理されていないのは、タイムスタンプの形式が正しくないためです。