DokumentationExperience PlatformTags

Zugreifen auf die ECID

Last update: Mon May 05 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 derzur 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 ​ Regel ein Ereignis ​Bibliothek geladen“ hinzu.

  4. Fügen Sie ​ Regel eine Aktion ​Benutzerdefinierter Code“ mit dem folgenden Code hinzu (vorausgesetzt, der für die SDK-Instanz konfigurierte Name 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 _satellite.getVar("ECID") auf die ECID zuzugreifen, wie Sie auch auf jedes andere Datenelement zugreifen würden.

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