此頁面說明伺服器SDK configure方法中的idMigrationEnabled。 若為Web SDK,請參閱idMigrationEnabled.
idMigrationEnabled屬性可讓伺服器SDK重複使用舊版Adobe訪客ID服務(VisitorAPI.js)指派給訪客的Experience Cloud ID (ECID)。 訪客ID服務會將ECID儲存在名為AMCV_<orgId>的Cookie中。 重複使用這些ID可防止不重複訪客在您從訪客ID服務移至Web SDK或伺服器SDK時急劇增加。
身分移轉在伺服器上的運作方式 how-it-works
SDK會透過您傳遞至forRequest的Cookie服務來讀取和寫入Cookie。 當idMigrationEnabled為true時:
- 如果訪客沒有
kndctr_<orgId>_identityCookie,但有AMCV_<orgId>Cookie,則SDK會從AMCV_Cookie讀取ECID,並將其新增至事件的identityMap。 接著Edge Network會繼續針對訪客使用該ECID。 - Edge Network傳回訪客的身分識別後,SDK會將其寫入
kndctr_<orgId>_identityCookie和AMCV_<orgId>Cookie,讓仍使用訪客ID服務的頁面可識別相同的訪客。
只有當Cookie服務授予SDK存取訪客真正瀏覽器Cookie的許可權,且訪客ID服務在同一orgId網域上執行時,身分移轉才會生效。 伺服器SDK無法從訪客ID服務程式庫本身讀取身分,因為該程式庫只能在瀏覽器中執行。
如果您的Cookie服務未讀取訪客的瀏覽器Cookie,或您的網站從未使用訪客ID服務,則身分移轉無效。
程式碼範例
呼叫configure時設定idMigrationEnabled布林值。 若您省略,其預設值為true。 將其設為false以停止SDK讀取和寫入AMCV_ Cookie。
await alloy.configure({
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
edgeCredentials: {
clientId: process.env.ADOBE_CLIENT_ID,
clientSecret: process.env.ADOBE_CLIENT_SECRET,
scopes: process.env.ADOBE_SCOPES.split(",")
},
idMigrationEnabled: false
});
recommendation-more-help
experience-platform-help-collection