カスタムパーソナライゼーション接続

宛先の変更ログ

リリース月 更新タイプ 説明
2023年5月 機能とドキュメントの更新 2023 年 5 月現在、 カスタムパーソナライゼーション 接続サポート 属性ベースのパーソナライゼーション およびは、すべてのお客様が一般に利用できます。
重要

プロファイル属性には、機密データが含まれている場合があります。 このデータを保護するには、 カスタムパーソナライゼーション の宛先では、 Edge Network Server API 属性ベースのパーソナライゼーションの宛先を設定する際に使用します。 すべてのサーバー API 呼び出しは、 認証コンテキスト.


既に統合に Web SDK または Mobile SDK を使用している場合は、サーバー側の統合を追加して、Server API を介して属性を取得できます。


上記の要件に従わない場合、パーソナライゼーションはセグメントメンバーシップのみに基づきます。

概要

この宛先は、Adobe Experience Platform から外部のパーソナライゼーションプラットフォーム、コンテンツ管理システム、広告サーバーおよび顧客の web サイト上で実行されているその他のアプリケーションにセグメント情報を取得できます。

前提条件

この統合は、Adobe Experience Platform Web SDK または Adobe Experience Platform Mobile SDK によって実現されます。この宛先を使用するには、次の SDK のいずれかを使用する必要があります。

重要

カスタムパーソナライゼーション接続を作成する前に、次の手順に関するガイドをお読みください。 エッジパーソナライゼーションの宛先に対するオーディエンスデータのアクティブ化. このガイドでは、複数の Experience Platform コンポーネントをまたいで、同じページおよび次のページのパーソナライゼーションの使用例に必要な設定手順を説明します。

書き出しタイプ および頻度

項目 タイプ メモ
書き出しタイプ Profile request 単一のプロファイルに対して、カスタムパーソナライゼーションの宛先にマッピングされるすべてのセグメントを要求しています。 様々なカスタムパーソナライゼーションの宛先を様々な アドビのデータ収集データストリームに対して設定できます。
書き出し頻度 ストリーミング ストリーミングの宛先は常に、API ベースの接続です。セグメント評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。ストリーミングの宛先の詳細についてはこちらを参照してください。

宛先への接続

重要

宛先に接続するには、宛先の管理 アクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。

接続パラメーター

この宛先を設定するとき、次の情報を指定する必要があります。

  • 名前:この宛先に希望する名前を入力します。
  • 説明:宛先についての説明を入力します。例えば、この宛先を使用しているキャンペーンを指定できます。このフィールドはオプションです。
  • 統合エイリアス:この値は、JSON オブジェクト名として Experience Platform Web SDK に送信されます。
  • データストリーム ID:これにより、ページへの応答にセグメントを含めるデータ収集データストリームが決定されます。ドロップダウンメニューには、宛先設定が有効になっているデータストリームのみが表示されます。詳しくは、データストリームの設定を参照してください。

アラートの有効化

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の入力を終えたら「次へ」を選択します。

この宛先に対してセグメントをアクティブ化

重要

データをアクティブ化するには、宛先の管理宛先のアクティブ化プロファイルの表示​および​セグメントの表示に対するアクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

読み取り エッジパーソナライゼーションの宛先をアクティブ化する を参照してください。

書き出したデータ

Adobe Experience Platform のタグを使用して Experience Platform Web SDK をデプロイする場合、イベント完了の送信機能を使用すると、カスタムコードアクションには event.destinations 変数が追加され、書き出したデータを確認できます。

event.destinations 変数のサンプル値は次のようになります。

[
   {
      "type":"profileLookup",
      "destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
      "alias":"personalizationAlias",
      "segments":[
         {
            "id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         },
         {
            "id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         }
      ]
   }
]

タグを使用せずに Experience Platform Web SDK をデプロイする場合、イベントからの応答の処理機能を使用して、書き出したデータを確認します。

Adobe Experience Platform からの JSON 応答は、Adobe Experience Platform と統合しているアプリケーションの対応する統合エイリアスを見つけるために解析できます。セグメント ID は、ターゲティングパラメーターとしてアプリケーションのコードに渡すことができます。次に、これが宛先の応答に特有なサンプルを示します。

alloy("sendEvent", {
  "renderDecisions": true,
  "xdm": {
    "commerce": {
      "order": {
        "purchaseID": "a8g784hjq1mnp3",
        "purchaseOrderNumber": "VAU3123",
        "currencyCode": "USD",
        "priceTotal": 999.98
      }
    }
  }
}).then(function(result) {
    if(result.destinations) { // Looking to see if the destination results are there

        // Get the destination with a particular alias
        var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
        if(personalizationDestinations.length > 0) {
             // Code to pass the segment IDs into the system that corresponds to personalizationAlias
        }
        var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
        if(adServerDestinations.length > 0) {
            // Code to pass the segment ids into the system that corresponds to adServerAlias
        }
     }
   })
  .catch(function(error) {
    // Tracking the event failed.
  });

応答の例: 属性を含むカスタムパーソナライゼーション

を使用する場合 属性を含むカスタムパーソナライゼーション​に設定した場合、API 応答は以下の例のようになります。

違いは 属性を含むカスタムパーソナライゼーション および カスタムパーソナライゼーションattributes 」の節を参照してください。

[
    {
        "type": "profileLookup",
        "destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
        "alias": "personalizationAlias",
        "attributes": {
             "countryCode": {
                   "value" : "DE"
              },
             "membershipStatus": {
                   "value" : "PREMIUM"
              }
         },
        "segments": [
            {
                "id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            },
            {
                "id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            }
        ]
    }
]

データの使用とガバナンス

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのように データガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

このページ