idMigrationEnabled

Die idMigrationEnabled-Eigenschaft ermöglicht es dem Web-SDK, AMCV-Cookies zu lesen, die von vorherigen Adobe Experience Cloud-Implementierungen festgelegt wurden. Wenn Ihr Unternehmen Ihre Implementierung auf Web SDK aktualisiert, ermöglicht diese Einstellung einen reibungsloseren Übergang zum aktuellen Adobe Experience Cloud ID-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

Die Besucher-API 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.

Damit die Migration funktioniert, muss die Web-SDK mit demselben orgId konfiguriert werden, den die Besucher-API 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:

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. Dies ist eine geringfügige Leistungsoptimierung 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 Besucher-API-Implementierung Drittanbieter-IDs (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:

alloy("getIdentity", { namespaces: ["ECID"] }).then(function(result) {
   console.log("ECID:", result.identity.ECID);
});

Konfigurieren idMigrationEnabled configure

Legen Sie beim Ausführen des idMigrationEnabled-Befehls den booleschen Wert configure 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 von der Besucher-API festgelegt werden. 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.