Auf dieser Seite wird die ServerSDK-getIdentity beschrieben. Informationen zu Web SDK finden Sie unter getIdentity.
Die getIdentity Methode gibt die Experience Cloud ID (ECID) des Besuchers zurück, ohne Ereignisdaten zu senden. Wenn Sie sendEvent aufrufen, erstellt die Edge Network automatisch die Identität des Besuchers. Verwenden Sie getIdentity daher nur, wenn Ihr Server die ECID selbst benötigt. Beispielsweise können Sie damit die ECID mit Ihren eigenen Datensätzen speichern oder an ein anderes System übergeben.
Rufen Sie getIdentity auf dem forRequest des Besuchers auf:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const result = await visitor.getIdentity({
namespaces: ["ECID"]
});
console.log(result.identity.ECID);
Die SDK verwendet den folgenden Fluss, um die ECID zurückzugeben:
- Der SDK prüft, ob das Einverständnis den Vorgang zulässt. Wenn der Besucher sich abgemeldet hat, wird
getIdentitymit einem leeren Objekt aufgelöst. - Wenn das Identitäts-Cookie des Besuchers über den Cookie-Service verfügbar ist, den Sie an
forRequestübergeben haben, liest die SDK die ECID daraus, ohne sich an Adobe zu wenden. - Andernfalls fordert die SDK die Besucheridentität von der Edge Network an, schreibt das Identitäts-Cookie über Ihren Cookie-Dienst und gibt die ECID zurück.
Die Anfrage an die Edge Network ist nicht authentifiziert. Stellen Sie sicher, dass Ihr Datenstrom nicht authentifizierte Anfragen akzeptiert. Siehe Festlegen des Datenstromzugriffstyps.
Wenn Sie keinen Cookie-Service an forRequest übergeben, kann die SDK keine vorhandene Identität finden, sodass jedes forRequest-Handle eine neue ECID erhält. Siehe Instanzen und Anfragen.
Optionen options
Die getIdentity-Methode akzeptiert ein optionales Objekt mit den folgenden Eigenschaften:
namespaces: Ein Array der zurückzugebenden Identity-Namespaces. Unterstützte Werte sind"ECID"und"CORE". Der Standardwert lautet["ECID"]. Sie können den"CORE"-Namespace nur anfordern, wennthirdPartyCookiesEnabledtrueist. Andernfalls lehntgetIdentityab.edgeConfigOverrides: Ein Datenstromkonfigurations-Überschreibungsobjekt für diese Anfrage.
Ergebnisobjekt result
Die getIdentity Methode gibt eine Zusage zurück. Wenn es aufgelöst wird, enthält das Ergebnisobjekt die folgenden Eigenschaften:
identity.ECID: Eine Zeichenfolge, die die ECID des Besuchers enthält.identity.CORE: Eine Zeichenfolge, die die CORE-ID des Besuchers enthält, wenn Sie denCORE-Namespace angefordert haben.edge.regionId: Eine Ganzzahl, die die Edge Network-Region identifiziert, die die Anfrage verarbeitet hat. Diese Eigenschaft ist nur vorhanden, wenn der SDK die Edge Network kontaktiert hat, um die Identität abzurufen.
const { identity } = await visitor.getIdentity();
console.log(identity.ECID);