Questa pagina descrive idMigrationEnabled nel metodo Server SDK configure. Per il Web SDK, vedere idMigrationEnabled.
La proprietà idMigrationEnabled consente al Server SDK di riutilizzare gli Experience Cloud ID (ECID) assegnati ai visitatori dal servizio ID visitatore di Adobe legacy (VisitorAPI.js). Il servizio ID visitatore memorizza l’ECID in un cookie denominato AMCV_<orgId>. Il riutilizzo di questi ID impedisce un netto aumento dei visitatori univoci quando si passa dal servizio ID visitatore al Web SDK o al Server SDK.
Funzionamento della migrazione delle identità su un server how-it-works
SDK legge e scrive i cookie tramite il servizio cookie che passi a forRequest. Quando idMigrationEnabled è true:
- Se il visitatore non ha un cookie
kndctr_<orgId>_identity, ma ha un cookieAMCV_<orgId>, SDK legge l’ECID dal cookieAMCV_e lo aggiunge alidentityMapdell’evento. L’Edge Network continua quindi a utilizzare l’ECID per il visitatore. - Dopo che l’Edge Network ha restituito l’identità del visitatore, SDK lo scrive sia nel cookie
kndctr_<orgId>_identityche nel cookieAMCV_<orgId>, in modo che le pagine che usano ancora il servizio ID visitatore riconoscano lo stesso visitatore.
La migrazione delle identità funziona solo se il servizio cookie concede a SDK l’accesso ai cookie del browser del visitatore e solo se il servizio ID visitatore è stato eseguito sullo stesso dominio con lo stesso orgId. Server SDK non può leggere le identità dalla libreria del servizio ID visitatore stessa, perché tale libreria viene eseguita solo nei browser.
Se il servizio dei cookie non legge i cookie del browser del visitatore o se il sito non ha mai utilizzato il servizio ID visitatore, la migrazione delle identità non ha alcun effetto.
Esempio di codice
Imposta il valore booleano idMigrationEnabled quando chiami configure. Se viene omesso, il valore predefinito sarà true. Impostarlo su false per impedire a SDK di leggere e scrivere 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
});