Integrieren mit Adobe Dynamic Tag Management integrating-with-adobe-dynamic-tag-management

Integrieren Sie Adobe Dynamic Tag Management mit AEM, sodass Sie Ihre Dynamic Tag Management-Webeigenschaften für das Tracking von AEM Sites verwenden können. Dynamic Tag Management ermöglicht Marketingexperten die Verwaltung von Tags für die Datensammlung und die Verteilung von Daten auf Systeme für Digital Marketing. Verwenden Sie Dynamic Tag Management zum Beispiel für die Erfassung der Nutzungsdaten zu Ihrer AEM-Website und die Verteilung der Daten für die Analyse in Adobe Analytics oder Adobe Target.

Erstellen Sie vor der Integration die Dynamic Tag Management Webeigenschaft , der die Domäne Ihrer AEM verfolgt. Die Hostingoptionen der Webeigenschaft müssen so konfiguriert werden, dass Sie AEM für den Zugriff auf die Dynamic Tag Management-Bibliotheken konfigurieren können.

Nach der Konfiguration der Integration müssen Sie bei Änderungen an den Dynamic Tag Management-Implementierungswerkzeugen und -regeln die Dynamic Tag Management-Konfiguration in AEM nicht ändern. Die Änderungen stehen AEM automatisch zur Verfügung.

NOTE
Wenn Sie DTM mit einer benutzerdefinierten Proxy-Konfiguration verwenden, konfigurieren Sie beide HTTP-Client-Proxy-Konfigurationen, da einige Funktionen von AEM die 3.x-APIs und andere die 4.x-APIs verwenden:

Implementierungsoptionen deployment-options

Die folgenden Implementierungsoptionen wirken sich auf die Konfiguration der Integration mit dem dynamischen Tag-Management aus.

Hosting des dynamischen Tag-Managements dynamic-tag-management-hosting

AEM unterstützt dynamisches Tag-Management, das in der Cloud oder in AEM gehostet wird.

  • Cloud-gehostet: Die Dynamic Tag Management JavaScript-Bibliotheken werden in der Cloud gespeichert und Ihre AEM verweisen direkt auf sie.
  • AEM gehostet: Dynamic Tag Management generiert JavaScript-Bibliotheken. AEM verwendet ein Workflow-Modell, um die Bibliotheken abzurufen und zu installieren.

Die von Ihrer Implementierung verwendete Art des Hostings bestimmt einige der von Ihnen durchgeführten Konfigurations- und Implementierungsaufgaben. Weitere Informationen zu den Hosting-Optionen finden Sie unter Hosting – Registerkarte „Einbetten“ in der Hilfe zum dynamischen Tag-Management.

Staging- und Produktionsbibliothek staging-and-production-library

Entscheiden Sie, ob Ihre AEM-Autoreninstanz den Staging- oder Produktions-Code von Dynamic Tag Management verwenden soll.

In der Regel nutzt Ihre Autoreninstanz die Staging-Bibliotheken des dynamischen Tag-Managements, und die Produktionsinstanz nutzt die Produktionsbibliotheken. Dieses Szenario ermöglicht Ihnen die Nutzung der Autoreninstanz, um nicht genehmigte Konfigurationen des dynamischen Tag-Managements zu testen.

Bei Bedarf kann Ihre Autoreninstanz die Produktionsbibliotheken nutzen. Es sind Webbrowser-Plug-ins verfügbar, die Ihnen den Wechsel zwischen der Verwendung der Staging-Bibliotheken zu Testzwecken ermöglichen, wenn die Bibliotheken in der Cloud gehostet werden.

Verwenden des Bereitstellungs-Hooks für das dynamische Tag-Management using-the-dynamic-tag-management-deployment-hook

Wenn AEM die Bibliotheken für das dynamische Tag-Management hostet, können Sie den Bereitstellungs-Hook-Dienst für das dynamische Tag-Management verwenden, um Bibliotheksaktualisierungen automatisch an AEM zu übertragen. Das Pushen von Bibliothekaktualisierungen erfolgt, wenn Änderungen an den Bibliotheken vorgenommen werden – so zum Beispiel, wenn die Dynamic Tag Management-Webeigenschaften bearbeitet werden.

