Cette page décrit la méthode de appendIdentityToUrl de Server SDK. Pour le Web SDK, voir appendIdentityToUrl.
La méthode appendIdentityToUrl ajoute l’identité du visiteur à une URL en tant que paramètre de chaîne de requête nommé adobe_mc. Lorsque le visiteur suit l’URL d’un autre domaine que vous possédez, le SDK Web ou le SDK serveur de ce domaine lit le paramètre et conserve le même Experience Cloud ID (ECID). Cela empêche le visiteur d’être comptabilisé deux fois dans les jeux de données qui incluent les deux domaines.
Sur un serveur, une utilisation courante consiste à ajouter l’identité du visiteur à une redirection vers un autre domaine :
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const { url } = await visitor.appendIdentityToUrl({
url: "https://shop.example.net/checkout"
});
res.writeHead(302, { Location: url });
res.end();
L’URL qui en résulte ressemble à ce qui suit :
https://shop.example.net/checkout?adobe_mc=TS%3D1792711449%7CMCMID%3D34567890123456789012345678901234567890%7CMCORGID%3DADB3LETTERSANDNUMBERS%2540AdobeOrg
Si le SDK ne dispose pas encore de l’ECID du visiteur, il en demande un à Edge Network en premier. Cette requête n’est pas authentifiée. Voir Définir le type d’accès au flux de données.
Si le visiteur s’est désinscrit ou si defaultConsent est "out" et qu’il n’a pas souscrit, la méthode renvoie l’URL inchangée. Elle renvoie également l’URL inchangée, au lieu de la rejeter, si elle ne parvient pas à obtenir l’identité du visiteur, par exemple en raison d’une erreur réseau. Lorsque le débogage est activé, le SDK consigne un avertissement qui inclut les Unable to append identity to url.
Options options
La méthode appendIdentityToUrl accepte un objet avec les propriétés suivantes :
url: obligatoire. URL à laquelle ajouter l’identité du visiteur.edgeConfigOverrides: un objet de remplacement de configuration de train de données pour cette requête.
Objet de résultat result
La méthode appendIdentityToUrl renvoie une promesse. Lorsqu’il est résolu, l’objet de résultat contient url, l’URL avec le paramètre de chaîne de requête adobe_mc ajouté.