DokumentationExperience PlatformDatenerfassung

[Alpha]{class="badge informative"}

idMigrationEnabled (Server-SDK)

Letzte Aktualisierung: 30. Oktober 2026

Erstellt für:

  • Developer

Auf dieser Seite werden idMigrationEnabled in der configure-Methode von Server SDK beschrieben. Informationen zu Web SDK finden Sie unter idMigrationEnabled.

style
shade-box

Mit der idMigrationEnabled-Eigenschaft kann der SDK-Server Experience Cloud-IDs (ECIDs) wiederverwenden, die den Besuchern vom alten Adobe-Besucher-ID-Dienst (VisitorAPI.js) zugewiesen wurden. Der Besucher-ID-Dienst speichert die ECID in einem Cookie namens AMCV_<orgId>. Durch die Wiederverwendung dieser IDs wird ein starker Anstieg der Unique Visitors verhindert, wenn Sie vom Besucher-ID-Service zur Web-SDK oder zur Server-SDK wechseln.

Funktionsweise der Identitätsmigration auf einem Server how-it-works

Der SDK liest und schreibt Cookies über den Cookie-Service, den Sie an forRequest übergeben. Wenn idMigrationEnabled true wird:

  1. Wenn der Besucher kein kndctr_<orgId>_identity-Cookie, aber ein AMCV_<orgId>-Cookie hat, liest SDK die ECID aus dem AMCV_-Cookie und fügt sie dem identityMap des Ereignisses hinzu. Die Edge Network verwendet diese ECID dann weiterhin für den Besucher.
  2. Nachdem Edge Network die Besucheridentität zurückgegeben hat, schreibt SDK sie sowohl in das kndctr_<orgId>_identity-Cookie als auch in das AMCV_<orgId>-Cookie, sodass Seiten, die weiterhin den Besucher-ID-Dienst verwenden, denselben Besucher erkennen.

Die Identitätsmigration funktioniert nur, wenn Ihr Cookie-Service SDK Zugriff auf die echten Browser-Cookies des Besuchers gewährt, und nur, wenn der Besucher-ID-Service auf derselben Domain mit derselben orgId ausgeführt wurde. Der SDK-Server kann keine Identitäten aus der Besucher-ID-Dienstbibliothek lesen, da diese nur in Browsern ausgeführt wird.

Wenn Ihr Cookie-Service die Browser-Cookies des Besuchers nicht liest oder Ihre Site den Besucher-ID-Service nie verwendet hat, hat die Identitätsmigration keine Auswirkungen.

Code-Beispiel

Legen Sie beim Aufruf von configure den booleschen idMigrationEnabled fest. Wenn Sie dies auslassen, wird standardmäßig true verwendet. Setzen Sie ihn auf false, um zu verhindern, dass der SDK AMCV_ Cookies liest und schreibt.

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  },
  idMigrationEnabled: false
});
recommendation-more-help
experience-platform-help-collection