Aktualisierung auf Adobe Audience Manager-DIL-Version 8.0 (oder höher)

In diesem Artikel finden Sie Schritte und Empfehlungen zur Aktualisierung des Adobe Audience Manager (AAM) Data Integration Library (DIL)-Codes auf Version 8.0 oder höher. Dies bezieht sich auf die "Client-seitige"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

Mit dem Data Integration Library (DIL)-Code des Audience Managers können Sie AAM auf Ihrer Website implementieren*. Bei der Implementierung früherer Versionen von DIL war es nicht erforderlich, den Experience Cloud ID Service (ECID) von Adobe ebenfalls implementieren zu lassen (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 über 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

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 beschrieben.
  • Die idSync-Methode auf Instanzebene ist ebenfalls veraltet, wie in der Dokumentation der Methode beschrieben.

ID-Synchronisierung mit einer Kunden-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 idSync-Instanz-Level-Methode
  • 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 Data Source ID (AKA die "DPID") verwiesen. Bei der Aktualisierung auf setCustomerIDs müssen Sie stattdessen das "Integration Code"-AAM von Data Source verwenden. Er verweist immer noch auf denselben Data Source, ist aber 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 Launch

Grundlegende Schritte für die Aktualisierung auf DIL 8.0

  1. Wenn Sie DIL vor dem Upgrade von vor 8.0 verwenden, gehen Sie zur DIL-Konfiguration in der AAM-Erweiterung und beachten Sie alle erweiterten Optionen, die Sie verwenden (die in einem nachfolgenden Schritt verwendet werden sollen).

  2. Aktualisieren Sie Ihre AAM-Erweiterung auf Version 8.0 oder höher.

  3. Stellen Sie sicher, dass die Experience Cloud ID Service-Erweiterung Version 3.3.0 oder höher ist.

  4. Aktivieren Sie für alle veralteten Methoden/Elemente (wie "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.

    1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs
    2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs
    3. (DIL) iframeAkamaiHTTPS -> (ECID) dSyncSSLUseAkamai
    4. (DIL) declaredId -> (ECID) setCustomerIDs
  5. Veröffentlichen der Änderungen

Aktualisierung auf DIL 8.0 in Adobe DTM

  1. Aktualisieren Sie Ihr AAM-Tool auf Version 8.0 oder höher. Diese Versionseinstellung befindet sich im Abschnitt "Allgemein"des AAM Tools.
  2. Notieren Sie sich für alle veralteten Methoden/Elemente (wie "disableIDSyncs"), die sich im benutzerdefinierten Code des vor 8.0 AAM Tools für das DIL befanden (sodass Sie sie zum ECID-Tool hinzufügen können), und entfernen Sie sie dann aus dem benutzerdefinierten DIL code im AAM Tool.
  3. Aktualisieren Sie Ihre Experience Cloud ID Service-Erweiterung auf Version 3.3.0 oder höher.
  4. Fügen Sie dem ECID-Tool die erweiterten Optionen hinzu, die Sie aus dem benutzerdefinierten Code des AAM Tools entfernt haben.
  5. Veröffentlichen der Änderungen

Aktualisierung auf DIL 8.0 ohne Adobe Tag Management Solution

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 Tag-Manager ohne Adobe. Ersetzen Sie die alten Versionen in dieser Tag-Management-Lösung durch den neuen Code, wie in den folgenden Schritten beschrieben.

  1. Aktualisieren Sie Ihre DIL-Bibliothek auf die neueste Version (8.0 oder höher) - Sie müssen den neuesten DIL-Code von Adobe Consulting oder der 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).

  2. 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 Consultant.

  3. 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:

    1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs

      Dokumentation

    2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs

      Dokumentation

    3. (DIL) iframeAkamaiHTTPS -> (ECID) idSyncSSLUseAkamai

      Dokumentation

    4. (DIL) declaredId -> (ECID) setCustomerIDs

      Dokumentation

Auf dieser Seite