DokumentationAudience ManagerAudience Manager-Tutorials

Aktualisierung auf DIL-Version 8.0 von Adobe Audience Manager (oder höher) updating-to-adobe-audience-manager-s-dil-version-or-greater

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Fortgeschrittener
  • Entwickler

In diesem Artikel finden Sie Anweisungen und Empfehlungen zum Aktualisieren 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 und nicht auf die Server-seitige Weiterleitung von Adobe Analytics-Daten. DTM-, Launch by Adobe- und -Implementierungen ohne Adobe-Tag-Manager-Lösung werden abgedeckt.

Überblick overview

Mit dem Audience Manager-Data Integration Library (DIL) können Sie AAM auf Ihrer Website implementieren*. Bei der Implementierung früherer DIL-Versionen war es nicht erforderlich, auch den Experience Cloud-ID-Service (ECID) von Adobe zu implementieren (obwohl es 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 eine Fehlermeldung angezeigt und es funktioniert nicht. Da es mehrere Möglichkeiten gibt, AAM zu implementieren, haben wir diese Seite erstellt, um Ihnen einige Schritte sowie Empfehlungen zu geben. Nachfolgend finden Sie diese Schritte und Empfehlungen aufgeschlüsselt nach Plattform/Implementierungsmethode. Weitere Informationen zum DIL finden Sie in der Dokumentation.

  • Wie auf der Beschreibung dieser Seite angegeben, umfasst 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 Server-seitige Weiterleitungsmethode zum Implementieren von AAM verwenden. Diese Methode wird in der Dokumentation beschrieben.

Duplizierte und veraltete Elemente und Methoden duplicate-and-deprecated-elements-and-methods

In früheren Versionen von DIL und ECID gab es doppelte Methoden (Methoden, die sowohl in DIL als auch in ECID dieselbe Funktion erfüllen), was zu Verwirrung hinsichtlich der zu verwendenden führte. In der Regel mussten Sie beide verwenden und abgleichen, und diese Botschaft wurde unseren Kunden nicht gut vermittelt. Ab DIL 8.0 werden diese doppelten Methoden und Elemente in DIL nicht mehr unterstützt. Es wird empfohlen, die ECID-Version zu verwenden.

Beispiel:

  • Bei Verwendung von DIL.create werden einige Elemente nicht mehr unterstützt, stattdessen sollten Sie die ECID-Elemente verwenden. Diese Elemente werden in der (DokumentationDIL.create beschrieben.
  • Die Methode auf idSync-Instanzebene wird ebenfalls nicht mehr unterstützt, wie in der (Dokumentation der Methode.

ID mit einer Kunden-ID synchronisieren 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 über diesen Kunden hochladen und mit seinem Online-Verhalten verknüpfen können, um Ihre Kunden besser zu verstehen. In der Vergangenheit geschah dies auf eine von zwei Arten:

  • Die Methode auf Instanzebene idSync
  • Das declaredId Element in DIL.create

Wenn Sie eine dieser älteren Methoden zur Synchronisierung mit einer Kunden-ID verwendet haben, wird dringend empfohlen, auf die Verwendung der setCustomerIDs-Methode zu aktualisieren, die Teil des ECID-Service ist. Weitere Informationen zu setCustomerIDs finden Sie in der der Methode.

Schnelltipp: Sie zuvor eine der oben genannten Methoden verwendet haben, haben Sie auf den AAM-Data Source mit der Data Source-ID (auch „DPID“ genannt) verwiesen. Bei der Aktualisierung auf setCustomerIDs müssen Sie stattdessen das "Integration Code" des AAM-Data Source verwenden. Er verweist immer noch auf denselben Data Source, ist aber nur eine andere Kennung. Dies wird im folgenden Video gezeigt.

video poster

https://video.tv.adobe.com/v/33835/?quality=12&captions=ger

In den folgenden Abschnitten werden die Schritte und Empfehlungen für die Aktualisierung auf DIL 8.0 auf Grundlage Ihrer Implementierungsmethode aufgeführt:

Aktualisieren auf DIL 8.0 in Adobe Experience Platform-Tags updating-to-dil-in-experience-platform-launch

Grundlegende Schritte zum Aktualisieren auf DIL 8.0

  1. Wenn Sie DIL vor Version 8.0 verwenden, rufen Sie vor dem Upgrade die DIL-Konfiguration in der AAM-Erweiterung auf und notieren Sie sich alle erweiterten Optionen, die Sie verwenden (zur Verwendung in einem nachfolgenden Schritt).

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

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

  4. Aktivieren Sie für alle veralteten Methoden/Elemente (z. B. disableIDSyncs), die sich in Ihrer AAM-Erweiterung vor 8.0 oder in benutzerdefiniertem Code für das 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. Publish die Änderungen.

video poster

https://video.tv.adobe.com/v/33829/?quality=12&captions=ger

Aktualisieren auf DIL 8.0 in Adobe DTM updating-to-dil-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 veraltete Methoden/Elemente (z. B. disableIDSyncs) im benutzerdefinierten DIL-Code des AAM-Tools von vor 8.0 (damit Sie sie dem ECID-Tool hinzufügen können) und entfernen Sie sie dann aus dem benutzerdefinierten DIL code im AAM-Tool.
  3. Aktualisieren der Experience Cloud-ID-Diensterweiterung auf Version 3.3.0 oder höher
  4. Fügen Sie die erweiterten Optionen zum ECID-Tool hinzu, das Sie aus dem benutzerdefinierten Code des AAM-Tools entfernt haben.
  5. Publish - die Ä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 ältere Elemente einfach durch neuere Elemente ersetzen. Dies gilt nicht für Fälle, in denen Sie, wie oben beschrieben, 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/das alte Element am ECID-Speicherort.

Dasselbe gilt für Tag-Manager, die keine Adobe sind. Wenn Sie die alten Versionen in dieser Tag-Management-Lösung haben, ersetzen Sie sie 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 benötigen den neuesten DIL-Code von der Adobe Consulting- oder Adobe-Kundenunterstützung, da er derzeit nicht an einem öffentlichen Speicherort verfügbar ist. Ersetzen Sie dann einfach den alten DIL-Bibliothekscode durch den neuen DIL-Bibliothekscode und fahren Sie mit dem nächsten Schritt fort (hören Sie jetzt nicht auf 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-Service von unserer GitHub-Seite). Wenn Sie dabei Hilfe benötigen, lesen Sie die Dokumentation oder wenden Sie sich an einen Adobe-Berater.

  3. Stellen Sie sicher, dass veraltete Methoden oder Elemente, die sich im benutzerdefinierten DIL-Code 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

recommendation-more-help
468cbaa0-07ce-4354-9a38-4f23b645a466