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.
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 müssen Sie bei Änderungen an den Dynamic Tag Management-Bereitstellungswerkzeugen 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 Bereitstellungsoptionen wirken sich auf die Konfiguration der Integration mit Dynamic Tag Management aus.
Dynamic Tag Management Hosting dynamic-tag-management-hosting
AEM unterstützt Dynamic Tag Management, das in der Cloud gehostet oder auf 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 zum Abrufen und Installieren der Bibliotheken.
Der Hosting-Typ, den Ihre Implementierung verwendet, bestimmt einige der Konfigurations- und Implementierungsaufgaben, die Sie ausführen. Informationen zu den Hosting-Optionen finden Sie unter Hosting - Registerkarte "Einbetten" in der Hilfe zu Dynamic 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.
Normalerweise verwendet Ihre Autoreninstanz die Dynamic Tag Management-Staging-Bibliotheken und die Produktionsinstanz verwendet die Produktionsbibliotheken. Mit diesem Szenario können Sie die Autoreninstanz verwenden, 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 Dynamic Tag Management-Bereitstellungs-Hooks using-the-dynamic-tag-management-deployment-hook
Wenn AEM die Dynamic Tag Management-Bibliotheken hostet, können Sie den Bereitstellungs-Hook-Dienst für Dynamic Tag Management verwenden, um Bibliotheksaktualisierungen automatisch an 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 bestimmt den Zeitplan für Bibliotheksdownloads.
Zugriff für den Bereitstellungs-Hook-Dienst aktivieren enabling-access-for-the-deployment-hook-service
Aktivieren Sie den Bereitstellungs-Hook-Dienst für Dynamic Tag Management für den Zugriff auf AEM, damit der Dienst die 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 Dynamic Tag Management-Konfiguration creating-the-dynamic-tag-management-configuration
Erstellen Sie eine Cloud-Konfiguration, damit die AEM-Instanz sich mit Dynamic Tag Management authentifizieren und mit Ihrer Webeigenschaft interagieren kann.
Allgemeine Einstellungen general-settings
Self-Hosting-Eigenschaften - Staging und Produktion self-hosting-properties-staging-and-production
Die folgenden Eigenschaften der Dynamic Tag Management-Konfiguration ermöglichen es AEM, die Dynamic Tag Management-Bibliotheken zu hosten. Die Eigenschaften ermöglichen es AEM, die Bibliotheken herunterzuladen und zu installieren. Optional können Sie die Bibliotheken automatisch aktualisieren, um sicherzustellen, dass sie alle Änderungen widerspiegeln, die in der Dynamic Tag Management Management-Anwendung vorgenommen wurden.
Einige Eigenschaften verwenden Werte, die Sie im Abschnitt "Bibliotheksdownload"auf der Registerkarte "Einbettung"für Ihre Dynamic Tag Management-Webeigenschaft abrufen. Weitere Informationen finden Sie unter Bibliotheksdownload in der Hilfe zu Dynamic Tag Management.
Beim Hosten der Dynamic Tag Management-Bibliotheken auf AEM konfiguriert AEM automatisch einige Eigenschaften der Webeigenschaft entsprechend Ihrer Konfiguration. Siehe Beschreibungen in der folgenden Tabelle.
Cloud-Hosting-Eigenschaften - Staging und Produktion cloud-hosting-properties-staging-and-production
Sie konfigurieren die folgenden Eigenschaften für Ihre Dynamic Tag Management-Konfiguration, wenn die Dynamic Tag Configuration in der Cloud gehostet wird.
Im folgenden Verfahren wird die Touch-optimierte Benutzeroberfläche verwendet, um die Integration mit Dynamic Tag Management zu konfigurieren.
-
Klicken Sie auf der Leiste auf Tools > Vorgänge > Cloud > Cloud Services.
-
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.
-
Geben Sie einen Titel für die Konfiguration ein und klicken Sie auf Erstellen .
-
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.
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 bei Dynamic 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 "Produktionscode bei Autor 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 Dynamic Tag Management Library manually-downloading-the-dynamic-tag-management-library
Laden Sie die Dynamic Tag Management-Bibliotheken manuell herunter, um sie auf AEM sofort zu aktualisieren. Beispielsweise können Sie manuell herunterladen, wenn Sie eine aktualisierte Bibliothek testen möchten, bevor der Abruf-Importtool planmäßig automatisch die Bibliothek herunterladen soll.
-
Klicken Sie auf der Leiste auf Tools > Vorgänge > Cloud > Cloud Services.
-
Klicken Sie im Bereich "Dynamische Tag Management"auf Konfigurationen anzeigen und dann auf Ihre Konfiguration.
-
Klicken Sie im Bereich "Staging-Einstellungen"oder "Produktionseinstellungen"auf die Schaltfläche "Trigger-Workflow herunterladen", um das Bibliotheksbundle herunterzuladen und bereitzustellen.
/etc/clientlibs/dtm/my config/companyID/propertyID/servertype
gespeichert.myconfig
companyID
propertyID
servertype
Verknüpfen einer dynamischen Tag Management-Konfiguration mit Ihrer Site associating-a-dynamic-tag-management-configuration-with-your-site
Verknüpfen Sie Ihre Dynamic Tag Management-Konfiguration 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 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.
-
Öffnen Sie die Stammseite Ihrer Site in der klassischen Benutzeroberfläche.
-
Verwenden Sie den Sidekick, um die Seiteneigenschaften zu öffnen.
-
Klicken Sie auf der Registerkarte Cloud Services auf Dienst hinzufügen , wählen Sie Dynamic Tag Management und klicken Sie auf OK.
-
Wählen Sie Ihre Konfiguration mithilfe des Dropdown-Menüs Dynamische Tag Management aus und klicken Sie auf OK.
Gehen Sie wie folgt vor, um die geerbte Konfigurationsverknüpfung für eine Seite zu überschreiben. Das Außerkraftsetzen betrifft die Seite und alle untergeordneten Elemente der Seite.
-
Öffnen Sie die Seite in der klassischen Benutzeroberfläche.
-
Verwenden Sie den Sidekick, um die Seiteneigenschaften zu öffnen.
-
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“.