ドキュメントExperience Platform宛先ガイド

エッジ上のプロファイル属性をリアルタイムで検索し

Last update: Tue Mar 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • ユーザー

Adobe Experience Platformは、すべてのプロファイルデータの信頼できる唯一の情報源として​ リアルタイム顧客プロファイル ​を使用します。 迅速かつリアルタイムのデータ取得のために、Edge Network全体に分散される軽量プロファイルである​ エッジプロファイル ​を使用します。 これにより、迅速なリアルタイムのパーソナライゼーションが可能になります。

ユースケース use-cases

ここでは、エッジプロファイル検索が有効な2つのユースケースを紹介します。

  • リアルタイム Personalization: エッジプロファイルからプロファイル情報をすばやく取得し、web サイトでのユーザーエクスペリエンスをパーソナライズします。
  • カスタマーサポート：お客様がサポートセンターの担当者に電話をかけると、リアルタイムでプロファイル情報を取得します。

このページでは、パーソナライゼーションエクスペリエンスの配信や、下流アプリケーションを通じた意思決定ルールの決定のために、エッジプロファイルデータをリアルタイムで検索するために従う必要がある手順について説明します。

用語と前提条件 prerequisites

このページで説明するユースケースを設定する場合は、次のExperience Platform コンポーネントを使用します。

パフォーマンスガードレール guardrails

Edge プロファイル ルックアップのユースケースには、次の表に記載されている特定のパフォーマンスガードレールが適用されます。 Edge Network APIのガードレールについて詳しくは、ガードレール ​ ドキュメントページ ​を参照してください。

Edge Network Service
エッジセグメント化
リクエスト/秒
Edge Network API経由の​ カスタムパーソナライゼーションの宛先
○
1500
Edge Network API経由の​ カスタムパーソナライゼーションの宛先
×
1500

手順1：データストリームの作成と設定 create-datastream

​ データストリーム設定 ドキュメントの手順に従って、次の​ Service ​設定を持つ新しいデータストリームを作成します。

  • Service：Adobe Experience Platform
  • Personalization Destinations：有効
  • Edge Segmentation: エッジのセグメント化が必要な場合は、このオプションを有効にしてください。 エッジ上のプロファイル属性のみを検索し、エッジプロファイルに基づいてセグメント化を実行しない場合は、このオプションを無効のままにします。

データストリーム設定画面を示す Experience Platform UI イメージ。

手順2：エッジ評価用にオーディエンスを設定する audience-edge-evaluation

エッジでプロファイル属性を検索するには、オーディエンスをエッジ評価用に設定する必要があります。

アクティブ化するオーディエンスに、Active-on-Edge結合ポリシーがデフォルトとして設定されていることを確認します。 Active-On-Edge結合ポリシーにより、オーディエンスは常に​ エッジ ​で評価され、リアルタイムのパーソナライゼーションのユースケースで利用できるようになります。

「結合ポリシーの作成」の指示に従い、Active-On-Edge Merge Policy​切り替えを必ず有効にしてください。

IMPORTANT
オーディエンスが別の結合ポリシーを使用している場合、エッジからプロファイル属性を取得できず、エッジプロファイル検索を実行できません。

手順3：プロファイル属性データをEdge Networkに送信する configure-custom-personalization-connection

属性やオーディエンスメンバーシップデータを含むエッジプロファイルをリアルタイムで検索するには、データをEdge Networkで利用できる必要があります。 この目的のために、Custom Personalization With Attributes​宛先への接続を作成し、エッジプロファイルで検索する属性を含むオーディエンスをアクティブ化する必要があります。

カスタム Personalizationと属性接続の設定

新しい宛先接続の作成方法に関する詳細な手順については、宛先接続の作成チュートリアルに従ってください。

新しい宛先を設定する際に、手順1で作成したデータストリームを​Datastream ID フィールドで選択します。 Integration alias​では、宛先名など、今後この宛先接続を特定するのに役立つ任意の値を使用できます。

属性を含むカスタム Personalizationの設定画面を示すExperience Platform UIの画像。

カスタム Personalizationの属性コネクションへのオーディエンスのアクティベート

Custom Personalization With Attributes​接続を作成したら、Edge Networkにプロファイルデータを送信する準備が整いました。

