自訂個人化連接 custom-personalization-connection
目的地變更記錄檔 changelog
概觀 overview
設置此目的地，讓外部個人化平台、內容管理系統、廣告伺服器及其他在客戶網站上運行的應用程式，能從 Adobe 體驗平台擷取受眾資訊。
先決條件 prerequisites
根據您的實作，此目的地需要使用下列其中一個資料收集方法：
- 如果您想要從網站收集資料，請使用Adobe Experience Platform Web SDK。
- 如果你想從行動應用程式收集資料，請使用 Adobe Experience Platform 行動 SDK 。
- 如果你沒有使用 Web SDK 或行動 SDK，或想根據個人檔案屬性個人化使用者體驗，請使用 Edge Network API。
支持觀眾 supported-audiences
本節說明您可以匯出到該目的地的受眾類型。
匯出型別和頻率 export-type-frequency
連線到目標 connect
若要連線到此目的地，請依照目的地組態教學課程中所述的步驟進行。
連線參數 parameters
在設定此目的地時，您必須提供下列資訊：
- Name：填寫此目的地的偏好名稱。
- Description：輸入目的地的說明。 例如，你可以說明你使用這個目的地的活動。 此欄位為選填。
- Integration alias： 此值會以 JSON 物件名稱傳送至 Experience Platform Web SDK。
- Datastream：這會決定頁面回應中將包含哪些資料收集資料串流中的對象。 下拉選單僅顯示已啟用目的地設定的資料流。如需詳細資訊，請參閱設定資料串流。
啟用警示 enable-alerts
你可以啟用警示，接收資料流狀態通知到目的地。 從列表中選擇一個警示訂閱，即可接收資料流狀態的通知。 欲了解更多提醒資訊，請參閱使用介面訂閱目的地提醒的指南。
當您完成目的地轉機的詳細資訊後，請選擇 Next。
啟動此目標的對象 activate
閱讀啟用設定檔與對象邊緣個人化目的地，以取得啟用此目的地的對象的指示。
匯出的資料 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"
}
]
}
]
如果您不是使用標籤來部署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.
});
Custom Personalization With 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 執行資料治理的詳細資訊，請參閱 資料治理概述。