appendIdentityToUrl
La variable 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 la variable /acquire point d’entrée 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.
- Connexion à 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 à Règles, puis sélectionnez la règle de votre choix.
- Sous Actions, sélectionnez une action existante ou créez-en une.
- Définissez la variable Extension du champ déroulant vers SDK Web Adobe Experience Platform, puis définissez la variable Type d’action to Redirection vers une identité.
- Cliquez sur Conserver les modifications, puis exécutez votre workflow 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’une balise d’ancrage comporte une balise href Cliquez sur la propriété .
- 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 de logique: régulier
- Extension : Core
- Type de condition: comparaison de valeurs
- Opérateur de gauche:
%this.hostname% - Opérateur: Matches Regex
- Opérateur de droit: expression régulière qui correspond aux domaines de votre choix. 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 variable 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 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.