Um den Bereitstellungs-Hook zu verwenden, muss Dynamic Tag Management eine Verbindung zur AEM-Instanz herstellen können, in der die Bibliotheken gehostet werden. Aktivieren Sie den Zugriff auf AEM für die Server des dynamischen Tag-Managements.

Unter manchen Umständen kann AEM nicht erreichbar sein, so zum Beispiel, wenn AEM sich hinter einer Firewall befindet. In diesen Fällen können Sie die Option Abruf-Import-Tool von AEM verwenden, um die Bibliotheken regelmäßig abzurufen. Ein Cron-Auftragsausdruck bestimmt den Zeitplan für Bibliotheks-Downloads.

Aktivieren des Zugriffs auf den Bereitstellungs-Hook-Dienst enabling-access-for-the-deployment-hook-service

Aktivieren Sie den Bereitstellungs-Hook-Dienst für das dynamische Tag-Management für den Zugriff auf AEM, damit der Dienst die in AEM gehosteten Bibliotheken aktualisieren kann. Geben Sie die IP-Adresse der Dynamic Tag Management-Server an, die die Staging- und Produktionsbibliotheken nach Bedarf aktualisieren:

  • Staging: 107.21.99.31
  • Produktion: 23.23.225.112 und 204.236.240.48

Führen Sie die Konfiguration entweder mit der Web-Konsole oder einem sling:OsgiConfig-Knoten durch:

  • Verwenden Sie in der Web-Konsole das Element zur Konfiguration mit dem Bereitstellungs-Hook für Adobe DTM, das Sie auf der Seite „Konfiguration“ finden.
  • Für eine OSGi-Konfiguration lautet die PID des Dienstes com.adobe.cq.dtm.impl.servlets.DTMDeployHookServlet.

In der folgenden Tabelle sind die zu konfigurierenden Eigenschaften beschrieben.

Eigenschaft in der Web-Konsole
OSGi-Eigenschaft
Beschreibung
Staging-DTM-IP-Zulassungsliste
dtm.staging.ip.whitelist
Die IP-Adresse des Dynamic Tag Management-Servers, der die Staging-Bibliotheken aktualisiert.
IP-Zulassungsliste für Produktions-DTM
dtm.production.ip.whitelist
Die IP-Adresse des Dynamic Tag Management-Servers, der die Produktionsbibliotheken aktualisiert.

Erstellen der Konfiguration des dynamischen Tag-Managements creating-the-dynamic-tag-management-configuration

Erstellen Sie eine Cloud-Konfiguration, sodass sich die AEM-Instanz mit dem dynamischen Tag-Management authentifizieren und mit Ihrer Web-Eigenschaft interagieren kann.

NOTE
Vermeiden Sie die Integration von zwei Adobe Analytics-Trackingcodes auf Ihren Seiten, wenn Ihre DTM-Web-Eigenschaft das Adobe Analytics-Tool umfasst und Sie zudem den Inhaltseinblick verwenden. In der Adobe Analytics Cloud-Konfigurationwählen Sie die Option "Rückverfolgungscode nicht einschließen".

Allgemeine Einstellungen general-settings

Eigenschaft
Beschreibung
API-Token
Der -Wert der API-Token-Eigenschaft Ihres Dynamic Tag Management-Benutzerkontos. AEM verwendet diese Eigenschaft für die Authentifizierung mit Dynamic Tag Management.
Unternehmen
Das Unternehmen, mit dem Ihre Anmelde-ID verknüpft ist.
Eigenschaft
Der Name der Webeigenschaft, die Sie zum Verwalten der Tags für Ihre AEM-Website erstellt haben.
Produktions-Code bei Autor mit angeben

Wählen Sie diese Option aus, damit die AEM Autoren- und Veröffentlichungsinstanzen die Produktionsversion der Dynamic Tag Management-Bibliotheken verwenden.

Wird diese Option nicht ausgewählt, werden die Staging-Einstellungen auf die Autoreninstanz angewandt und die Produktionseinstellungen auf die Veröffentlichungsinstanz.

Self-Hosting-Eigenschaften – Staging und Produktion self-hosting-properties-staging-and-production

Die folgenden Eigenschaften der Konfiguration des dynamischen Tag-Managements ermöglichen AEM das Hosten von dynamischen Tag-Management-Bibliotheken. Die Eigenschaften ermöglichen AEM das Herunterladen und Installieren der Bibliotheken. Optional können Sie die Bibliotheken automatisch aktualisieren, um sicherzustellen, dass sie jede an der Anwendung zur Verwaltung des dynamischen Tag-Managements vorgenommene Änderung widerspiegeln.

