Integrieren mit 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.

Vor der Integration müssen Sie die Dynamic Tag Management-Web-Eigenschaft erstellen, die für das Tracking der Domain Ihrer AEM-Site zuständig ist. 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 erfordern Änderungen an den Dynamic Tag Management-Bereitstellungstools sowie an Regeln keine Änderungen mehr an der Dynamic Tag Management-Konfiguration in AEM. Die Änderungen stehen AEM automatisch zur Verfügung.

HINWEIS

Wenn Sie DTM mit einer benutzerdefinierten Proxy-Konfiguration verwenden, müssen Sie beide HTTP-Client-Proxy-Konfigurationen vornehmen, da manche Funktionen von AEM 3.x-APIs verwenden und andere wiederum 4.x-APIs:

Bereitstellungsoptionen

Die folgenden Bereitstellungsoptionen beeinflussen die Konfiguration der Integration mit Dynamic Tag Management.

Hosting von Dynamic Tag Management

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

  • In der Cloud gehostet: Die JavaScript-Bibliotheken von Dynamic Tag Management werden in der Cloud gehostet und Ihre AEM-Seiten verweisen direkt auf sie.
  • In 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 Hostingoptionen finden Sie unter Hosting – Registerkarte „Einbetten“ in der Hilfe zu Dynamic Tag Management.

Staging- und Produktionsbibliothek

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 von Dynamic Tag Management und die Produktionsinstanz nutzt die Produktionsbibliotheken. Dieses Szenario ermöglicht Ihnen die Nutzung der Autoreninstanz, um nicht genehmigte Dynamic Tag Management-Konfigurationen 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 Dynamic Tag Management

Wenn AEM die Dynamic Tag Management-Bibliotheken hostet, können Sie den Bereitstellungs-Hook-Service verwenden, um Bibliotheksaktualisierungen automatisch auf AEM zu pushen. 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, die die Bibliotheken hostet. Sie müssen den Zugriff auf AEM für die Dynamic Tag Management-Server aktivieren.

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 gibt den Plan für Bibliotheksdownloads vor.

Aktivieren des Zugriffs auf den Bereitstellungs-Hook-Service

Aktivieren Sie den Bereitstellungs-Hook-Service für Dynamic Tag Management, um auf AEM zuzugreifen, damit der Service 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 Dynamic Tag Management-Konfiguration

Erstellen Sie eine Cloud-Konfiguration, sodass die AEM-Instanz sich mit Dynamic Tag Management authentifizieren und mit Ihrer Webeigenschaft interagieren kann.

HINWEIS

Vermeiden Sie die Integration von zwei Adobe Analytics-Trackingcodes auf Ihren Seiten, wenn Ihre DTM-Webeigenschaft das Adobe Analytics-Tool umfasst und Sie zudem den Inhaltseinblick verwenden. Wählen Sie in Ihrer Adobe Analytics-Cloud-Konfiguration die Option „Keinen Trackingcode aufnehmen“ aus.

Allgemeine Einstellungen

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

Die folgenden Eigenschaften der Dynamic Tag Management-Konfiguration ermöglichen AEM das Hosten von Dynamic 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 Dynamic Tag Management-Anwendung vorgenommene Änderung widerspiegeln.

Manche Eigenschaften verwenden Werte, die Sie im Abschnitt zum Herunterladen von Bibliotheken auf der Registerkarte „Eigenschaften“ der Dynamic Tag Management-Webeigenschaft abrufen können. Weitere Informationen finden Sie unter Herunterladen von Bibliotheken in der Hilfe zu Dynamic Tag Management.

HINWEIS

Wenn Sie das Dynamic Tag Management-Bundle in AEM hosten, muss das Herunterladen von Bibliotheken in Dynamic Tag Management aktiviert sein, bevor Sie die Konfiguration erstellen. Darüber hinaus muss Akamai aktiviert sein, da Akamai die herunterzuladenden Dateien bereitstellt.

Beim Hosten der Dynamic Tag Management-Bibliotheken in AEM konfiguriert AEM automatisch einige Eigenschaften der Webeigenschaft 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“ von Dynamic 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.

Beachten Sie, dass die Bibliotheken beim standardmäßigen Download-Workflow automatisch aktiviert werden, 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, um die Standard-Domain zu überschreiben, die für den Day CQ Link Externalizer-Service konfiguriert ist.

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, um die Standard-Domain zu überschreiben, die für den Day CQ Link Externalizer-Service konfiguriert ist.

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: Die OpenSSL-Bibliotheken müssen auf dem Computer installiert sein, auf dem auch AEM installiert ist, sodass 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 „Abruf-Import-Tool“, wenn der Bereitstellungs-Hook für Dynamic 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

Sie konfigurieren die folgenden Eigenschaften für Ihre Dynamic Tag Management-Konfiguration, wenn die Dynamic Tag-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 Dynamic Tag Management eingesetzt.

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

  2. Im Bereich „Dynamic Tag Management“ wird einer der folgenden Links für das Hinzufügen der 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 Dynamic Tag Management-Benutzerkontos ein.

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

    HINWEIS

    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 bei Dynamic Tag Management und ruft die Liste der Unternehmen ab, mit denen Ihr Konto verbunden ist.

  6. Wählen Sie das Unternehmen aus und wählen Sie dann die Eigenschaft aus, die Sie für das Tracking Ihrer AEM-Site verwenden.

  7. Wenn Sie den Staging-Code oder die Autoreninstanz verwenden, heben Sie die Auswahl „Produktionscode bei Autor mit angeben“ auf.

  8. Stellen Sie je nach Bedarf Werte für die Registerkarte „Staging-Einstellungen“ und die Registerkarte „Produktionseinstellungen“ bereit und klicken Sie dann auf „OK“.

Manuelles Herunterladen der Dynamic Tag Management-Bibliothek

Laden Sie die Dynamic Tag Management-Bibliotheken bei Bedarf manuell herunter, um sie unmittelbar auf AEM zu aktualisieren. Führen Sie zum Beispiel einen manuellen Download durch, wenn Sie eine aktualisierte Bibliothek testen möchten, bevor das Abruf-Importtool einen geplanten automatischen Download der Bibliothek durchführt.

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

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

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

    chlimage_1-356

HINWEIS

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 Dynamic Tag Management-Konfiguration mit Ihrer Website

Verknüpfen Sie Ihre Dynamic Tag Management-Konfiguration mit den Seiten Ihrer Website, sodass AEM den Seiten das erforderliche Skript hinzufügt. Verknüpfen Sie die Stammseite Ihrer Website mit der Konfiguration. Alle untergeordneten Elemente dieser Seite übernehmen die Verknüpfung. Bei Bedarf können Sie die Verknüpfung auf einer untergeordneten Seite außer Kraft setzen.

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 Website in der klassischen Benutzeroberfläche.

  2. Verwenden Sie den Sidekick, um die Seiteneigenschaften zu öffnen.

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

    chlimage_1-357

  4. Verwenden Sie das Dropdown-Menü „Dynamic Tag Management“, um Ihre Konfiguration auszuwählen, und klicken Sie dann auf „OK“.

Gehen Sie wie folgt vor, um die übernommene Konfigurationsverknüpfung für eine Seite außer Kraft zu setzen. Das Außerkraftsetzen betrifft die Seite und alle untergeordneten Elemente der Seite.

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

  2. Verwenden Sie den Sidekick, um die Seiteneigenschaften zu öffnen.

  3. Klicken Sie auf der Registerkarte „Cloud-Services“ auf das Schlosssymbol 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“.

Auf dieser Seite