カスタム Personalization接続 custom-personalization-connection

宛先の変更ログ changelog

この変更ログを使用して、カスタム Personalizationの宛先に対する更新を追跡します。

概要 overview

この宛先を設定して、外部パーソナライゼーションプラットフォーム、コンテンツ管理システム、および顧客web サイトで実行されているその他のアプリケーションがAdobe Experience Platformからオーディエンス情報を取得できるようにします。

前提条件 prerequisites

この宛先には、実装に応じて、次のいずれかのデータ収集方法が必要です。

サポートされるオーディエンス supported-audiences

次の表に、この宛先に書き出すことができるオーディエンスタイプを示します。

オーディエンスのデータタイプ別にサポートされるオーディエンス：

書き出しのタイプと頻度 export-type-frequency

次の表に、この宛先の書き出しタイプと頻度を示します。

宛先への接続 connect

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

接続パラメーター parameters

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

アラートの有効化 enable-alerts

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

宛先接続の詳細の提供が完了したら、Next​を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

この宛先に対してオーディエンスをアクティブ化する手順については、​ プロファイルとオーディエンスをエッジパーソナライゼーションの宛先にアクティブ化を参照してください。

書き出したデータ exported-data

Adobe Experience Platformで タグを使用してExperience Platform Web SDKをデプロイする場合は、send event complete機能を使用します。 カスタムコードアクションには、書き出されたデータを表示するために使用できる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 audience 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 audience IDs into the system that corresponds to adServerAlias
        }
     }
   })
  .catch(function(error) {
    // Tracking the event failed.
  });

属性を持つカスタム Personalizationのレスポンスの例 example-response-attributes

Custom Personalization With Attributes​を使用する場合、API応答は次の例のようになります。

Custom Personalization With Attributes​と​ Custom Personalization ​の違いは、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"
            }
        ]
    }
]

データの使用とガバナンス data-usage-governance

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