自訂個人化連線 custom-personalization-connection

目的地變更記錄檔 changelog

發行月份
更新型別
說明
2023 年 5 月
功能和檔案更新
自2023年5月起,自訂個人化 ​連線支援屬性式個人化,通常可供所有客戶使用。
IMPORTANT
設定檔屬性可能包含敏感資料。 若要保護此資料,您必須在為屬性式個人化設定​ 自訂Personalization ​目的地時,使用Edge Network伺服器API。 所有伺服器API呼叫都必須在已驗證的內容中進行。
您可以新增伺服器端整合,使用您已在網頁或行動SDK實作中使用的相同資料流,透過Edge Network伺服器API擷取設定檔屬性。
如果您未遵循上述要求,個人化將僅以對象成員資格為基礎。

概觀 overview

設定此目的地,以允許客戶網站上執行的外部個人化平台、內容管理系統、廣告伺服器及其他應用程式,從Adobe Experience Platform擷取對象資訊。

先決條件 prerequisites

此整合由Adobe Experience Platform Web SDKAdobe Experience Platform Mobile SDK提供支援。 您必須使用其中一個SDK才能使用此目的地。

IMPORTANT
在建立自訂個人化連線之前,請閱讀如何啟用對象資料至Edge個人化目的地的指南。 本指南會針對跨多個Experience Platform元件的相同頁面和下一頁個人化使用案例,引導您進行所需設定步驟。

支援的對象 supported-audiences

本節說明您可以將哪些型別的對象匯出至此目的地。

對象來源
支援
說明
Segmentation Service
✓ (A)
透過Experience Platform細分服務產生的對象。
自訂上傳
✓ (A)
對象從CSV檔案匯入至Experience Platform。

匯出型別和頻率 export-type-frequency

項目
類型
附註
匯出類型
Profile request
您正在請求已對應至單一設定檔之自訂個人化目的地的所有對象。 可以為不同的Adobe資料收集資料串流設定不同的自訂個人化目的地。
匯出頻率
串流
串流目的地是「一律開啟」的API型連線。 一旦根據對象評估在Experience Platform中更新了設定檔,聯結器就會將更新傳送至下游的目的地平台。 深入瞭解串流目的地

連線到目標 connect

IMPORTANT
若要連線到目的地,您需要​ 檢視目的地 ​和​ 管理目的地 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。

若要連線到此目的地,請依照目的地組態教學課程中所述的步驟進行。

連線參數 parameters

設定此目的地時,您必須提供下列資訊:

  • 名稱:填寫此目的地的偏好名稱。
  • 描述:輸入目的地的描述。 例如,您可以提及要將此目的地用於哪個行銷活動。 此欄位為選用。
  • 整合別名:此值會以JSON物件名稱的形式傳送到Experience PlatformWeb SDK。
  • 資料串流ID:這會決定要在頁面的回應中包含對象的資料收集資料串流。 下拉選單僅顯示已啟用目的地設定的資料流。如需詳細資訊,請參閱設定資料串流

啟用警示 enable-alerts

您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱使用UI訂閱目的地警示的指南。

當您完成提供目的地連線的詳細資訊後,請選取​ 下一步

啟動此目標的對象 activate

IMPORTANT
若要啟用資料,您需要​ 檢視目的地啟用目的地檢視設定檔 ​和​ 檢視區段 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。

閱讀啟用設定檔與對象邊緣個人化目的地,以取得啟用此目的地的對象的指示。

匯出的資料 exported-data

如果您使用Adobe Experience Platform🔗中的標籤來部署Experience PlatformWeb 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 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