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に送信される配列に含まれません。

マップ属性の送信

コネクタ構成では、アイデンティティ名前空間を持つマップ属性が必要になる場合があります。このデータを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を参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：1秒あたり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. Adobe Analyticsから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で、データ管理 > スキーマに移動し、スキーマの作成をクリックします。
2. スキーマの詳細セクションで、リアルタイムデータ構成のためにExperience Eventオプションを選択し、次へをクリックします。
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 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つがあります。データセット優先はデータセットに基づいてフラグメントを優先し、タイムスタンプ順は最も最近のフラグメントを優先します。

アイデンティティスティッチングは、データフラグメントを識別し、それらを組み合わせて完全なプロファイルレコードを形成するプロセスです。アイデンティティスティッチングのためのプロファイルをマージする方法には、「なし」と「プライベートグラフ」の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 の値をクリックしてエラーの詳細を表示します。

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