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'] (最初のメールのために空の値を含む)
• 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

構成

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

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

アクション

イベント送信

パラメータ

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

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチ処理アクションを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：6,000
• 最古のリクエストからの最大時間：15分

パラメータ

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

パラメータ

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

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチ処理アクションを参照してください。次のいずれかの閾値に達するか、プロファイルが公開されるまでリクエストはキューに入れられます：

• 最大リクエスト数：6,000
• 最古のリクエストからの最大時間：60分
• リクエストの最大サイズ：1 MB

パラメータ

使用例

Adobe Analyticsにアナリティクスデータを送信

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

XDMスキーマ

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

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

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

Adobe Analyticsにデータを送信するために使用できるさまざまな変数の完全なリストについては、Analytics variable mapping in Adobe Experience Edgeを参照してください。

以下の例は、変数 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で、データ管理 > スキーマに移動し、スキーマの作成をクリックします。
2. スキーマの詳細セクションで、エクスペリエンスイベントオプションを選択し、次へをクリックします。
3. スキーマの名前を入力し、完了をクリックします。
4. データ管理 > スキーマで、作成したばかりのスキーマを選択します。
5. スキーマの詳細画面で、フィールドグループセクションに移動し、追加をクリックします。Adobe Analytics ExperienceEventテンプレートを選択し、保存をクリックします。

   

6. データ収集 > データストリームに移動し、データストリーミングに使用するデータストリームを選択し、画面右側の編集ボタンをクリックします。まだデータストリームが構成されていない場合は、新しいものを作成できます。
7. データストリームの構成画面で、作成したばかりのイベントスキーマを選択し、保存をクリックします。

   

8. データストリーム画面で、サービスの追加をクリックし、ドロップダウンリストからAdobe Analyticsオプションを選択し、レポートスイートの追加をクリックします。
9. Adobe AnalyticsからレポートスイートIDを入力し、保存をクリックします。レポートスイートIDは、Adobe Analytics > 管理 > レポートスイートに移動することで見つけることができます。

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

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

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

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

次の画像は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スキーマを使用してリアルタイムデータとプロファイルデータの両方を受け入れます。リアルタイムデータセットアップの場合はExperience Eventオプションを選択し、次の手順を完了します。Individual Profileを使用する場合は、ステップ2でIndividual Profileオプションを選択してください。

1. Adobe Experience Platformで、データ管理 > スキーマに移動し、スキーマの作成をクリックします。
2. スキーマの詳細セクションで、エクスペリエンスイベントオプションを選択し、次へをクリックします。
3. スキーマの名前を入力し、完了をクリックします。
4. データ管理 > スキーマで、作成したばかりのスキーマを選択します。
5. スキーマの詳細画面で、フィールドグループセクションに移動し、Adobe Audience Managerテンプレートを選択し、保存をクリックします。

   

6. データ収集 > データストリームに移動し、データストリーミングに使用するデータストリームを選択し、画面右側の編集ボタンをクリックします。まだデータストリームが構成されていない場合は、新しいものを作成できます。
7. データストリームの構成画面で、作成したばかりのイベントスキーマを選択し、保存をクリックします。
8. データストリーム画面で、サービスの追加をクリックし、ドロップダウンリストからAdobe Audience Managerオプションを選択し、保存をクリックします。

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 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 Target ExperienceEvent Templateを選択し、Saveをクリックします。

   

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

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

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

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

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

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

Adobe Identity Serviceにプロファイリングデータを送信する

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

Identity Serviceを使用するための次の概念が役立ちます：

• Identity: 個体、通常は個人に固有のデータで、ログインID、ECID、またはロイヤルティIDなどがあります。
• Identity namespaces: アイデンティティのコンテキストまたはタイプを区別します。たとえば、アイデンティティはname@email.comをメールアドレスとして区別したり、443522を数値のCRM IDとして区別します。Identity namespacesは個々のアイデンティティを検索し、アイデンティティ値のコンテキストを提供するために使用されます。これにより、異なる主要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つがあります。データセット優先はデータセットに基づいてフラグメントを優先し、タイムスタンプ順は最新のフラグメントを優先します。

アイデンティティスティッチングは、データフラグメントを識別し、それらを組み合わせて完全なプロファイルレコードを形成するプロセスです。アイデンティティスティッチングのためのプロファイルをマージする方法には、「なし」と「プライベートグラフ」の2つがあります。なしを選択すると、1人の顧客が複数のプロファイルを持つことがあり、異なるオーディエンスに適格であるため、複数のマーケティングメッセージが発生します。プライベートグラフを選択すると、同一個人に関連する複数のアイデンティティが繋がり、1つのプロファイルと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コネクタを構成するセクションの手順を完了してください。

Event Experienceスキーマを使用している場合は、Send Eventアクションを作成します。Individual Profileスキーマを使用している場合は、Stream Record Dataアクションを作成する必要があります。

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

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

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

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

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

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

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

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