note important
IMPORTANT
アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

  1. Connections > Destinations​に移動し、「Catalog」タブを選択します。

    Experience Platform UIで「 宛先カタログ」タブが強調表示されます。

  2. 次の画像に示すように、Custom Personalization With Attributes​宛先カードを検索し、Activate audiences​を選択します。

    カタログ内の宛先カードでハイライト表示されたオーディエンスコントロールをアクティブ化します。

  3. 以前に設定した宛先接続を選択し、Next​を選択します。

    アクティブ化ワークフローで宛先ステップを選択します。

  4. オーディエンスの選択。 オーディエンス名の左側にあるチェックボックスを使用して、宛先に対してアクティブ化するオーディエンスを選択し、Next​を選択します。

    配信元に応じて、複数のタイプのオーディエンスから選択できます。

    • Segmentation Service: Segmentation ServiceによってExperience Platform内で生成されたオーディエンス。 詳しくは、​ セグメント化ドキュメント ​を参照してください。

    • Custom upload: Experience Platform以外で生成され、CSV ファイルとしてExperience Platformにアップロードされたオーディエンス。 外部オーディエンスについて詳しくは、​ オーディエンスの読み込みに関するドキュメントを参照してください。

    • その他の種類のオーディエンスは、Audience Managerなど、他のAdobe ソリューションから作成されています。

      複数のオーディエンスがハイライト表示されたアクティベーション ワークフローの「オーディエンスを選択」ステップ。

  5. エッジプロファイルで使用できるようにしたいプロファイル属性を選択します。

    • ソース属性を選択。 ソース属性を追加するには、Add new field​列の​Source field コントロールを選択し、次に示すように、目的のXDM属性フィールドを検索または移動します。

      マッピング手順でターゲット属性を選択する方法を示す 画面の録画。

    • ターゲット属性を選択。 ターゲット属性を追加するには、Add new field​列の​Target field コントロールを選択し、ソース属性をマッピングするカスタム属性名を入力します。

      マッピング手順でXDM属性を選択する方法を示す画面録画

プロファイル属性のマッピングが完了したら、Next​を選択します。

Review ページで、選択内容の概要を表示できます。 Cancel​を選択してフローを分割し、Back​を選択して設定を変更するか、Finish​を選択して選択を確定し、Edge Networkへのプロファイルデータの送信を開始します。

レビュー手順の 選択の概要

同意ポリシーの評価

お客様の組織が​ Adobe Healthcare Shield ​または​ Adobe Privacy & Security Shield ​を購入した場合、View applicable consent policies​を選択して、適用される同意ポリシーと、その結果としてアクティベーションに含まれるプロファイルの数を確認します。 詳しくは、同意ポリシーの評価を参照してください。

データ使用ポリシーチェック

Review ステップでは、Experience Platformもデータ使用ポリシー違反をチェックします。 ポリシーに違反した場合の例を次に示します。オーディエンスのアクティベーション ワークフローを完了するには、違反を解決する必要があります。 ポリシー違反を解決する方法について詳しくは、「データガバナンスのドキュメント」セクションの​ データ使用ポリシー違反を参照してください。

データポリシー違反の例。

オーディエンスを絞り込む

Review ステップでは、ページで使用可能なフィルターを使用して、このワークフローの一部としてスケジュールまたはマッピングが更新されたオーディエンスのみを表示できます。 表示するテーブル列を切り替えることもできます。

レビューステップで使用可能なオーディエンスフィルターを表示する画面の録画。

選択に満足しており、ポリシー違反が検出されていない場合は、Finish​を選択して選択を確認します。

手順4：エッジのプロファイル属性を検索する configure-edge-profile-lookup

これで、​ データストリームの設定が完了し、属性を含む新しいカスタム Personalization destination connectionが作成され、このconnectionを使用して​ プロファイル属性を送信し、Edge Networkを検索できるようになりました。

次の手順では、エッジプロファイルからプロファイル属性を取得するようにパーソナライゼーションソリューションを設定します。

IMPORTANT
プロファイル属性には、機密データが含まれる場合があります。 このデータを保護するには、Edge Network APIを使用してプロファイル属性を取得する必要があります。 さらに、API呼び出しを認証するには、Edge Network API interactive data collection endpointを介してプロファイル属性を取得する必要があります。
上記の要件に従わない場合、パーソナライゼーションはオーディエンスメンバーシップのみに基づいて行われ、プロファイル属性は利用できません。

手順1で設定したデータストリームは、受信イベントデータを受け入れ、エッジプロファイル情報で応答する準備が整いました。

次の例に示すように、統合を設定してエッジプロファイル情報を取得します。

リクエスト request

エッジプロファイルデータを取得するには、次に示すように、イベントに含まれるプロファイル属性を検索するプライマリ IDを使用して、POST エンドポイントに空の/interact呼び出しを送信します。

curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
    "event":
    {
        "xdm": {
            "identityMap": {
                "Email": [
                    {
                        "id":"test123@adobetest.com",
                        "primary":true
                    }
                ]
            }
        }
    }

}'
パラメーター
タイプ
必須
説明
dataStreamId
String
はい。
手順1で作成したデータストリームのデータストリーム ID。

応答 response

応答が成功すると、プロファイルがエッジで見つかったかどうかに応じて、以下のタブの例に似た情報を含む200 OK オブジェクトを含むHTTP ステータス Handleが返されます。

NOTE
API応答はモジュール式であり、handle オブジェクトには、様々なタイプの複数のpayload オブジェクトを含めることができます。 エッジプロファイル検索に関連する情報は、payloadを持つ"type": "activation:pull" オブジェクトの下にグループ化されます。
プロファイルはエッジに存在します

プロファイルがエッジに存在する場合、エッジにアクティブ化されたプロファイル属性とオーディエンスに応じて、次のような属性とオーディエンスメンバーシップを持つ応答が期待できます。

code language-json 
{
  "requestId": "3c600138-d785-42ca-a025-bb725f4b5da9",
  "handle": [
    {
      "payload": [
        {
          "type": "profileLookup",
          "destinationId": "9218b727-ec59-4a46-b8b9-05503f138c5d",
          "alias": "rk-demo-custom-personalization-XXXX",
          "attributes": {
            "zip": {
              "value": "19000"
            },
            "firstName": {
              "value": "Test"
            },
            "lastName": {
              "value": "User123"
            },
            "gender": {
              "value": "male"
            },
            "city": {
              "value": "Philadelphia"
            },
            "state": {
              "value": "PA"
            },
            "email": {
              "value": "test123@adobetest.com"
            }
          },
          "segments": [
            {
              "id": "85018bd8-7ad1-4e17-ae30-8389c04bd3c0",
              "namespace": "ups"
            },
            {
              "id": "d09a8159-8b30-4178-b2f2-7a8c5e3168d9",
              "namespace": "ups"
            }
          ]
        }
      ],
      "type": "activation:pull",
      "eventIndex": 0
    }
  ]
}

handle オブジェクトは、次の表に示す情報を提供します。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto
パラメーター 説明
payload エッジ検索情報を含むpayload オブジェクト。 応答には、エッジルックアップに関係なく、複数の追加payload オブジェクトが含まれる場合があります。
type ペイロードは、応答でタイプ別にグループ化されます。 エッジプロファイル検索のペイロードタイプは常にprofileLookupに設定されます。
destinationId Custom Personalization​手順3で作成した接続インスタンスのID。
alias 宛先接続のエイリアス。ユーザーが​ カスタム Personalization宛先接続を作成するときに設定します。
attributes この配列には、手順3でアクティブ化したオーディエンスのエッジプロファイル属性が含まれます。
segments この配列には、手順3でアクティブ化したオーディエンスが含まれます。
type handle個のオブジェクトがタイプ別にグループ化されています。 エッジプロファイル検索のユースケースの場合、handle オブジェクトのタイプは常にactivation:pullです。
eventIndex Edge Networkは、クライアントから配列の形式でイベントを受け取ります。 配列内のイベントの順序は、処理中に保持され、このインデックスによって反映されます。 イベントのインデックス作成は0で始まります。
プロファイルがエッジに存在しません

プロファイルがエッジに存在しない場合は、次のような応答が期待できます。

code language-json 
{
  "requestId": "531b541a-4541-419e-ac99-fd7e452f0c0f",
  "handle": [
    {
      "payload": [],
      "type": "activation:pull",
      "eventIndex": 0
    }
  ]
}

handle オブジェクトは、次の表に示す情報を提供します。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
パラメーター 説明
payload プロファイルがエッジに存在しない場合、payload オブジェクトは空です。
type payload個のオブジェクトがタイプ別にグループ化されています。 エッジプロファイル検索のユースケースの場合、payload オブジェクトのタイプは常にactivation:pullです。
eventIndex Edge Networkは、クライアントから配列の形式でイベントを受け取ります。 配列内のイベントの順序は、処理中に保持され、このインデックスによって反映されます。 イベントのインデックス作成は0で始まります。
SUCCESS
統合が正しく設定されていれば、エッジプロファイルデータにアクセスできるようになり、エッジプロファイルの属性とオーディエンスメンバーシップを使用して、ダウンストリームパーソナライゼーションエンジンでリアルタイムのパーソナライゼーションをトリガーできます。

まとめ conclusion

上記のステップに従うことで、エッジプロファイル属性をリアルタイムで効率的に検索し、下流のアプリケーションでパーソナライズされたエクスペリエンスと情報にもとづいた意思決定を実現できます。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6