Cette page décrit la méthode de getIdentity de Server SDK. Pour le Web SDK, voir getIdentity.
La méthode getIdentity renvoie l’Experience Cloud ID (ECID) du visiteur sans envoyer de données d’événement. Lorsque vous appelez sendEvent, Edge Network établit automatiquement l’identité du visiteur. N’utilisez donc getIdentity que lorsque votre serveur a besoin de l’ECID lui-même. Par exemple, utilisez-le pour stocker l’ECID avec vos propres enregistrements ou pour le transmettre à un autre système.
Appelez getIdentity sur l’identificateur de forRequest du visiteur :
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const result = await visitor.getIdentity({
namespaces: ["ECID"]
});
console.log(result.identity.ECID);
Le SDK utilise le flux suivant pour renvoyer l’ECID :
- Le SDK vérifie si le consentement permet de continuer. Si le visiteur s’est désabonné,
getIdentityest résolu avec un objet vide. - Si le cookie d’identité du visiteur est disponible via le service de cookies que vous avez transmis à
forRequest, le SDK lit l’ECID à partir de celui-ci sans contacter Adobe. - Dans le cas contraire, le SDK demande l’identité du visiteur à Edge Network, écrit le cookie d’identité par le biais de votre service de cookies et renvoie l’ECID.
La requête envoyée à Edge Network n’est pas authentifiée. Assurez-vous que votre flux de données accepte les requêtes non authentifiées. Voir Définir le type d’accès au flux de données.
Si vous ne transmettez pas de service de cookie à forRequest, le SDK ne trouve pas d’identité existante. Chaque gestionnaire de forRequest obtient donc un nouvel ECID. Voir Instances et requêtes .
Options options
La méthode getIdentity accepte un objet facultatif avec les propriétés suivantes :
namespaces: tableau des espaces de noms d’identité à renvoyer. Les valeurs prises en charge sont"ECID"et"CORE". La valeur par défaut est["ECID"]. Vous ne pouvez demander l’espace de noms"CORE"que lorsquethirdPartyCookiesEnabledesttrue. Dans le cas contraire, legetIdentityest rejeté.edgeConfigOverrides: un objet de remplacement de configuration de train de données pour cette requête.
Objet de résultat result
La méthode getIdentity renvoie une promesse. Lorsqu’il est résolu, l’objet de résultat contient les propriétés suivantes :
identity.ECID: chaîne contenant l’ECID du visiteur.identity.CORE: chaîne contenant l’identifiant CORE du visiteur, si vous avez demandé l’espace de nomsCORE.edge.regionId: un entier qui identifie la région Edge Network qui a géré la demande. Cette propriété est présente uniquement lorsque le SDK a contacté l’Edge Network pour obtenir l’identité.
const { identity } = await visitor.getIdentity();
console.log(identity.ECID);