Documentation Experience Platform Guide du SDK web

`appendIdentityToUrl`

Dernière mise à jour : 27 février 2025

Rubriques :

Créé pour :

Développeur

La commande appendIdentityToUrl vous permet d’ajouter un identifiant utilisateur à l’URL sous la forme d’une chaîne de requête. Cette action vous permet de transférer l’identité d’un visiteur ou d’une visiteuse entre les domaines, ce qui empêche le décompte de visiteurs en double pour les jeux de données qui incluent les deux domaines ou canaux. Il est disponible dans les versions 2.11.0 ou ultérieures de Web SDK.

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 d’entrée /acquire pour en générer un.

NOTE

Si le consentement n’a pas été fourni, l’URL de cette méthode est renvoyée sans modification. Cette commande s’exécute immédiatement ; elle n’attend pas une mise à jour du consentement.

Ajout d’une identité à une URL à l’aide de l’extension Web SDK

L’ajout d’une identité à une URL est effectué en tant qu’action dans une règle de l’interface des balises de la 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 à 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 le champ déroulant Extension sur Adobe Experience Platform Web SDK, puis définissez le Type d’action sur Rediriger avec 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.

Critères d’événement de règle

Se 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 : Eléments spécifiques
Éléments correspondant au sélecteur CSS : a[href]

Événement de règle

Condition de règle

Déclenche uniquement sur les domaines souhaités.

Type de logique : Standard
Extension : Core
Type de condition : comparaison de valeurs
Opérande de gauche : %this.hostname%
Operator : Correspond à l’expression régulière
Opérande droit : expression régulière correspondant aux domaines souhaités. Par exemple : adobe.com$|behance.com$

Condition de règle

Action de règle

Ajoutez l’identité à l’URL.

Extension : SDK Web Adobe Experience Platform
Type d’action : redirection avec identité

Action de la règle

Ajout d’une identité à une URL à l’aide de la bibliothèque JavaScript Web SDK

Exécutez la commande appendIdentityToUrl avec une URL comme paramètre. La méthode renvoie une URL avec l’identifiant ajouté sous la forme d’une chaîne de requête.

alloy("appendIdentityToUrl",
  {
    url: document.location.href
  }
);

Vous pouvez ajouter un écouteur d’événement pour tous les clics reçus sur la page et vérifier si l’URL correspond aux domaines souhaités. Si c’est le 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 des informations d’identité ajoutées comme paramètre de chaîne de requête.

recommendation-more-help