Show Menu
THEMEN×

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- Webeigenschaft erstellen, die für das Tracking der Domäne Ihrer AEM-Site zuständig ist. The hosting options of the web property must be configured so that you can configure AEM to access the Dynamic Tag Management libraries.
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.
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 Produktionscode 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. Bibliotheksaktualisierungen werden gesendet, wenn Änderungen an den Bibliotheken vorgenommen werden, z. B. wenn die Webeigenschaftseigenschaften des dynamischen Tag-Managements bearbeitet werden.
Um den Bereitstellungs-Hook zu verwenden, muss Dynamic Tag Management eine Verbindung zur AEM-Instanz herstellen können, die die Bibliotheken hostet. You must enable access to AEM for the Dynamic Tag Management servers.
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-Importtool 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 Server des dynamischen Tag-Managements an, die die Staging- und Produktionsbibliotheken nach Bedarf aktualisieren:
  • Staging: 107.21.99.31
  • Production: 23.23.225.112 and 204.236.240.48
Führen Sie die Konfiguration entweder mit der Web-Konsole oder einem sling:OsgiConfig -Knoten durch:
  • Verwenden Sie auf der Seite "Konfiguration"die Option "Adobe DTM-Konfiguration für die Hook-Bereitstellung".
  • 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.
Webkonsole, Eigenschaft
OSGi-Eigenschaft
Beschreibung
Staging der DTM IP-White-List
dtm.staging.ip.whitelist
Die IP-Adresse des Servers für dynamisches Tag-Management, der die Staging-Bibliotheken aktualisiert.
Produktions-DTM-IP-White-List
dtm.production.ip.whitelist
Die IP-Adresse des Servers für dynamisches Tag-Management, auf dem die Produktionsbibliotheken aktualisiert werden.

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.
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. In your Adobe Analytics cloud configuration , select the Do Not Include Tracking Code option.

Allgemeine Einstellungen

Eigenschaft Beschreibung
API-Token Der Wert der API-Token-Eigenschaft Ihres dynamischen 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-Site erstellt haben.
Produktionscode bei Autor mit angeben
Wählen Sie diese Option, damit die Autoren- und Veröffentlichungsinstanzen von AEM die Produktionsversion der dynamischen 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.
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, wenn Sie die Bibliotheksdatei des dynamischen Tag-Managements in 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 Bibliothek des dynamischen Tag-Managements verwendet wird. 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 Bibliothek für das dynamische Tag-Management verwendet wird. 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.
Domänen-Hinweis
(Optional) Die Domäne des AEM-Servers, auf dem die Bibliothek des dynamischen Tag-Managements gehostet wird. Geben Sie einen Wert an, um die Standarddomäne zu überschreiben, die für den Day CQ Link Externalizer-Dienst 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-Webeigenschaft.
Hinweis für sichere Domäne
(Optional) Die Domäne des AEM-Servers, auf dem die Bibliothek des dynamischen Tag-Managements über HTTPS gehostet wird. Geben Sie einen Wert an, um die Standarddomäne zu überschreiben, die für den Day CQ Link Externalizer-Dienst 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-Webeigenschaft.
Gemeinsamer geheimer Schlüssel
(Optional) Das Shared-Secret, das zum Entschlüsseln des Downloads verwendet wird. Rufen Sie diesen Wert im Feld "Shared Secret"auf der Seite "Bibliotheksdownload"des dynamischen Tag-Managements 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-Importtool aktivieren
(Optional) Wählen Sie diese Option, um die Bibliothek des dynamischen Tag-Managements regelmäßig herunterzuladen und zu installieren, um sicherzustellen, dass Sie eine aktualisierte Version verwenden. Wenn diese Option aktiviert ist, sendet das dynamische Tag-Management keine HTTP-POST-Anfragen an die Bereitstellungs-Hook-URL.
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. Wenn diese Option nicht ausgewählt ist, wird die Eigenschaft mit der URL Ihrer Konfiguration des dynamischen Tag-Managements konfiguriert.
Aktivieren Sie „Abruf-Importtool“, 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-Importer aktivieren"ausgewählt ist.) Ein Cron-Ausdruck, der steuert, wann die Dynamic Tag Management-Bibliotheken heruntergeladen werden.

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 Bibliotheksdatei des dynamischen Tag-Managements in der Cloud gehostet wird.
Kopfzeilencode
Der Kopfzeilencode für die Staging-Funktion, der vom dynamischen 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 „Kopfzeilencode“ und klicken Sie im Bereich „Einbettungscode für das Staging“ oder „Einbettungscode für die Produktion“ auf „Einbettungscode kopieren“.
Fußzeilencode
Der Fußzeilencode für Staging, der vom dynamischen 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ßzeilencode“ und klicken Sie im Bereich „Einbettungscode für das Staging“ oder „Einbettungscode für die Produktion“ auf „Einbettungscode kopieren“.
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.
  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.
    Um den Wert Ihres API-Tokens abzurufen, wenden Sie sich an den DTM-Kundendienst.
    Der API-Token läuft erst ab, wenn der Dynamic Tag Management-Benutzer dies explizit anfordert.
  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.
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 Zuordnung. Bei Bedarf können Sie die Zuordnung auf einer untergeordneten Seite überschreiben.
Verwenden Sie das folgende Verfahren, um eine Seite und die untergeordneten Elemente einer Konfiguration des dynamischen Tag-Managements zuzuordnen.
  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“.
  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. Die Außerkraftsetzung 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“.
  4. Entfernen oder wählen Sie eine Dynamic Tag Management-Konfiguration und klicken Sie dann auf „OK“.