DokumentationExperience PlatformDatenerfassung

idMigrationEnabled

Letzte Aktualisierung: 9. Juli 2026

Erstellt für:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Die idMigrationEnabled-Eigenschaft ermöglicht es dem Web-SDK, AMCV-Cookies zu lesen, die vom vorherigen Besucher-ID-Dienst von Adobe (ECID) festgelegt wurden. Wenn Ihr Unternehmen Ihre Implementierung auf die Web-SDK aktualisiert, ermöglicht diese Einstellung einen reibungsloseren Übergang zum aktuellen Experience Platform Identity Service. Diese Einstellung ist nützlich, damit beim Upgrade auf Web SDK keine starke Zunahme von Unique Visitors auftritt.

Wenn Ihr Unternehmen eine neue Web SDK-Implementierung ausführt, hat die Aktivierung dieser Einstellung keine Auswirkungen auf die Datenerfassung oder Besucheridentifizierung. Es hat keine Nachteile, wenn es für alle Implementierungen aktiviert bleibt.

Funktionsweise der Identitätsmigration how-it-works

Der Besucher-ID-Dienst speichert die Experience Cloud-ID (ECID) in einem Cookie namens AMCV_<ORG_ID>. Wenn idMigrationEnabled (Standard) true ist, liest Web SDK automatisch die ECID aus dem AMCV-Cookie und verwendet sie bei der ersten Edge Network-Anfrage als Besucheridentität.

  1. Ein Besucher gelangt auf eine Seite, die jetzt die Web-SDK anstelle des Besucher-ID-Service verwendet.
  2. Web SDK sucht nach einem vorhandenen kndctr_-Identitäts-Cookie (seinem eigenen Cookie-Format). Wenn kein Cookie gefunden wird, wird nach einem AMCV_ Cookie gesucht.
  3. Wenn ein AMCV_ Cookie gefunden wird, extrahiert Web SDK die ECID und verwendet sie, um die Besucheridentität zu initialisieren.
  4. Web SDK setzt ein neues kndctr_-Identitäts-Cookie mit derselben ECID.
  5. Bei nachfolgenden Besuchen verwendet Web SDK das kndctr_-Cookie direkt. Das AMCV_-Cookie wird nicht mehr benötigt.

Damit die Migration funktioniert, muss die Web-SDK mit demselben orgId konfiguriert werden, den der Besucher-ID-Dienst verwendet hat, und muss in derselben Domain (oder einer Subdomain derselben übergeordneten Domain) bereitgestellt werden, in der das AMCV-Cookie gesetzt wurde.

Unterstützte Migrationsszenarien

Die ID-Migration unterstützt die folgenden Übergangsmuster:

  • Einige Seiten verwenden weiterhin den Besucher-ID-Dienst, während andere Seiten Web SDK verwenden: Der SDK liest vorhandene AMCV-Cookies und schreibt ein neues Cookie mit der bestehenden ECID. AMCV-Cookies werden auch so geschrieben, dass Seiten, die noch den Besucher-ID-Dienst verwenden, denselben Besucher weiterhin erkennen.
  • Web SDK und Besucher-ID-Dienst sind beide auf derselben Seite vorhanden: Wenn das AMCV-Cookie nicht gesetzt ist, sucht die SDK auf der Seite nach dem Besucher-ID-Dienst und verwendet diesen zum Abrufen der ECID.
  • Die Website wurde vollständig in Web SDK verschoben: Sie können die Migration für einen bestimmten Zeitraum aktiviert lassen, sodass bestehende AMCV-basierte Besucherinnen und Besucher die Kontinuität behalten, während ihre Cookies übergeben werden.
IMPORTANT
Laden Sie nicht gleichzeitig den Besucher-ID-Dienst (ECID) und den Web-SDK auf dieselbe Seite, es sei denn, Sie haben bestätigt, dass das AMCV-Cookie bereits gesetzt ist. Die Ausführung beider Bibliotheken auf einer einzelnen Seite kann Racebedingungen verursachen, bei denen jede Bibliothek versucht, Identität unabhängig zu verwalten, was möglicherweise doppelte oder widersprüchliche ECIDs erzeugt.

