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に送信される前にコネクタ内で変換されます。

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

動的な長さのオブジェクトの配列をマッピングするために、コネクタはオブジェクト属性ごとに配列を受け入れます。その後、コネクタはこれらのプロパティを整形された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'] (最初のメールに対して空の値を含む。)
• 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

バッチ制限

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

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

コネクタアクション

構成の構成

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で、コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法についての一般的な指示については、コネクタについてを参照してください。
6. コネクタを追加した後、前の手順で生成した認証情報を使用して以下の構成を構成します：
   • クライアントID
     必須。クライアントID。
   • クライアントシークレット
     必須。クライアントシークレット。
   • 組織ID
     必須。組織ID。
   • サンドボックス
     任意。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 Experience Platform Edgeを使用したAdobe Analyticsの実装を参照してください。 ページビューやリンクイベントが適切に処理されるように、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": "ホームページ"
    }
  },
  "_experience": {
    "analytics": {
      "customDimensions": {
        "props": {
          "prop1": "value1"
        },
        "eVars": {
          "eVar1": "value2"
        }
      }
    }
  }
}

Adobe Experience Platformの構成

1. Adobe Experience Platformで、データ管理 > スキーマに移動し、スキーマ作成をクリックします。
2. スキーマ詳細セクションで、Experience Eventオプションを選択し、次へをクリックします。
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は2種類のデータを受け入れます：リアルタイムデータとプロファイルデータ、これらはExperience EventとIndividual Profileスキーマを使用します。以下の例は、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 Experience Platformの構成

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

   

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

Adobe Experience Platform datastream、サービス、スキーマの構成についての詳細は、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でコネクタを構成することができます。

以下の概念は、Adobe Experience Platform内のIdentity Serviceの使用を開始するのに役立ちます：

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

マージポリシー

Adobe Experience Platformでは、複数のソースからデータ断片をまとめて、各顧客の完全なビューを見ることができます。マージポリシーは、Adobe Experience Platformがデータをどのように優先し、どのデータを組み合わせて顧客の統一されたビューを作成するかを決定する一連のルールです。 各プロファイルフラグメントは、個々の人物に存在できるアイデンティティの総数のうちの1つだけの情報を含んでいます。そのデータを結合して顧客プロファイルを作成する際には、その情報が競合する可能性があり、優先順位を指定する必要があります。

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

アイデンティティのスティッチングは、データフラグメントを識別し、それらを結合して完全なプロファイルレコードを作成するプロセスです。アイデンティティのスティッチングには、NoneとPrivate Graphの2つの方法があります。Noneを選択すると、1人の顧客が複数のプロファイルを持ち、それぞれが異なるオーディエンスに適合する可能性があり、結果として複数のマーケティングメッセージが生成されます。Private Graphを選択すると、同一人物に関連する複数のアイデンティティがステッチされ、結果として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の概要
• Identity Namespaceの概要
• マージポリシーの概要
• 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の値をクリックしてエラーの詳細を表示します。

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