appendIdentityToUrl
Mit dem Befehl appendIdentityToUrl können Sie der URL eine Benutzerkennung als Abfragezeichenfolge hinzufügen. Mit dieser Aktion können Sie die Identität eines Besuchers zwischen Domains übertragen und so doppelte Besucherzahlen für Datensätze verhindern, die sowohl Domains als auch Kanäle enthalten. Sie ist in Web SDK ab Version 2.11.0 verfügbar.
Die generierte und an die URL angehängte Abfragezeichenfolge wird adobe_mc. Wenn Web SDK keine ECID finden kann, ruft es den /acquire-Endpunkt auf, um eine zu generieren.
Anhängen von Identitäten an URLs mithilfe der Web SDK-Erweiterung extension
Das Anhängen einer Identität an eine URL wird als Aktion innerhalb einer Regel in der Benutzeroberfläche „Tags der Datenerfassung“ von Adobe Experience Platform ausgeführt.
- Melden Sie sich mit Ihren Adobe IDAnmeldeinformationen beiexperience.adobe.com) an.
- Navigieren Sie Datenerfassung > Tags.
- Wählen Sie die gewünschte Tag-Eigenschaft aus.
- Navigieren Sie zu Regeln und wählen Sie dann die gewünschte Regel aus.
- Wählen unter "" eine vorhandene Aktion aus oder erstellen Sie eine Aktion.
- Legen Sie das Erweiterung Dropdown-Feld auf Adobe Experience Platform Web SDK fest und legen Sie den Aktionstyp auf Umleiten mit Identität fest.
- Klicken Sie Änderungen beibehalten und führen Sie dann den Veröffentlichungs-Workflow aus.
Dieser Befehl wird normalerweise mit einer bestimmten Regel verwendet, die auf Klicks wartet und die gewünschten Domains prüft.
Trigger beim Klicken auf ein Anker-Tag mit einer href.
- Erweiterung: Core
- Ereignistyp: Klicken
- Wenn der Benutzer auf klickt: Bestimmte Elemente
- Elemente, die mit der CSS-Auswahl übereinstimmen:
a[href]
Trigger nur auf den gewünschten Domains.
- Logiktyp: Regulär
- Erweiterung: Core
- Bedingungstyp: Wertvergleich
- Linker Operand:
%this.hostname% - Operator: stimmt mit Regex überein
- Rechter Operand: Ein regulärer Ausdruck, der den gewünschten Domains entspricht. Beispiel:
adobe.com$|behance.com$
Hängen Sie die Identität an die URL an.
- Erweiterung: Adobe Experience Platform Web SDK
- Aktionstyp: Mit Identität umleiten
Anhängen von Identitäten an URLs mithilfe der Web SDK JavaScript-Bibliothek
Führen Sie den appendIdentityToUrl Befehl mit einer URL als Parameter aus. Die Methode gibt eine URL zurück, an die die Kennung als Abfragezeichenfolge angehängt wird.
alloy("appendIdentityToUrl",document.location);
Sie können einen Ereignis-Listener für alle auf der Seite empfangenen Klicks hinzufügen und überprüfen, ob die URL mit den gewünschten Domains übereinstimmt. Hängen Sie in diesem Fall die Identität an die URL an und leiten Sie den Benutzer weiter.
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;});
});
Antwortobjekt
Wenn Sie sich für Handhabung von Antworten mit diesem Befehl entscheiden, enthält das Antwortobjekt url, die neue URL mit Identitätsinformationen, die als Abfragezeichenfolgenparameter hinzugefügt werden.