Analytics for Target實作
實作Adobe Analytics做為Adobe Target (A4T)的報告來源時,需要幾個步驟。 此程式會因您使用Adobe Experience Platform Web SDK或使用at.js實作A4T而有所不同。
適用於Adobe Experience Platform Web SDK實作的 實作步驟 platform
如果您打算使用Platform Web SDK,以下幾節將說明將此整合部署至您的網站所需的步驟:
步驟1:要求布建Analytics和Target
實作A4T之前,您必須先布建給Analytics和Target。 使用此表單來要求布建帳戶。
步驟 2: 設定使用者權限
必須符合使用者帳戶需求,您才能在Target中根據Analytics建立活動。 請參閱使用者權限需求。
步驟3:建立Edge設定
使用Adobe Experience Platform使用邊緣組態工具建立Edge組態。 設定建立和設定資料串流。
步驟4:安裝和設定Platform Web SDK
若要開始傳遞Target體驗並套用Analytics以追蹤和分析,請在您的網站頁面上安裝和設定 Platform Web SDK。
步驟5:啟用使用A4T的選項
在Target UI中,按一下 Administration > Visual Experience Composer,然後選擇 Select per activity 或 Adobe Analytics。
- 建立每個活動時,Select per activity 可讓您選擇Target與Analytics。
- Adobe Analytics 將Analytics設為您建立的所有活動的報表來源。
at.js實作的實作步驟 section_73961BAD5BB4430A95E073DE5C026277
如果您打算使用at.js,以下幾節將說明將此整合部署至您的網站所需的步驟:
步驟 1: 要求佈建給 Analytics 和 Target
在您將Analytics實作為Target的報告來源之後,必須布建給Analytics和Target。 使用此表單來要求布建帳戶。
步驟 2: 設定使用者權限
必須符合使用者帳戶需求,您才能在Target中建立Analytics型活動。 請參閱使用者權限需求。
步驟 3: 實作 Experience Cloud 訪客 ID 服務
訪客ID服務可讓您識別Adobe Experience Cloud解決方案中的使用者。 實作或移轉至必要的Experience Cloud訪客ID版本。 如需詳細資訊,請參閱實作之前中的「實作需求」。
請參閱 Experience Cloud訪客ID服務 檔案中的實作Experience Cloud的ID服務。
步驟4: 更新 AppMeasurement for JavaScript 或 s_code
實作或移轉至必要的appMeasurement.js版本。 如需詳細資訊,請參閱實作之前中的「實作需求」。
如需新的實作,請參閱 JavaScript實作指南 中的Analytics實作概觀。
如需移轉,請參閱 Analytics實作指南 中的移轉至JavaScript的AppMeasurement。
步驟5:下載並更新at.js
使用您的生產帳戶實作或移轉至必要的at.js版本。 不需要修改程式碼。
如需詳細資訊,請參閱實作之前中的「實作需求」。
步驟6:託管at.js
如果您先前已部署at.js,則可以使用更新版本取代現有的檔案。 如需詳細資訊,請參閱實作之前中的「實作需求」。
否則,此檔案可以與訪客 ID 服務和 AppMeasurement for JavaScript 檔案一起裝載。這些檔案必須裝載於您網站所有頁面皆能存取的 Web 伺服器上。下一個步驟需要用到這些檔案的路徑。
步驟7:在所有網頁上參照at.js step7
將at.js加到VisitorAPI.js之下,請在每個頁面的標籤中新增下列這行程式碼:
at.js:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>
VisitorAPI.js必須在at.js之前載入。 如果您更新現有的at.js檔案,請務必驗證載入順序。
從實作觀點來看,Target與Analytics整合的預設設定是使用從頁面傳遞的SDID,在後端自動將Target和Analytics要求拼接在一起。
您可以控制如何及何時將與Target相關的分析資料傳送至Analytics以用於報表用途。 如果您不想選擇加入Target和Analytics透過SDID自動拼接分析資料的預設設定,請透過 window.targetGlobalSettings 設定 analyticsLogging = client_side。 注意: 任何 2.1 以下的版本均不支援此方法。
例如:
window.targetGlobalSettings = {
analyticsLogging: "client_side"
};
此設定具有全域效果,也就是說,at.js發出的所有呼叫都會在Target要求中傳送 analyticsLogging: "client_side",而且會為所有要求傳回分析裝載。 設定此選項時,傳回的裝載格式如下所示:
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
接著,裝載可透過資料插入API轉送至Analytics。 針對「自動分配」和「自動鎖定目標」活動,您也必須轉送sessionId。 如需詳細資訊,請參閱 Adobe Target SDK 指南中的Analytics for Target (A4T)報告。
如果不需要全域設定,且偏好使用更隨需提供的方法,請傳入 analyticsLogging: "client_side" 以使用at.js函式getOffers()。 只會針對此呼叫傳回分析裝載,且Target後端不會將裝載轉送至Analytics。 透過採用此方法,每個at.js Target要求都會依預設傳回裝載,但只有在需要和指定時才會傳回。
例如:
adobe.target.getOffers({
request: {
experienceCloud: {
analytics: {
logging: "client_side"
}
},
prefetch: {
mboxes: [{
index: 0,
name: "a1-serverside-xt"
}]
}
}
})
.then(console.log)
此呼叫會叫用回應,您可從中擷取分析裝載。
回應如下所示:
{
"prefetch": {
"mboxes": [{
"index": 0,
"name": "a1-serverside-xt",
"options": [{
"content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
"type": "html",
"eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
"responseTokens": {
"profile.memberlevel": "0",
"geo.city": "bucharest",
"activity.id": "167169",
"experience.name": "USA Experience",
"geo.country": "romania"
}
}],
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
}]
}
}
然後可透過資料插入API將裝載轉送至Analytics。
步驟8: 驗證實作 step8
更新JavaScript資料庫後載入您的頁面,以確認Target呼叫中的mboxMCSDID
引數值符合Analytics頁面檢視呼叫中的sdid
引數值。
尤其重要的是,確認這些值與單頁應用程式(SPA)中的值相符,因為此處的呼叫順序並不一定可預測。
步驟 9: (可選) 移除先前的整合程式碼
Adobe建議您移除先前的整合,以簡化實作,也不必解決系統之間的差異。 您可以移除先前為了SC至T&T整合而部署的任何程式碼,包括mboxLoadSCPlugin
。
步驟10: 啟用以 Analytics 作為 Target 的報表來源的選項
在Target中,按一下 Administration > Reporting 並選擇 Select per activity 或 Adobe Analytics 以啟用選項。
- 建立每個活動時,Select per activity 可讓您選擇Target與Analytics。
- Adobe Analytics 將Analytics設為您建立的所有活動的報表來源。