DokumentationExperience PlatformDatenerfassung

getIdentity (Web SDK)

Letzte Aktualisierung: 6. November 2026

Erstellt für:

  • Fortgeschritten
  • Entwicklerin/Entwickler

Auf dieser Seite wird der getIdentity-Befehl von Web SDK beschrieben. Informationen zum Server-SDK finden Sie unter getIdentity.

style
shade-box

Wenn Sie den sendEvent Befehl ausführen, ruft die Web-SDK automatisch die Besucheridentität ab, sofern noch keine vorhanden ist. Mit dem Befehl getIdentity können Sie eine ECID abrufen, ohne Ereignisdaten zu senden. Wenn Sie separate Aufrufe benötigen, um eine ECID zu generieren und Daten zu senden, können Sie diesen Befehl verwenden.

IMPORTANT
Verwenden Sie getIdentity, wenn Sie Identitätsinformationen auf Client-Seite benötigen. Wenn Sie nur die ECID in XDM zuordnen müssen, verwenden Sie stattdessen Datenvorbereitung für die Datenerfassung oder die Tags-ECID-.

Der getIdentity Befehl durchläuft den folgenden Fluss, um die ECID abzurufen.

  1. Sie verwenden Web SDK, um entweder getIdentity oder appendIdentityToUrl aufzurufen.
  2. Web SDK wartet auf die Bereitstellung von Einverständnisinformationen.
  3. Web SDK prüft, ob beim Aufruf der ECID Namespace angefordert wurde. Standardmäßig ist der ECID-Namespace immer enthalten.
  4. Web SDK liest das kndctr-Cookie und gibt seinen Wert als ECID zurück, falls vorhanden. Dadurch wird nur der ECID Wert zurückgegeben, nicht aber die regionId.
  5. Wenn das kndctr Identitäts-Cookie nicht gesetzt ist oder der "CORE"-Namespace angefordert wurde, sendet Web SDK eine Anfrage an die Edge Network.
  6. Die Edge Network gibt sowohl die ECID als auch die regionId (und die CORE ID, falls angefordert) zurück.

Führen Sie den getIdentity Befehl aus, wenn Sie Ihre konfigurierte Instanz der Web-SDK aufrufen. Die folgenden Optionen sind bei der Konfiguration dieses Befehls verfügbar:

  • namespaces: Ein Array von Namespaces. Der Standardwert lautet ["ECID"]. Weitere unterstützte Werte sind:

    • ["CORE"]
    • ["ECID","CORE"]
    • null
    • undefined

    Sie können "ECID" und "CORE ID" gleichzeitig anfordern. Beispiel: "namespaces": ["ECID","CORE"].

  • edgeConfigOverrides: Ein Datenstromkonfigurations-Überschreibungsobjekt.

alloy("getIdentity",{
  // This command retrieves both ECID and CORE IDs
  "namespaces": ["ECID","CORE"]
});

Antwortobjekt

Wenn Sie sich für Handhabung von Antworten mit diesem Befehl entscheiden, sind die folgenden Eigenschaften im Antwortobjekt verfügbar:

  • identity.ECID: Eine Zeichenfolge, die die ECID des Besuchers enthält.
  • identity.CORE: Eine Zeichenfolge, die die CORE-ID des Besuchers enthält.
  • edge.regionID: Eine Ganzzahl, die die Edge Network-Region darstellt, die der Browser beim Erfassen einer Identität aufgerufen hat. Es ist identisch mit dem Legacy-Standorthinweis für Audience Manager.
// Get the visitor's ECID
alloy('getIdentity').then(result => {
  console.log(result.identity.ECID);
});

Abrufen von Identitäten mithilfe der Tag-Erweiterung „Web SDK"

Die Web-Tag-Erweiterung von SDK bietet diesen Befehl nicht über die Benutzeroberfläche der Tag-Erweiterung an. Verwenden Sie den Editor für benutzerspezifischen Code unter Verwendung der JavaScript-Bibliothekssyntax.

recommendation-more-help
experience-platform-help-collection