appendIdentityToUrl
Met de opdracht appendIdentityToUrl kunt u een gebruiker-id aan de URL toevoegen als een queryreeks. Met deze actie kunt u de identiteit van een bezoeker tussen domeinen dragen, waardoor dubbele bezoekersaantallen voor datasets met zowel domeinen als kanalen worden voorkomen. Het is beschikbaar op versies 2.11.0 van SDK van het Web of later.
De querytekenreeks die wordt gegenereerd en aan de URL wordt toegevoegd, is adobe_mc . Als de Web SDK geen ECID kan vinden, roept het /acquire eindpunt om te produceren.
Identiteit aan URL toevoegen met de extensie Web SDK extension
Het toevoegen van een identiteit aan een URL wordt uitgevoerd als een actie binnen een regel in de interface van de markeringen van de Inzameling van Gegevens van Adobe Experience Platform.
- Login aan experience.adobe.comgebruikend uw geloofsbrieven van Adobe ID.
- Ga naar Data Collection > Tags.
- Selecteer de gewenste eigenschap tag.
- Navigeer naar Rules en selecteer vervolgens de gewenste regel.
- Selecteer onder Actions een bestaande actie of maak een actie.
- Stel het vervolgkeuzeveld Extension in op Adobe Experience Platform Web SDK en stel de waarde Action Type in op Redirect with identity .
- Klik op Keep Changes en voer vervolgens de publicatieworkflow uit.
Dit bevel wordt typisch gebruikt met een specifieke regel die op kliks en controles gewenste domeinen let.
Triggers wanneer op een ankertag met een eigenschap href wordt geklikt.
- Extension: Kern
- Event type: klikken
- When the user clicks on: specifieke elementen
- Elements matching the CSS selector:
a[href]
Triggers worden alleen op de gewenste domeinen geactiveerd.
- Logic type: Standaard
- Extension: Kern
- Condition Type: vergelijking van waarden
- Left Operand:
%this.hostname% - Operator: Komt overeen met Regex
- Right Operand: Een reguliere expressie die overeenkomt met de gewenste domeinen. Bijvoorbeeld:
adobe.com$|behance.com$
Voeg de identiteit toe aan de URL.
- Extension: Adobe Experience Platform Web SDK
- Action Type: Omleiden met identiteit
Identiteit toevoegen aan URL met de Web SDK JavaScript-bibliotheek
Voer de opdracht appendIdentityToUrl uit met een URL als parameter. De methode retourneert een URL waarvan de id als queryreeks is toegevoegd.
alloy("appendIdentityToUrl",document.location);
U kunt een gebeurtenislistener toevoegen voor alle klikken die op de pagina worden ontvangen en controleren of de URL overeenkomt met de gewenste domeinen. Als dit het geval is, voegt u de identiteit toe aan de URL en leidt u de gebruiker om.
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;});
});
Object Response
Als u besluit om reacties 🔗 met dit bevel te behandelen, bevat het reactievoorwerp url, nieuwe URL met identiteitsinformatie die als parameter van het vraagkoord wordt toegevoegd.