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

最終更新日: 2024-01-22
  • トピック:
  • Destinations
    このトピックの詳細を表示
  • 作成対象:
  • Admin
    User

宛先の変更ログ

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

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


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


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

概要

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

前提条件

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

重要

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

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

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

オーディエンスの起源 サポートあり 説明
Segmentation Service Experience Platform セグメント化サービス.
カスタムアップロード CSV ファイルから Experience Platform に読み込まれたオーディエンス。

書き出しのタイプと頻度

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

宛先への接続

重要

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

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

接続パラメーター

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

  • 名前:この宛先に希望する名前を入力します。
  • 説明:宛先についての説明を入力します。例えば、この宛先を使用しているキャンペーンを指定できます。このフィールドはオプションです。
  • 統合エイリアス:この値は、JSON オブジェクト名として Experience Platform Web SDK に送信されます。
  • Datastream 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 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.
  });

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

を使用する場合 属性を含むカスタムパーソナライゼーション​に設定した場合、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 がどのように データガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

このページ