appendIdentityToUrl
La commande appendIdentityToUrl vous permet d’ajouter un identifiant d’utilisateur à l’URL en tant que chaîne de requête. Cette action vous permet de transférer l’identité d’un visiteur entre les domaines, ce qui empêche la duplication du nombre de visiteurs pour les jeux de données qui incluent à la fois des domaines ou des canaux. Il est disponible sur le SDK Web versions 2.11.0 ou ultérieures.
La chaîne de requête générée et ajoutée à l’URL est adobe_mc. Si le SDK Web ne trouve pas d’ECID, il appelle le point de terminaison /acquire pour en générer un.
Ajout d’une identité à l’URL à l’aide de l’extension SDK Web extension
L’ajout d’une identité à une URL est effectué sous la forme d’une action au sein d’une règle dans l’interface des balises de collecte de données Adobe Experience Platform.
- Connectez-vous à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
- Accédez à Collecte de données > Balises.
- Sélectionnez la propriété de balise de votre choix.
- Accédez à Rules, puis sélectionnez la règle de votre choix.
- Sous Actions, sélectionnez une action existante ou créez une action.
- Définissez le champ déroulant Extension sur SDK Web Adobe Experience Platform et définissez le Type d’action sur Rediriger avec identité.
- Cliquez sur Conserver les modifications, puis exécutez votre processus de publication.
Cette commande est généralement utilisée avec une règle spécifique qui écoute les clics et vérifie les domaines souhaités.
Déclenche lorsqu’un utilisateur clique sur une balise d’ancrage avec une propriété href.
- Extension : Core
- Type d’événement : cliquez sur
- Lorsque l’utilisateur clique sur : éléments spécifiques
- Éléments correspondant au sélecteur CSS :
a[href]
Déclenche uniquement sur les domaines de votre choix.
- Type logique : normal
- Extension : Core
- Type de condition : comparaison de valeurs
- Opérateur de gauche :
%this.hostname% - Opérateur : Match Regex
- Opérateur de droite : expression régulière qui correspond aux domaines souhaités. Par exemple :
adobe.com$|behance.com$
Ajoutez l’identité à l’URL.
- Extension : SDK Web Adobe Experience Platform
- Type d’action : redirection avec identité
Ajout d’une identité à l’URL à l’aide de la bibliothèque JavaScript du SDK Web
Exécutez la commande appendIdentityToUrl avec une URL comme paramètre. La méthode renvoie une URL dont l’identifiant est annexé en tant que chaîne de requête.
alloy("appendIdentityToUrl",document.location);
Vous pouvez ajouter un écouteur d’événement pour tous les clics reçus sur la page et vérifier si l’URL correspond à l’un des domaines souhaités. Dans ce cas, ajoutez l’identité à l’URL et redirigez l’utilisateur.
document.addEventListener("click", event => {
// Check if the click was a link
const anchor = event.target.closest("a");
if (!anchor || !anchor.href) return;
// Check if the link points to the desired domain
const url = new URL(anchor.href);
if (!url.hostname.endsWith(".adobe.com") && !url.hostname.endsWith(".behance.com")) return;
// Append the identity to the URL, then direct the user to the URL
event.preventDefault();
alloy("appendIdentityToUrl", {url: anchor.href}).then(result => {document.location = result.url;});
});
Objet de réponse
Si vous décidez de gérer les réponses avec cette commande, l’objet de réponse contient url, la nouvelle URL avec les informations d’identité ajoutées en tant que paramètre de chaîne de requête.