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

宛先の変更ログ changelog

リリース月
更新タイプ
説明
2023年5月
機能とドキュメントの更新
2023 年 5 月の時点で、カスタムパーソナライゼーション 接続は 属性ベースのパーソナライゼーションをサポートしており、通常すべてのお客様が利用できます。
IMPORTANT
プロファイル属性には、機密データが含まれている場合があります。 このデータを保護するには、属性ベースのパーソナライゼーション用に 🔗 カスタム Personalization をEdge Networkする際に 0}Configuration Server API} を使用する必要があります。 すべての Server API 呼び出しは、 認証済みコンテキストで行う必要があります。
Web または Mobile SDK の実装に既に使用しているのと同じデータストリームを使用するサーバーサイドEdge Networkを追加することで 🔗
1}Integration Server API を介してプロファイル属性を取得できます。
上記の要件に従わない場合、パーソナライゼーションはオーディエンスメンバーシップのみに基づきます。

概要 overview

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

前提条件 prerequisites

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

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

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

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスオリジン
サポートあり
説明
Segmentation Service
Experience Platform セグメント化サービスを通じて生成されたオーディエンス。
カスタムアップロード
CSV ファイルから Experience Platform に読み込まれたオーディエンス。

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

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

宛先への接続 connect

IMPORTANT
宛先に接続するには、宛先の表示 および 宛先の管理 アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

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

接続パラメーター parameters

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

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

アラートの有効化 enable-alerts

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

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

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

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

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

書き出したデータ exported-data

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"
         }
      ]
   }
]

Tags を使用せずにExperience PlatformWeb 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 の応答の例

属性を含むカスタムPersonalization を使用する場合、API 応答は次の例のようになります。

属性を含むカスタムPersonalizationカスタム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 がどのように データガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

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