Adobe Experience Platform Web SDK可運用 Adobe Experience Cloud ID (ECID) 以追蹤訪客行為。 使用ECID,您可以確保每個裝置都有唯一識別碼,可跨多個工作階段持續存在,繫結特定裝置在Web工作階段期間和跨工作階段發生的所有點選。
本檔案概述如何使用Platform Web SDK管理ECID。
Platform Web SDK可透過Cookie指派及追蹤ECID,並有多種可用方法來設定這些Cookie的產生方式。
當新使用者進入您的網站時,Adobe Experience Cloud Identity Service會嘗試為該使用者設定裝置識別Cookie。 首次造訪訪訪客時,系統會在首次從Adobe Experience Platform Edge Network回應時產生並傳回ECID。 若為重複訪客,ECID會從 kndctr_{YOUR-ORG-ID}_AdobeOrg_identity
Cookie並由Edge Network新增至裝載。
設定包含ECID的Cookie後,Web SDK產生的每個後續請求都會在 kndctr_{YOUR-ORG-ID}_AdobeOrg_identity
Cookie。
使用Cookie識別裝置時,您有兩個選項可與Edge Network互動:
如下節所述,您選擇使用的資料收集方法會直接影響所有瀏覽器的Cookie存留期。
第三方資料收集涉及將資料直接傳送至Edge Network網域 adobedc.net
.
近年來,網頁瀏覽器在處理第三方設定的Cookie時,受到越來越多限制。 某些瀏覽器預設會封鎖第三方Cookie。 如果您使用第三方Cookie來識別網站訪客,則這些Cookie的存留期幾乎總是比使用第一方Cookie時可用的存留期短。 在某些情況下,第三方Cookie最快會在七天後過期。
此外,使用協力廠商資料收集時,有些廣告封鎖程式會完全將流量限制在Adobe資料收集端點。
第一方資料收集涉及透過您自己的網域上的CNAME設定Cookie,並指向 adobedc.net
.
雖然瀏覽器長期以來以類似網站擁有端點的方式處理CNAME端點設定的Cookie,但瀏覽器最近實作的變更對CNAME Cookie的處理方式造成差異。 雖然目前沒有瀏覽器預設會封鎖第一方CNAME Cookie,但有些瀏覽器會將使用CNAME設定的Cookie存留期限製為僅七天。
無論您是選擇第一方還是第三方資料收集,Cookie可儲存的時間長度會直接影響Adobe Analytics和Customer Journey Analytics中的訪客計數。 此外,在網站上使用Adobe Target或Offer Decisioning時,使用者可能會遇到不一致的個人化體驗。
例如,假設您已建立個人化體驗,而如果使用者在過去七天內檢視任何專案三次,該體驗會將任何專案提升至首頁。
如果一般使用者一週內瀏覽三次,然後七天未返回網站,則該使用者在返回網站時可視為新使用者,因為其Cookie可能已被瀏覽器原則刪除(取決於使用者瀏覽網站時所使用的瀏覽器)。 如果發生這種情況,您的Analytics工具會將訪客視為新使用者,即使他們七天多一點前才造訪網站。 此外,任何為使用者個人化體驗的努力都將重新開始。
如上所述,若要考慮Cookie有效期限的影響,您可以選擇設定和管理自己的裝置識別碼。 請參閱指南: 第一方裝置ID 以取得詳細資訊。
若要擷取目前訪客的唯一ECID,請使用 getIdentity
命令。 對於尚未建立ECID的首次訪客,此命令會產生新的ECID。 getIdentity
也會傳回訪客的地區ID。
此方法通常用於需要讀取 Experience Cloud ID或需要Adobe Audience Manager的位置提示。 标准实施不使用该函数。
alloy("getIdentity")
.then(function(result) {
// The command succeeded.
console.log("ECID:", result.identity.ECID);
console.log("RegionId:", result.edge.regionId);
})
.catch(function(error) {
// The command failed.
// "error" will be an error object with additional information.
});
identityMap
使用XDM identityMap
欄位,您可使用多個身分識別裝置/使用者、設定其驗證狀態,以及決定要將哪個識別碼視為主要識別碼。 如果尚未將任何識別碼設為 primary
,則主要預設為 ECID
.
identityMap
欄位更新使用 sentEvent
命令。
alloy("sendEvent", {
xdm: {
"identityMap": {
"ID_NAMESPACE": [ // Notice how each namespace can contain multiple identifiers.
{
"id": "1234",
"authenticatedState": "ambiguous",
"primary": true
}
]
}
}
});
內的每個屬性 identityMap
代表屬於特定身分識別 身分名稱空間. 屬性名稱應為身分名稱空間符號,您可以在「 」下方的Adobe Experience Platform使用者介面中找到該符號身分「。 屬性值應該是與該身分名稱空間相關的身分陣列。
傳入的名稱空間ID identityMap
區分大小寫。 請務必使用正確的名稱空間ID,以避免不完整的資料收集。
身分陣列中的每個身分物件包含下列屬性:
属性 | 資料型別 | 描述 |
---|---|---|
id |
字符串 | (必要) 您要為指定的名稱空間設定的ID。 |
authenticationState |
字符串 | (必要) ID的驗證狀態。 可能的值包括 ambiguous , authenticated 、和 loggedOut . |
primary |
布尔值 | 決定是否應將此身分識別作為設定檔中的主要片段。 依預設,ECID會設為使用者的主要識別碼。 如果省略,此值會預設為 false . |
使用 identityMap
識別裝置或使用者的欄位會產生與使用相同的結果 setCustomerIDs
來自的方法 ID Service API. 請參閱 ID服務API檔案 以取得更多詳細資料。
從使用訪客API移轉時,您也可以移轉現有的AMCV Cookie。 若要啟用ECID移轉,請將 idMigrationEnabled
引數來設定。 ID移轉可啟用下列使用案例:
idMigrationEnabled
為了移轉大部分的訪客Cookie,可以關閉設定。將XDM格式資料傳送到Audience Manager時,移轉時需要將此資料轉換為訊號。 您的特徵需要更新,以反映XDM提供的新金鑰。 此程式透過使用 BAAAM工具 該Audience Manager已建立。
如果您目前擁有 事件轉送 已啟用且正在使用 appmeasurement.js
和 visitor.js
,即可保持事件轉送功能已啟用,這樣就不會造成任何問題。 在後端,Adobe會擷取任何AAM區段,並將其新增至Analytics呼叫。 如果對Analytics的呼叫包含這些區段,Analytics將不會呼叫Audience Manager來轉送任何資料,因此不會有任何雙重資料收集。 使用Web SDK時也不需要位置提示,因為後端會呼叫相同的區段端點。