appendIdentityToUrl
Die appendIdentityToUrl -Befehl 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, wird die /acquire -Endpunkt zu erstellen.
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.
- Anmelden bei experience.adobe.com mit Ihren Adobe ID-Anmeldedaten.
- 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.
- under Aktionen, wählen Sie eine vorhandene Aktion aus oder erstellen Sie eine Aktion.
- Legen Sie die Erweiterung Dropdown-Feld zu Adobe Experience Platform Web SDK und legen Sie die Aktionstyp nach Umleiten mit Identität.
- Klicks Ä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 ein Anker-Tag href -Eigenschaft angeklickt wird.
- Erweiterung: Core
- Ereignistyp: Klicken
- Wenn der Benutzer auf: Spezifische Elemente
- Elemente, die mit der CSS-Auswahl übereinstimmen:
a[href]
Trigger nur auf gewünschten Domänen.
- Logiktyp: Normal
- Erweiterung: Core
- Bedingungstyp: Wertvergleich
- Linke Opera:
%this.hostname% - Operator: Entspricht Regex
- Rechter 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: Umleitung mit Identität
Identität an URL mithilfe der Web SDK-JavaScript-Bibliothek anhängen
Führen Sie die appendIdentityToUrl -Befehl mit einer URL als Parameter. 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, enthält das Antwortobjekt url, die neue URL mit Identitätsdaten, die als Abfragezeichenfolgenparameter hinzugefügt werden.