Manche Eigenschaften verwenden Werte, die Sie im Abschnitt zum Herunterladen von Bibliotheken auf der Registerkarte „Einbetten“ der Web-Eigenschaft des dynamischen Tag-Managements abrufen können. Weitere Informationen finden Sie unter Herunterladen von Bibliotheken in der Hilfe zum dynamischen Tag-Management.

NOTE
Wenn Sie das dynamische Tag-Management-Paket in AEM hosten, muss das Herunterladen von Bibliotheken im dynamischen Tag Management aktiviert sein, bevor Sie die Konfiguration erstellen. Darüber hinaus muss Akamai aktiviert sein, da Akamai die herunterzuladenden Bibliotheken bereitstellt.

Beim Hosten der dynamischen Tag-Management-Bibliotheken in AEM konfiguriert AEM automatisch einige Eigenschaften der Web-Eigenschaft gemäß Ihrer Konfiguration. In der folgenden Tabelle finden Sie die Beschreibungen hierzu.

Eigenschaft
Beschreibung
Self-Hosting verwenden
Wählen Sie diese Option aus, wenn Sie die Dynamic Tag Management-Bibliotheksdatei auf AEM hosten. Die Auswahl dieser Option sorgt dafür, dass die anderen Eigenschaften in dieser Tabelle angezeigt werden.
URL des DTM-Bundles
Die URL, die zum Herunterladen der Dynamic Tag Management-Bibliothek verwendet werden soll. Rufen Sie diesen Wert im Abschnitt zu den Download-URLs der Seite „Herunterladen von Bibliotheken“ vom dynamischen Tag-Management ab. Aus Sicherheitsgründen muss dieser Wert manuell konfiguriert werden.
Download-Workflow

Das Workflow-Modell, das zum Herunterladen und Installieren der Dynamic Tag Management-Bibliothek verwendet werden soll. Das Standardmodell ist „Standard-DTM-Bundle-Download“. Verwenden Sie dieses Modell, sofern Sie kein benutzerdefiniertes Modell erstellt haben.

Die Bibliotheken werden beim standardmäßigen Download-Workflow automatisch aktiviert, wenn sie heruntergeladen werden.

Domain-Hinweis

(Optional) Die Domain des AEM-Servers, auf dem die Dynamic Tag Management-Bibliothek gehostet wird. Geben Sie einen Wert an, damit Sie die Standarddomäne, die für die Day CQ Link Externalizer-Dienst.

Wenn AEM mit Dynamic Tag Management verbunden ist, nutzt es diesen Wert zum Konfigurieren des Staging-HTTP-Pfads oder des Produktions-HTTP-Pfads der Eigenschaften zum Herunterladen von Bibliotheken der Dynamic Tag Management-Web-Eigenschaft.

Hinweis für sichere Domain

(Optional) Die Domain des AEM-Servers, der die Dynamic Tag Management-Bibliothek über HTTPS hostet. Geben Sie einen Wert an, damit Sie die Standarddomäne, die für die Day CQ Link Externalizer-Dienst.

Wenn AEM mit Dynamic Tag Management verbunden ist, nutzt es diesen Wert zum Konfigurieren des Staging-HTTPS-Pfads oder des Produktions-HTTPS-Pfads der Eigenschaften zum Herunterladen von Bibliotheken der Dynamic Tag Management-Web-Eigenschaft.

Gemeinsamer geheimer Schlüssel

(Optional) Das gemeinsam genutzte Geheimnis, das zum Entschlüsseln des Downloads verwendet werden soll. Rufen Sie diesen Wert im Feld „Gemeinsames Geheimnis“ auf der Seite „Herunterladen von Bibliotheken“ von Dynamic Tag Management ab.

Hinweis: Sie müssen die OpenSSL-Bibliotheken auf dem Computer installiert haben, auf dem AEM installiert ist, damit AEM die heruntergeladenen Bibliotheken entschlüsseln kann.

Abruf-Import-Tool aktivieren

(Optional) Wählen Sie diese Option, um die Dynamic Tag Management-Bibliothek regelmäßig herunterzuladen und zu installieren, um sicherzustellen, dass Sie eine aktualisierte Version verwenden. Ist dies ausgewählt, sendet Dynamic Tag Management keine HTTP-POST-Anfragen an die URL des Bereitstellungs-Hooks.

