Aktualisierung auf Adobe Audience Manager-DIL-Version 8.0 (oder höher) updating-to-adobe-audience-manager-s-dil-version-or-greater
In diesem Artikel finden Sie Schritte und Empfehlungen zur Aktualisierung von Adobe Audience Manager (AAM) Data Integration Library (DIL)-Code auf Version 8.0 oder höher. Dies bezieht sich auf die "clientseitige"DIL-Implementierung, nicht auf die serverseitige Weiterleitung von Adobe Analytics-Daten und umfasst DTM-, Launch by Adobe- und Implementierungen ohne Adobe-Tag-Manager-Lösung.
Überblick overview
Mit dem Audience Manager-Code Data Integration Library (DIL) können Sie AAM auf Ihrer Website implementieren*. Bei der Implementierung früherer Versionen von DIL war es nicht erforderlich, den Experience Cloud ID-Dienst (ECID) von Adobe zu implementieren (obwohl dies eine sehr gute Idee war). Ab DIL-Version 8.0 besteht eine starke Abhängigkeit von ECID-Version 3.3 oder höher. Wenn Sie DIL 8.0 oder höher ohne ECID 3.3 oder mit einer früheren Version implementieren, wird ein Fehler ausgegeben, der nicht funktioniert. Da Sie AAM auf verschiedene Weise implementieren können, haben wir diese Seite erstellt, um Ihnen einige Schritte sowie einige Empfehlungen zu unterbreiten. Unten finden Sie diese Schritte und Empfehlungen aufgeschlüsselt nach Plattform-/Implementierungsmethode. Weitere Informationen zum DIL finden Sie in der Dokumentation.
- Wie in der Beschreibung dieser Seite angegeben, betrifft dies nur Client-seitige DIL-Implementierungen, die von AAM Kunden verwendet werden, die nicht über Adobe Analytics verfügen. Wenn Sie über Adobe Analytics verfügen, sollten Sie die serverseitige Weiterleitungsmethode zur Implementierung von AAM verwenden. Diese Methode wird in der Dokumentation beschrieben.
Duplizieren und veraltete Elemente und Methoden duplicate-and-deprecated-elements-and-methods
In früheren Versionen von DIL und ECID gab es duplizierende Methoden (Methoden, die dieselbe Funktion sowohl bei DIL als auch bei ECID anwenden), was zu Verwirrung darüber führte, welche verwendet werden sollte. In der Regel mussten Sie beide verwenden und sie miteinander verknüpfen, und diese Nachricht wurde unseren Kunden nicht gut kommuniziert. Ab DIL 8.0 sind diese doppelten Methoden und Elemente in DIL nicht mehr enthalten. Es wird empfohlen, die ECID-Version zu verwenden.
Beispiel:
- Bei Verwendung von DIL.create werden einige Elemente nicht mehr unterstützt. Verwenden Sie stattdessen die ECID-Elemente. Diese Elemente werden in der DIL.create Dokumentation aufgerufen.
- Die Methode idSync auf Instanzebene ist ebenfalls veraltet, wie in der Dokumentation der Methode aufgerufen.
ID-Synchronisierung mit einer Kunden-ID id-syncing-with-a-customer-id
In AAM können Sie Ihre UUID (anonyme eindeutige Benutzer-ID) auf dem Computer mit einer Kunden-ID synchronisieren, sodass Sie Offline-Daten zu diesem Kunden hochladen und mit seinem Online-Verhalten verknüpfen können, um ein besseres Verständnis Ihrer Kunden zu erhalten. In der Vergangenheit wurde dies auf zwei Arten durchgeführt:
- Die Methode auf Instanzebene von idSync
- Das Element declaredId in DIL.create
Wenn Sie eine dieser älteren Methoden zur Synchronisierung mit einer Kunden-ID verwendet haben, wird dringend empfohlen, ein Update mit der setCustomerIDs -Methode durchzuführen, die Teil des ECID-Dienstes ist. Weitere Informationen zu setCustomerIDs finden Sie in der Dokumentation der Methode.
Quick Tipp: Wenn Sie zuvor eine der oben genannten Methoden verwendet haben, haben Sie auf die AAM Data Source mit der ID Data Source (AKA die "DPID") verwiesen. Beim Aktualisieren auf setCustomerIDs müssen Sie stattdessen den "Integration Code" des AAM Data Source verwenden. Er verweist weiterhin auf denselben Data Source , ist jedoch nur eine andere Kennung. Dies wird im Video unten gezeigt.
In den folgenden Abschnitten finden Sie Schritte und Empfehlungen für die Aktualisierung auf DIL 8.0 basierend auf Ihrer Implementierungsmethode:
Aktualisieren auf DIL 8.0 in Adobe Experience Platform-Tags updating-to-dil-in-experience-platform-launch
Grundlegende Schritte für die Aktualisierung auf DIL 8.0
-
Wenn Sie DIL vor dem Upgrade vor Version 8.0 verwenden, gehen Sie in die DIL-Konfiguration in der AAM-Erweiterung und beachten Sie alle erweiterten Optionen, die Sie verwenden (die in einem nachfolgenden Schritt verwendet werden sollen).
-
Aktualisieren Sie Ihre AAM-Erweiterung auf Version 8.0 oder höher.
-
Stellen Sie sicher, dass die Experience Cloud ID Service-Erweiterung Version 3.3.0 oder höher ist.
-
Aktivieren Sie für alle veralteten Methoden/Elemente (z. B.
disableIDSyncs), die sich in Ihrer Erweiterung vor 8.0 AAM oder im benutzerdefinierten Code für DIL befanden, die ECID-Methoden in der ECID-Erweiterung.- (DIL)
disableDestinationPublishingIframe-> (ECID)disableIdSyncs - (DIL)
disableIDSyncs-> (ECID)disableIdSyncs - (DIL)
iframeAkamaiHTTPS-> (ECID)dSyncSSLUseAkamai - (DIL)
declaredId-> (ECID)setCustomerIDs
- (DIL)
-
Publish die Änderungen.
Aktualisieren auf DIL 8.0 in Adobe DTM updating-to-dil-in-adobe-dtm
- Aktualisieren Sie Ihr AAM-Tool auf Version 8.0 oder höher. Diese Versionseinstellung befindet sich im Abschnitt "Allgemein"des AAM Tools.
- Notieren Sie sich für alle veralteten Methoden/Elemente (z. B.
disableIDSyncs), die sich im benutzerdefinierten Code Ihres AAM-Tools vor 8.0 befanden, und entfernen Sie sie dann aus dem benutzerdefinierten DIL code im AAM Tool. - Aktualisieren Sie Ihre Experience Cloud ID Service-Erweiterung auf Version 3.3.0 oder höher.
- Fügen Sie dem ECID-Tool die erweiterten Optionen hinzu, die Sie aus dem benutzerdefinierten Code des AAM Tools entfernt haben.
- Publish der Änderungen
Aktualisierung auf DIL 8.0 ohne Adobe Tag Management-Lösung additional-resources
Wenn Sie Ihren Code direkt auf der Seite aktualisieren, können Sie nur ältere Elemente durch neuere Elemente ersetzen, außer wenn Sie, wie oben erläutert, Methoden/Elemente von DIL in ECID verschieben müssen. In diesem Fall ersetzen Sie einfach die alte Methode/das alte Element am DIL-Speicherort durch die ECID-Methode/-Element am ECID-Speicherort.
Dasselbe gilt für Nicht-Adobe-Tag-Manager. Ersetzen Sie die alten Versionen in dieser Tag-Management-Lösung durch den neuen Code, wie in den folgenden Schritten beschrieben.
-
Aktualisieren Sie Ihre DIL-Bibliothek auf die neueste Version (8.0 oder höher) - Sie müssen den neuesten DIL-Code von der Adobe Consulting- oder Adobe-Kundenunterstützung erhalten, da er derzeit nicht an einem öffentlichen Speicherort verfügbar ist. Ersetzen Sie dann einfach den alten DIL-Bibliotheks-Code durch den neuen DIL-Bibliothekscode und fahren Sie mit dem nächsten Schritt fort (stoppen Sie nicht jetzt, oder Sie werden auf Probleme stoßen, ha).
-
Installieren Sie ECID Service oder aktualisieren Sie Ihre vorhandene Version auf 3.3.0 oder höher. Sie können die neueste Version des Experience Cloud ID-Diensts von unserer GitHub-Seite herunterladen. Wenn Sie Hilfe dazu benötigen, lesen Sie die Dokumentation oder sprechen Sie mit einem Adobe-Berater.
-
Stellen Sie sicher, dass alle veralteten Methoden oder Elemente, die sich in Ihrem benutzerspezifischen Code für die DIL befinden, in die ECID-Methoden verschoben werden:
-
(DIL)
disableDestinationPublishingIframe-> (ECID)disableIdSyncs -
(DIL)
disableIDSyncs-> (ECID)disableIdSyncs -
(DIL)
iframeAkamaiHTTPS-> (ECID)idSyncSSLUseAkamai -
(DIL)
declaredId-> (ECID)setCustomerIDs
-