DokumentationExperience PlatformTags

Zugreifen auf die ECID

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler

Die Experience Cloud Identity (ECID) ist eine persistente Kennung, die einem Benutzer beim Besuch einer Website zugewiesen wird. Unter bestimmten Umständen möchten Sie vielleicht lieber auf die ECID zugreifen (um sie beispielsweise an einen Drittanbieter zu senden). Ein weiterer Anwendungsfall besteht darin, die ECID in einem benutzerdefinierten XDM-Feld festzulegen, zusätzlich zu ihrer Verwendung in der Identitätszuordnung.

Sie können auf die ECID entweder über Datenvorbereitung für die Datenerfassung (empfohlen) oder über Tags zugreifen.

Zugriff auf die ECID über die Datenvorbereitung (bevorzugte Methode) accessing-ecid-data-prep

Diese Methode verwendet Datenvorbereitung für die Datenerfassung um eine benutzerdefinierte Zuordnung für die ECID zu konfigurieren.

Weitere Informationen zur Verwendung ​ Funktion finden Sie in der ​ zur Datenvorbereitung für die Datenerfassung .

Wenn Sie die ECID nicht nur in der Identitätszuordnung haben, sondern auch in einem benutzerdefinierten XDM-Feld festlegen möchten, können Sie dies tun, indem Sie die source auf den folgenden Pfad festlegen:

xdm.identityMap.ECID[0].id

Legen Sie dann das Ziel auf einen XDM-Pfad fest, in dem das Feld vom Typ string ist.

Tags

Wenn Sie Client-seitig auf die ECID zugreifen müssen, verwenden Sie den Tag-Ansatz wie unten beschrieben.

  1. Stellen Sie sicher, dass die Eigenschaft mit Regelkomponentensequenzierung konfiguriert ist.

  2. Erstellen Sie eine neue Regel. Diese Regel sollte ausschließlich zur Erfassung der ECID ohne andere wichtige Aktionen verwendet werden.

  3. Fügen Sie der Regel ein Library Loaded Ereignis hinzu.

  4. Fügen Sie der Regel eine Custom Code Aktion mit dem folgenden Code hinzu (vorausgesetzt, der Name, den Sie für die SDK-Instanz konfiguriert haben, ist alloy und es gibt noch kein Datenelement mit demselben Namen):

    code language-js 
     return alloy("getIdentity")
   .then(function(result) {
     _satellite.setVar("ECID", result.identity.ECID);
   });

  5. Speichern Sie die Regel.

Anschließend sollten Sie in der Lage sein, in nachfolgenden Regeln mithilfe von ECID oder %ECID% auf die _satellite.getVar("ECID") zuzugreifen, wie Sie auch auf jedes andere Datenelement zugreifen würden.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743