Deaktivieren der Migration turn-off-migration

Nachdem Ihre gesamte Site auf der Web-SDK ausgeführt wird und keine Besuchenden nur ein AMCV_ Cookie ohne das entsprechende kndctr_-Cookie mit sich führen, können Sie die Identitätsmigration sicher deaktivieren, indem Sie idMigrationEnabled auf false setzen. Diese Aktualisierung stellt eine geringfügige Leistungsoptimierung dar und reduziert die Oberfläche Ihrer Identitätslogik.

Warten Sie als Richtlinie, bis die maximale Lebensdauer des AMCV-Cookies nach der Migration der letzten Seite abgelaufen ist. Wenn Ihre AMCV-Cookies zwei Jahre ablaufen, warten Sie zwei Jahre, nachdem die letzte Seite an die Web-SDK übergeben wurde. In der Praxis deaktivieren die meisten Unternehmen die Migration früher (nach einigen Monaten) und akzeptieren eine zu vernachlässigende Inflation durch die geringe Anzahl von Besuchern, die nach langer Abwesenheit zum ersten Mal zurückkehren.

Audience Manager-Eigenschaftsaktualisierungen

Wenn während der Migration XDM-formatierte Daten an Audience Manager gesendet werden, müssen diese Daten in Signale konvertiert werden. Ihre Eigenschaften müssen aktualisiert werden, um die neuen, von XDM bereitgestellten Schlüssel widerzuspiegeln. Dieser Prozess wird durch die Verwendung des BAAAM-Tools vereinfacht.

Migration der Drittanbieter-ID third-party-id

Wenn Ihre Implementierung des Besucher-ID-Service IDs von Drittanbietern (das demdex.net-Cookie) verwendet, kann die Web-SDK diese ebenfalls migrieren. Konfigurieren Sie thirdPartyCookiesEnabled für true in Ihrer Web SDK-Konfiguration. Web SDK liest das vorhandene Demdex-Cookie und fügt die Drittanbieteridentität in seine Edge Network-Anfragen ein, wobei demselben Migrationsmuster wie das AMCV-Cookie gefolgt wird.

Validierung validation

So überprüfen Sie, ob die Identitätsmigration ordnungsgemäß funktioniert:

  1. Öffnen Sie eine Seite, die zuvor den Besucher-ID-Dienst verwendet hat (jetzt unter Verwendung der Web-SDK), in einem Browser, der über ein AMCV_-Cookie verfügt.
  2. Stellen Sie in den Entwickler-Tools sicher, dass ein kndctr_ Identitäts-Cookie gesetzt wurde und dass die ECID mit der im AMCV_-Cookie übereinstimmt.
  3. Vergleichen Sie nach der Bereitstellung die Zahlen der Unique Visitors vor und nach der Migration für denselben Zeitraum. Ein deutlicher Anstieg der Unique Visitors kann darauf hinweisen, dass die Migration keine Identitäten weiterträgt.
TIP
Verwenden Sie getIdentity , um die ECID zum Vergleich programmgesteuert abzurufen:
code language-js 
alloy("getIdentity", { namespaces: ["ECID"] }).then(function(result) {
      console.log("ECID:", result.identity.ECID);
    });

Konfigurieren von idMigrationEnabled configure

Legen Sie beim Ausführen des configure-Befehls den booleschen Wert idMigrationEnabled fest. Wenn Sie diese Eigenschaft beim Konfigurieren der Web-SDK auslassen, wird sie standardmäßig auf true gesetzt. Legen Sie diese Eigenschaft fest, wenn Sie die Möglichkeit deaktivieren möchten, AMCV-Cookies zu lesen, die vom Besucher-ID-Dienst festgelegt wurden. Die meisten Organisationen müssen diese Eigenschaft nicht festlegen.

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  idMigrationEnabled: false
});

Aktivieren der Migration von Besucher-IDs mithilfe der Tag-Erweiterung von Web SDK

Diese Einstellungen können in der Tag-Erweiterung „Web SDK" mithilfe von Identitätskonfigurationseinstellungen konfiguriert werden.

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