Cette page décrit les idMigrationEnabled de la méthode configure de Server SDK. Pour le Web SDK, voir idMigrationEnabled.
La propriété idMigrationEnabled permet au serveur SDK de réutiliser les Experience Cloud ID (ECID) affectés à vos visiteurs par l’ancien service d’identification des visiteurs d’Adobe (VisitorAPI.js). Le service d’identification des visiteurs stocke l’ECID dans un cookie nommé AMCV_<orgId>. La réutilisation de ces identifiants empêche une forte augmentation du nombre de visiteurs uniques lorsque vous passez du service d’identification des visiteurs à Web SDK ou au serveur SDK.
Fonctionnement de la migration d’identité sur un serveur how-it-works
Le SDK lit et écrit des cookies par le biais du service de cookies que vous transmettez à forRequest. Lorsque idMigrationEnabled est true :
- Si le visiteur ne dispose d’aucun cookie
kndctr_<orgId>_identity, mais qu’il possède un cookieAMCV_<orgId>, le SDK lit l’ECID à partir du cookieAMCV_et l’ajoute auidentityMapde l’événement. Edge Network continue ensuite à utiliser cet ECID pour le visiteur. - Une fois que l’Edge Network a renvoyé l’identité du visiteur, le SDK l’écrit dans le cookie
kndctr_<orgId>_identityet le cookieAMCV_<orgId>, de sorte que les pages qui utilisent toujours le service d’identification des visiteurs reconnaissent le même visiteur.
La migration des identités ne fonctionne que si votre service de cookies donne à SDK l’accès aux cookies de navigateur réels du visiteur et uniquement si le service d’identification des visiteurs s’est exécuté sur le même domaine avec le même orgId. Le SDK du serveur ne peut pas lire les identités de la bibliothèque du service d’identification des visiteurs elle-même, car cette bibliothèque s’exécute uniquement dans les navigateurs.
Si votre service de cookies ne lit pas les cookies du navigateur du visiteur ou si votre site n’a jamais utilisé le service d’identification des visiteurs, la migration d’identité n’a aucun effet.
Exemple de code
Définissez la valeur booléenne idMigrationEnabled lors de l’appel de configure. Si vous l’omettez, la valeur par défaut est true. Définissez-le sur false pour empêcher le SDK de lire et d’écrire des cookies AMCV_.
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
});