appendIdentityToUrl
Mit dem Befehl appendIdentityToUrl können Sie der URL eine Benutzer-ID als Abfragezeichenfolge hinzufügen. Mit dieser Aktion können Sie die Identität eines Besuchers zwischen Domänen übertragen, wodurch doppelte Besucherzahlen für Datensätze verhindert werden, die sowohl Domänen als auch Kanäle enthalten. Sie ist in Web SDK-Versionen 2.11.0 oder höher verfügbar.
Die generierte und an die URL angehängte Abfragezeichenfolge lautet adobe_mc. Wenn das Web SDK keine ECID finden kann, ruft es den /acquire -Endpunkt auf, um eine zu generieren.
Anhängen der Identität an URL mithilfe der Web SDK-Erweiterung extension
Das Anhängen einer Identität an eine URL erfolgt als Aktion innerhalb einer Regel in der Adobe Experience Platform-Oberfläche für Datenerfassungs-Tags.
- Melden Sie sich mit Ihren Adobe ID-Anmeldedaten bei experience.adobe.com an.
- Navigieren Sie zu 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 Sie unter Aktionen eine vorhandene Aktion aus oder erstellen Sie eine Aktion.
- Setzen Sie das Dropdown-Feld Erweiterung auf Adobe Experience Platform Web SDK und setzen Sie den Aktionstyp auf Mit Identität umleiten.
- Klicken Sie auf Änderungen beibehalten und führen Sie dann Ihren Veröffentlichungs-Workflow aus.
Dieser Befehl wird normalerweise mit einer bestimmten Regel verwendet, die auf Klicks prüft und die gewünschten Domänen überprüft.
Trigger, wenn auf ein Anker-Tag mit der Eigenschaft href geklickt wird.
- Erweiterung: Core
- Ereignistyp: Klicken Sie auf
- Wenn der Benutzer auf klickt: Bestimmte Elemente
- Elemente, die mit dem CSS-Selektor übereinstimmen:
a[href]
Trigger nur auf gewünschten Domänen.
- Logiktyp: Normal
- Erweiterung: Core
- Bedingungstyp: Wertvergleich
- Left Operand:
%this.hostname% - Operator: Entspricht Regex
- Right Operand: Ein regulärer Ausdruck, der den gewünschten Domänen 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 der Identität an URL mithilfe der Web SDK JavaScript-Bibliothek
Führen Sie den Befehl appendIdentityToUrl mit einer URL als Parameter aus. Die Methode gibt eine URL zurück, an die die Kennung als Abfragezeichenfolge angehängt ist.
alloy("appendIdentityToUrl",document.location);
Sie können einen Ereignis-Listener für alle Klicks hinzufügen, die auf der Seite empfangen werden, und überprüfen, ob die URL mit den gewünschten Domänen übereinstimmt. Wenn dies der Fall ist, hängen Sie 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 Antworten verarbeiten mit diesem Befehl entscheiden, enthält das Antwortobjekt url, die neue URL mit Identitätsdaten, die als Abfragezeichenfolgenparameter hinzugefügt werden.