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-Web-Eigenschaft, 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 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.
- 3.x wird mit http://localhost:4502/system/console/configMgr/com.day.commons.httpclient konfiguriert.
- 4.x wird mit http://localhost:4502/system/console/configMgr/org.apache.http.proxyconfigurator konfiguriert.
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.
- In der Cloud gehostet: Die JavaScript-Bibliotheken des dynamischen Tag-Managements werden in der Cloud gespeichert und Ihre AEM-Seiten verweisen direkt auf sie.
- In AEM gehostet: Das dynamische 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 das dynamische Tag-Management eine Verbindung zur AEM-Instanz herstellen können, die die Bibliotheken hostet. 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
und204.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.
dtm.staging.ip.whitelist
dtm.production.ip.whitelist
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.
Allgemeine Einstellungen general-settings
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.
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.
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.
Bei der folgenden Vorgehensweise wird die Touch-optimierte Benutzeroberfläche für die Konfiguration der Integration in das dynamische Tag-Management eingesetzt.
-
Klicken Sie in der Leiste auf „Tools“ > „Vorgänge“ > „Cloud“ > „Cloud-Services“.
-
Im Bereich „Dynamisches Tag-Management“ wird einer der folgenden Links für das 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.
-
Geben Sie einen Titel für die Konfiguration ein und klicken Sie dann auf „Erstellen“.
-
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. -
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.
-
Wählen Sie das Unternehmen aus und wählen Sie dann die Eigenschaft aus, mit der Sie Ihre AEM-Site verfolgen.
-
Wenn Sie Staging-Code in der Autoreninstanz verwenden, deaktivieren Sie die Option „Produktions-Code auf der Autoreninstanz einschließen“.
-
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.
-
Klicken Sie in der Leiste auf „Tools“ > „Vorgänge“ > „Cloud“ > „Cloud-Services“.
-
Klicken Sie im Bereich „Dynamisches Tag-Management“ auf „Konfigurationen anzeigen“ und dann auf Ihre Konfiguration.
-
Klicken Sie im Bereich „Staging-Einstellungen“ oder „Produktionseinstellungen“ auf die Schaltfläche „Download-Workflow auslösen“, um das Bibliotheks-Bundle herunterzuladen und bereitzustellen.
/etc/clientlibs/dtm/my config/companyID/propertyID/servertype
gespeichert.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.
-
Öffnen Sie die Stammseite Ihrer Site in der klassischen Benutzeroberfläche.
-
Öffnen Sie die Seiteneigenschaften mithilfe von Sidekick.
-
Klicken Sie auf der Registerkarte „Cloud-Services“ auf „Dienst hinzufügen“, wählen Sie „Dynamisches Tag-Management“ und klicken Sie auf „OK“.
-
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.
-
Öffnen Sie die Seite in der klassischen Benutzeroberfläche.
-
Öffnen Sie die Seiteneigenschaften mithilfe von Sidekick.
-
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“.
-
Entfernen oder wählen Sie eine Dynamic Tag Management-Konfiguration und klicken Sie dann auf „OK“.