AEM konfiguriert automatisch die Bereitstellungs-Hook-URL-Eigenschaft der Eigenschaften zum Herunterladen von Bibliotheken für die Dynamic Tag Management-Webeigenschaft. Ist dies ausgewählt, wird die Eigenschaft ohne Wert konfiguriert. Ist dies nicht ausgewählt, wird die Eigenschaft mit der URL der Dynamic Tag Management-Konfiguration konfiguriert.

Aktivieren Sie das Abruf-Import-Tool, wenn der Bereitstellungs-Hook für das dynamische Tag-Management keine Verbindung zu AEM herstellen kann – zum Beispiel, wenn AEM sich hinter einer Firewall befindet.

Wert für Terminplan
(Wird angezeigt und ist erforderlich, wenn „Abruf-Import-Tool aktivieren“ ausgewählt ist.) Ein Cron-Ausdruck, der steuert, wann die Dynamic Tag Management-Bibliotheken heruntergeladen werden.

chlimage_1-352

Cloud-Hosting-Eigenschaften – Staging und Produktion cloud-hosting-properties-staging-and-production

Sie konfigurieren die folgenden Eigenschaften für Ihre Konfiguration des dynamischen Tag-Managements, wenn diese Konfiguration in der Cloud gehostet wird.

Eigenschaft
Beschreibung
Self-Hosting verwenden
Deaktivieren Sie diese Option, wenn die Dynamic Tag Management-Bibliotheksdatei in der Cloud gehostet wird.
Kopfzeilen-Code

Der Kopfzeilen-Code für das Staging, der von Dynamic Tag Management für Ihren Host abgerufen wird. Dieser Wert wird automatisch aufgefüllt, wenn Sie eine Verbindung zu Dynamic Tag Management herstellen.

Um den Code in Dynamic Tag Management anzuzeigen, klicken Sie auf die Registerkarte „Einbetten“ und klicken Sie dann auf den Hostnamen. Erweitern Sie den Abschnitt „Kopfzeilen-Code“ und klicken Sie im Bereich „Einbettungs-Code für das Staging“ oder „Einbettungs-Code für die Produktion“ auf „Einbettungs-Code kopieren“.

Fußzeilen-Code

Der Fußzeilen-Code für das Staging, der von Dynamic Tag Management für Ihren Host abgerufen wird. Dieser Wert wird automatisch aufgefüllt, wenn Sie eine Verbindung zu Dynamic Tag Management herstellen.

Um den Code in Dynamic Tag Management anzuzeigen, klicken Sie auf die Registerkarte „Einbetten“ und klicken Sie dann auf den Hostnamen. Erweitern Sie den Abschnitt „Fußzeilen-Code“ und klicken Sie im Bereich „Einbettungs-Code für das Staging“ oder „Einbettungs-Code für die Produktion“ auf „Einbettungs-Code kopieren“.

chlimage_1-353

Bei der folgenden Vorgehensweise wird die Touch-optimierte Benutzeroberfläche für die Konfiguration der Integration in das dynamische Tag-Management eingesetzt.

  1. Klicken Sie in der Leiste auf „Tools“ > „Vorgänge“ > „Cloud“ > „Cloud-Services“.

  2. Im Bereich "Dynamischer Tag Management"wird einer der folgenden Links zum Hinzufügen einer Konfiguration angezeigt:

    • Klicken Sie auf „Jetzt konfigurieren“, wenn dies die erste Konfiguration ist, die Sie hinzufügen.
    • Klicken Sie auf „Konfigurationen anzeigen“ und anschließend auf den „+“-Link neben „Verfügbare Konfigurationen“, wenn eine oder mehrere Konfigurationen erstellt wurden.

    chlimage_1-354

  3. Geben Sie einen Titel für die Konfiguration ein und klicken Sie dann auf „Erstellen“.

  4. Geben Sie im Feld „API-Token“ den Wert der Eigenschaft „API-Token“ Ihres Benutzerkontos für das dynamische Tag-Management ein.

    Wenden Sie sich an DTM-Kunden-Support, um den Wert Ihres API-Tokens abzurufen.

    note note
    NOTE
    Der API-Token läuft erst ab, wenn der Dynamic Tag Management-Benutzer dies explizit anfordert.

    chlimage_1-355

  5. Klicken Sie auf „Mit DTM verbinden“. AEM authentifiziert sich beim dynamischem Tag-Management und ruft die Liste der Unternehmen ab, mit denen Ihr Konto verknüpft ist.

  6. Wählen Sie das Unternehmen aus und wählen Sie dann die Eigenschaft aus, mit der Sie Ihre AEM-Site verfolgen.

  7. Wenn Sie Staging-Code in der Autoreninstanz verwenden, deaktivieren Sie die Option „Produktions-Code auf der Autoreninstanz einschließen“.

  8. Geben Sie bei Bedarf Werte für die Eigenschaften auf der Registerkarte „Staging-Einstellungen“ und auf der Registerkarte „Produktionseinstellungen“ an und klicken Sie dann auf „OK“.

