Auf dieser Seite wird die ServerSDK-appendIdentityToUrl beschrieben. Informationen zu Web SDK finden Sie unter appendIdentityToUrl.
Die appendIdentityToUrl Methode fügt die Identität des Besuchers einer URL als Abfragezeichenfolgenparameter mit dem Namen adobe_mc hinzu. Wenn der Besucher der URL zu einer anderen Domain folgt, deren Inhaber Sie sind, liest der Web SDK oder der Server SDK in dieser Domain den Parameter und behält die ECID bei. Dadurch wird verhindert, dass der Besucher in Datensätzen, die beide Domains enthalten, zweimal gezählt wird.
Auf einem -Server besteht eine gängige Verwendung darin, die Identität des Besuchers zu einer Umleitung auf eine andere Domain hinzuzufügen:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const { url } = await visitor.appendIdentityToUrl({
url: "https://shop.example.net/checkout"
});
res.writeHead(302, { Location: url });
res.end();
Die resultierende URL sieht in etwa wie folgt aus:
https://shop.example.net/checkout?adobe_mc=TS%3D1792711449%7CMCMID%3D34567890123456789012345678901234567890%7CMCORGID%3DADB3LETTERSANDNUMBERS%2540AdobeOrg
Wenn die SDK noch nicht über die ECID des Besuchers verfügt, wird zuerst eine von Edge Network angefordert. Diese Anfrage ist nicht authentifiziert. Siehe Festlegen des Datenstromzugriffstyps.
Wenn der Besucher sich abgemeldet hat oder defaultConsent "out" ist und der Besucher sich nicht angemeldet hat, gibt die Methode die URL unverändert zurück. Sie gibt auch die URL unverändert zurück, anstatt sie abzulehnen, wenn sie die Identität des Besuchers nicht abrufen kann, z. B. aufgrund eines Netzwerkfehlers. Wenn Debugging aktiviert ist, protokolliert die SDK eine Warnung mit Unable to append identity to url.
Optionen options
Die appendIdentityToUrl-Methode akzeptiert ein -Objekt mit den folgenden Eigenschaften:
url: Erforderlich. Die URL, der die Identität des Besuchers hinzugefügt werden soll.edgeConfigOverrides: Ein Datenstromkonfigurations-Überschreibungsobjekt für diese Anfrage.
Ergebnisobjekt result
Die appendIdentityToUrl Methode gibt eine Zusage zurück. Wenn es aufgelöst wird, enthält das Ergebnisobjekt url, die URL mit dem adobe_mc Abfragezeichenfolgenparameter hinzugefügt.