使用 Adobe Target 和 Web SDK 針對個人化
Adobe Experience Platform Web SDK 可以傳遞並轉譯受管理的個人化體驗 Adobe Target 至網路頻道。 您可以使用WYSIWYG編輯器,稱為 視覺化體驗撰寫器 (VEC)或是非視覺化介面,請將 表單式體驗撰寫器,以建立、啟用及傳遞您的活動和個人化體驗。
下列功能已經過測試,目前在中支援 Target:
Web SDK 系統圖表
下圖可協助您瞭解 Target 和 Web SDK 邊緣決策。
b.作為使用者在單頁應用程式(SPA)中的動作結果而顯示的檢視個人化內容會快取,以便在觸發檢視時立刻套用,不需額外的伺服器呼叫。
。Edge Network會傳送訪客ID和Cookie中的其他值,例如同意、工作階段ID、身分、Cookie檢查、個人化。
正在啟用 Adobe Target
若要啟用 Target,請執行下列動作:
- 啟用 Target 在您的 資料流 並加上適當的使用者端代碼。
- 新增
renderDecisions
選項新增至您的事件。
然後,您也可選擇新增下列選項:
decisionScopes
:將此選項新增至事件,擷取特定活動(適用於使用表單式撰寫器建立的活動)。- 預先隱藏程式碼片段:僅隱藏頁面的某些部分。
使用Adobe Target VEC
若要搭配使用VEC與 Web SDK 實作,安裝並啟動 Firefox 或 鉻黃 VEC Helper擴充功能。
如需詳細資訊,請參閱 視覺化體驗撰寫器Helper擴充功能 在 Adobe Target指南.
呈現個人化內容
另請參閱 呈現個人化內容 以取得詳細資訊。
XDM中的受眾
為您的定義對象時 Target 透過傳遞的活動 Web SDK, XDM 必須定義及使用。 定義XDM結構描述、類別和結構描述欄位群組後,您可以建立 Target 由XDM資料定義的對象規則,用於鎖定目標。 範圍 Target,XDM資料會顯示在 對象產生器 作為自訂引數。 XDM是使用點標籤法序列化(例如, web.webPageDetails.name
)。
如果您有 Target 預先定義受眾且使用自訂引數或使用者設定檔的活動,無法透過SDK正確傳遞。 您必須改用XDM,而不是使用自訂引數或使用者設定檔。 不過,有透過支援的現成受眾目標定位欄位。 Web SDK 不需要XDM的客戶。 這些欄位位於 Target 不需要XDM的UI:
- Target 資料庫
- 地理
- 網路
- 作業系統
- 網頁
- 瀏覽器
- 流量來源
- 時間段
如需詳細資訊,請參閱 對象的類別 在 Adobe Target指南.
回應 Token
回應Token可用來傳送中繼資料給第三方,例如Google或Facebook。 回應Token會傳回 meta
欄位範圍 propositions
-> items
. 範例如下:
{
"id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
"scope": "__view__",
"scopeDetails": ...,
"renderAttempted": true,
"items": [
{
"id": "0",
"schema": "https://ns.adobe.com/personalization/dom-action",
"meta": {
"experience.id": "0",
"activity.id": "126736",
"offer.name": "Default Content",
"offer.id": "0"
}
}
]
}
若要收集回應Token,您必須訂閱 alloy.sendEvent
Promise,反複檢視 propositions
,並從中擷取詳細資料 items
-> meta
.
每 proposition
具有 renderAttempted
布林值欄位,指出 proposition
已轉譯或未轉譯。 請參閱下列範例:
alloy("sendEvent",
{
"renderDecisions": true,
"decisionScopes": [
"hero-container"
]
}).then(result => {
const { propositions } = result;
// filter rendered propositions
const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);
// collect the item metadata that represents the response tokens
const collectMetaData = (items) => {
return items.filter(item => item.meta !== undefined).map(item => item.meta);
}
const pageLoadResponseTokens = renderedPropositions
.map(proposition => collectMetaData(proposition.items))
.filter(e => e.length > 0)
.flatMap(e => e);
});
啟用自動轉譯時,主張陣列包含:
在頁面載入時:
- 表單式撰寫器型
propositions
替換為renderAttempted
標幟設定為false
- 視覺化體驗撰寫器式主張,具有
renderAttempted
標幟設定為true
- 單一頁面應用程式檢視的視覺化體驗撰寫器式主張,具有
renderAttempted
標幟設定為true
檢視上 — 變更(針對快取檢視):
- 單一頁面應用程式檢視的視覺化體驗撰寫器式主張,具有
renderAttempted
標幟設定為true
停用自動轉譯時,主張陣列包含:
在頁面載入時:
- Form-based Composer-based
propositions
替換為renderAttempted
標幟設定為false
- Visual Experience Composer-based proposition with
renderAttempted
標幟設定為false
- Visual Experience Composer單一頁面應用程式檢視的 — based主張,具有
renderAttempted
標幟設定為false
檢視上 — 變更(針對快取檢視):
- 單一頁面應用程式檢視的視覺化體驗撰寫器式主張,具有
renderAttempted
標幟設定為false
單一設定檔更新
此 Web SDK 可讓您將設定檔更新至 Target 設定檔和 Web SDK 做為體驗事件。
若要更新 Target 設定檔時,請確保已使用以下專案傳遞設定檔資料:
- 在
"data {"
- 在
"__adobe.target"
- 前置詞
"profile."
renderDecisions
decisionScopes
<String>
xdm
data
典型 Web SDK 使用此命令的程式碼如下所示:
sendEvent
使用設定檔資料
alloy("sendEvent", {
renderDecisions: true|false,
xdm: { // Experience Event XDM data },
data: { // Freeform data }
});
如何傳送設定檔屬性至Adobe Target:
alloy("sendEvent", {
"renderDecisions": true,
"data": {
"__adobe": {
"target": {
"profile.gender": "female",
"profile.age": 30
}
}
}
});
要求建議
下表列出 Recommendations 屬性以及是否透過 Web SDK:
如何將Recommendations屬性傳送至Adobe Target:
alloy("sendEvent", {
"renderDecisions": true,
"data": {
"__adobe": {
"target": {
"entity.id": "123",
"entity.genre": "Drama"
}
}
}
});
偵錯
已棄用mboxTrace和mboxDebug。 使用方法 Web SDK除錯 而非。
術語
主張: 在 Adobe Target,主張會與從活動選取的體驗建立關聯。
結構描述: 決定的結構描述是中的優惠型別 Adobe Target.
範圍: 決定的範圍。 在 Adobe Target,範圍是mBox。 全域mBox是 __view__
範圍。
XDM: XDM會序列化為點標籤法,然後放入 Adobe Target 作為mBox引數。