Manuelles Herunterladen der Bibliothek für das dynamische Tag-Management manually-downloading-the-dynamic-tag-management-library

Laden Sie die Bibliotheken für das dynamische Tag-Management manuell herunter, um sie auf AEM sofort zu aktualisieren. Beispielsweise können Sie sie manuell herunterladen, wenn Sie eine aktualisierte Bibliothek testen möchten, bevor das Abruf-Import-Tool planmäßig die Bibliothek automatisch herunterladen soll.

  1. Klicken Sie in der Leiste auf „Tools“ > „Vorgänge“ > „Cloud“ > „Cloud-Services“.

  2. Klicken Sie im Bereich „Dynamisches Tag-Management“ auf „Konfigurationen anzeigen“ und dann auf Ihre Konfiguration.

  3. Klicken Sie im Bereich „Staging-Einstellungen“ oder „Produktionseinstellungen“ auf die Schaltfläche „Download-Workflow auslösen“, um das Bibliotheks-Bundle herunterzuladen und bereitzustellen.

    chlimage_1-356

NOTE
Die heruntergeladenen Dateien werden unter /etc/clientlibs/dtm/my config/companyID/propertyID/servertype gespeichert.
Folgendes wird direkt Ihrer DTM-Konfiguration entnommen:
  • myconfig
  • companyID
  • propertyID
  • servertype

Verknüpfen einer Konfiguration des dynamischen Tag-Managements mit Ihrer Site associating-a-dynamic-tag-management-configuration-with-your-site

Verknüpfen Sie Ihre Konfiguration des dynamischen Tag-Managements mit den Seiten Ihrer Website, damit AEM das erforderliche Skript zu den Seiten hinzufügt. Verknüpfen Sie die Stammseite Ihrer Site mit der Konfiguration. Alle untergeordneten Elemente dieser Seite übernehmen die Verknüpfung. Bei Bedarf können Sie die Verknüpfung auf einer untergeordneten Seite überschreiben.

Gehen Sie wie folgt vor, um eine Seite und die untergeordneten Elemente mit einer Dynamic Tag Management-Konfiguration zu verknüpfen.

  1. Öffnen Sie die Stammseite Ihrer Site in der klassischen Benutzeroberfläche.

  2. Öffnen Sie die Seiteneigenschaften mithilfe von Sidekick.

  3. Klicken Sie auf der Registerkarte „Cloud-Services“ auf „Dienst hinzufügen“, wählen Sie „Dynamisches Tag-Management“ und klicken Sie auf „OK“.

    chlimage_1-357

  4. Wählen Sie Ihre Konfiguration mithilfe des Dropdown-Menüs „Dynamisches Tag-Management“ aus und klicken Sie auf „OK“.

Gehen Sie wie folgt vor, um die übernommene Konfigurationszuordnung für eine Seite zu überschreiben. Das Überschreiben betrifft die Seite und alle untergeordneten Elemente der Seite.

  1. Öffnen Sie die Seite in der klassischen Benutzeroberfläche.

  2. Öffnen Sie die Seiteneigenschaften mithilfe von Sidekick.

  3. Klicken Sie auf der Registerkarte „Cloud-Services“ auf das Vorhängeschloss-Symbol neben der Eigenschaft „Vererbt von“ und klicken Sie dann im Bestätigungsdialogfeld auf „Ja“.

    chlimage_1-358

  4. Entfernen oder wählen Sie eine Dynamic Tag Management-Konfiguration und klicken Sie dann auf „OK“.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2