自訂個人化連線 custom-personalization-connection
目的地變更記錄檔 changelog
概觀 overview
設定此目的地，以允許客戶網站上執行的外部個人化平台、內容管理系統、廣告伺服器及其他應用程式，從Adobe Experience Platform擷取對象資訊。
先決條件 prerequisites
根據您的實作，此目的地需要使用下列其中一個資料收集方法：
- 如果您想要從網站收集資料，請使用Adobe Experience Platform Web SDK。
- 如果您想要從行動應用程式收集資料，請使用Adobe Experience Platform Mobile SDK。
- 如果您未使用Web SDK或Mobile SDK，或您想要根據設定檔屬性個人化使用者體驗，請使用Edge Network API。
支援的對象 supported-audiences
本節說明您可以將哪些型別的對象匯出至此目的地。
匯出型別和頻率 export-type-frequency
連線到目標 connect
若要連線到此目的地，請依照目的地組態教學課程中所述的步驟進行。
連線參數 parameters
在設定此目的地時，您必須提供下列資訊：
- Name：填寫此目的地的偏好名稱。
- Description：輸入目的地的說明。 例如，您可以提及要將此目的地用於哪個行銷活動。 此欄位為選用。
- Integration alias：此值會以JSON物件名稱的形式傳送到Experience Platform Web SDK。
- Datastream：這會決定頁面回應中將包含哪些資料收集資料串流中的對象。 下拉選單僅顯示已啟用目的地設定的資料流。如需詳細資訊，請參閱設定資料串流。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊，請參閱使用UI訂閱目的地警示的指南。
當您完成提供目的地連線的詳細資訊時，請選取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如何強制資料控管的詳細資訊，請閱讀資料控管概觀。