appendIdentityToUrl
Med kommandot appendIdentityToUrl
kan du lägga till en användaridentifierare i URL:en som en frågesträng. Den här åtgärden gör att du kan föra en besökares identitet mellan domäner, vilket förhindrar att besökarantal dupliceras för datauppsättningar som innehåller både domäner och kanaler. Det finns på Web SDK version 2.11.0 eller senare.
Frågesträngen som genereras och läggs till i URL:en är adobe_mc
. Om Web SDK inte kan hitta ett ECID anropar den /acquire
-slutpunkten för att generera ett.
Lägg till identitet i URL med hjälp av Web SDK-tillägget extension
En URL-adress läggs till som en åtgärd i en regel i tagggränssnittet för Adobe Experience Platform Data Collection.
- Logga in på experience.adobe.com med dina Adobe ID-inloggningsuppgifter.
- Navigera till Data Collection > Tags.
- Välj önskad taggegenskap.
- Navigera till Rules och markera önskad regel.
- Välj en befintlig åtgärd under Actions eller skapa en åtgärd.
- Ställ in listrutefältet Extension på Adobe Experience Platform Web SDK och ställ in Action Type på Redirect with identity.
- Klicka på Keep Changes och kör sedan ditt publiceringsarbetsflöde.
Det här kommandot används vanligtvis med en viss regel som lyssnar efter klickningar och kontrollerar vilka domäner du vill använda.
Utlöses när någon klickar på en ankartagg med egenskapen href
.
- Extension: Kärna
- Event type: Klicka
- When the user clicks on: Specifika element
- Elements matching the CSS selector:
a[href]
Utlöses bara på önskade domäner.
- Logic type: Normal
- Extension: Kärna
- Condition Type: Värdejämförelse
- Left Operand:
%this.hostname%
- Operator: Matchar Regex
- Right Operand: Ett reguljärt uttryck som matchar de önskade domänerna. Exempel:
adobe.com$|behance.com$
Lägg till identiteten i URL:en.
- Extension: Adobe Experience Platform Web SDK
- Action Type: Omdirigera med identitet
Bifoga identitet till URL med hjälp av JavaScript-biblioteket för Web SDK
Kör kommandot appendIdentityToUrl
med en URL som parameter. Metoden returnerar en URL med identifieraren tillagd som en frågesträng.
alloy("appendIdentityToUrl",document.location);
Du kan lägga till en händelseavlyssnare för alla klick som tas emot på sidan och kontrollera om URL:en matchar önskade domäner. Om den gör det lägger du till identiteten i URL:en och dirigerar om användaren.
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;});
});
Svarsobjekt
Om du bestämmer dig för att hantera svar med det här kommandot innehåller svarsobjektet url
, den nya URL-adressen med identitetsinformation som lagts till som en frågesträngsparameter.