getIdentity
Créé pour :
- Développeur
Lorsque vous exécutez la commande sendEvent, le Web SDK récupère automatiquement l’identité du visiteur si elle n’est pas déjà présente.
La commande getIdentity permet d’obtenir un identifiant visiteur sans envoyer de données d’événement.
Si vous avez besoin d’appels distincts pour générer un identifiant visiteur et envoyer des données, vous pouvez utiliser cette commande.
La commande getIdentity passe par le flux suivant pour récupérer le ECID.
- Vous utilisez le SDK Web pour appeler
getIdentityouappendIdentityToUrl. - Web SDK attend que les informations de consentement soient fournies.
- Web SDK vérifie si l'espace de noms
ECIDa été demandé lors de l'appel. Par défaut, l’espace de nomsECIDest toujours inclus. - Web SDK lit le cookie
kndctret renvoie sa valeur sous la formeECID, s’il existe. Cette fonction renvoie uniquement la valeurECID, mais pas laregionId. - Si le cookie d’identité
kndctrn’est pas défini ou si l’espace de noms"CORE"a été demandé, Web SDK effectue une requête à l’Edge Network. - Edge Network renvoie à la fois le
ECIDet leregionId(et leCORE ID, le cas échéant).
Obtention de l’identité à l’aide de l’extension de balise Web SDK
L’extension de balise Web SDK n’offre pas cette commande via l’interface utilisateur de l’extension de balise. Utilisez l’éditeur de code personnalisé à l’aide de la syntaxe de la bibliothèque JavaScript.
Obtention de l’identité à l’aide de la bibliothèque JavaScript Web SDK
Exécutez la commande getIdentity lors de l’appel de votre instance configurée de Web SDK. Les options suivantes sont disponibles lors de la configuration de cette commande :
-
namespaces: tableau d’espaces de noms. La valeur par défaut est["ECID"]. Autres valeurs prises en charge :["CORE"]["ECID","CORE"]nullundefined
Vous pouvez demander ECID et CORE ID en même temps. Exemple :
"namespaces": ["ECID","CORE"]. -
edgeConfigOverrides: un objet de remplacement de configuration de train de données.
alloy("getIdentity",{
"namespaces": ["ECID","CORE"] //this command retrieves both ECID and CORE IDs.
});
Objet de réponse
Si vous décidez de gérer les réponses avec cette commande, les propriétés suivantes sont disponibles dans l’objet de réponse :
identity.ECID: chaîne contenant l’ECID du visiteur.identity.CORE: chaîne contenant l’ID CORE du visiteur.edge.regionID: un entier qui représente la région Edge Network visitée par le navigateur lors de l’acquisition d’une identité. Il est identique à l’indicateur d’emplacement Audience Manager hérité.