自訂個人化連線

目的地變更記錄檔

發行月份 更新型別 說明
2023 年 5 月 功能和檔案更新 截至2023年5月， 自訂個人化 連線支援 屬性型個人化 並且通常可供所有客戶使用。
重要

設定檔屬性可能包含敏感資料。 為了保護此資料， 自訂個人化 目的地要求您使用 Edge Network Server API 設定屬性型個人化的目的地時。 所有伺服器API呼叫都必須在 已驗證的內容.


如果您已在使用Web SDK或Mobile SDK進行整合，您可以透過新增伺服器端整合來透過伺服器API擷取屬性。


如果您未遵循上述要求，個人化將僅以區段成員資格為基礎。

總覽

此目的地提供從Adobe Experience Platform擷取區段資訊至外部個人化平台、內容管理系統、廣告伺服器和客戶網站上執行的其他應用程式的方法。

先決條件

這項整合由以下支援： Adobe Experience Platform Web SDK 或 Adobe Experience Platform Mobile SDK. 您必須使用其中一個SDK才能使用此目的地。

重要

在建立自訂個人化連線之前，請閱讀以下操作指南： 啟用邊緣個人化目的地的受眾資料. 本指南會針對跨多個Experience Platform元件的相同頁面和下一頁個人化使用案例，引導您進行必要的設定步驟。

匯出型別和頻率

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

連線到目的地

重要

若要連線到目的地，您需要 管理目的地 存取控制許可權. 閱讀 存取控制總覽 或聯絡您的產品管理員以取得必要許可權。

若要連線至此目的地，請遵循以下說明的步驟： 目的地設定教學課程.

連線引數

當 設定 您必須提供下列資訊：

  • 名稱：填寫此目的地的偏好名稱。
  • 說明：輸入目的地的說明。 例如，您可以提及要將此目的地用於哪個行銷活動。 此欄位為選用。
  • 整合別名：此值會以JSON物件名稱的形式傳送至Experience PlatformWeb SDK。
  • 資料串流ID：這會決定區段會包含在頁面的回應中的資料收集資料串流。 下拉式選單僅顯示已啟用目的地設定的資料流。另請參閱 設定資料串流 以取得更多詳細資料。

啟用警示

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

當您完成提供目的地連線的詳細資訊後，請選取 下一個.

啟用此目的地的區段

重要

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

讀取 啟用設定檔和區段邊緣個人化目的地 以取得啟用此目的地的受眾區段的指示。

匯出的資料

如果您使用 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 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 API回應中的區段。

[
    {
        "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 強制執行資料控管，請閱讀 資料控管概觀.

本頁內容