Intégration à Adobe Dynamic Tag Management integrating-with-adobe-dynamic-tag-management
Intégrez la gestion dynamique des balises Adobe à AEM afin de pouvoir utiliser vos propriétés web de gestion dynamique des balises pour effectuer le suivi des sites AEM. La gestion dynamique des balises permet aux spécialistes du marketing de gérer les balises pour collecter des données et distribuer des données sur les systèmes de marketing numérique. Par exemple, utilisez la gestion dynamique des balises afin de collecter les données d’utilisation de votre site Web AEM et de distribuer les données à analyser dans Adobe Analytics ou Adobe Target.
Avant de procéder à l’intégration, créez la propriété web de gestion dynamique des balises qui suit le domaine de votre site AEM. Les options d’hébergement de la propriété Web doivent être configurées de façon à ce que vous puissiez configurer AEM pour accéder aux bibliothèques de gestion dynamique des balises.
Une fois que vous avez configuré l’intégration, les modifications apportées aux outils et aux règles de déploiement de gestion dynamique des balises ne nécessitent pas de modifier la configuration de gestion dynamique des balises dans AEM. Les modifications sont automatiquement disponibles pour AEM.
- La version 3.x est configurée avec http://localhost:4502/system/console/configMgr/com.day.commons.httpclient.
- Les API 4.x sont configurées avec http://localhost:4502/system/console/configMgr/org.apache.http.proxyconfigurator.
Options de déploiement deployment-options
Les options de déploiement suivantes ont une incidence sur la configuration de l’intégration à la gestion dynamique des balises.
Hébergement de la gestion dynamique des balises dynamic-tag-management-hosting
AEM prend en charge la gestion dynamique des balises hébergée dans le cloud ou sur AEM.
- Hébergement dans le cloud : les bibliothèques de gestion dynamique des balises JavaScript sont stockées dans le cloud et vos pages AEM y font directement référence.
- Hébergement dans AEM : la gestion dynamique des balises génère des bibliothèques JavaScript. AEM utilise un modèle de workflow pour obtenir les bibliothèques et les installer.
Le type d’hébergement utilisé par votre implémentation détermine certaines des tâches de configuration et d’implémentation que vous effectuez. Pour plus d’informations sur les options d’hébergement, voir Hébergement : onglet Incorporer dans l’aide de la gestion dynamique des balises.
Bibliothèque d’évaluation et de production staging-and-production-library
Déterminez si votre instance de création AEM utilise le code d’évaluation ou de production de la gestion dynamique des balises.
En général, votre instance de création utilise les bibliothèques intermédiaires de gestion dynamique des balises tandis que l’instance de production utilise les bibliothèques de production. Ce scénario vous permet d’utiliser l’instance de création pour tester les configurations de la gestion dynamique des balises non approuvées.
Si vous le souhaitez, votre instance de création peut utiliser les bibliothèques de production. Des modules de navigateur Web sont disponibles et vous permettent de basculer entre l’utilisation des bibliothèques intermédiaires à des fins de test lorsque les bibliothèques sont hébergées dans le cloud.
Utiliser le hook de déploiement de la gestion dynamique des balises using-the-dynamic-tag-management-deployment-hook
Lorsqu’AEM héberge les bibliothèques de gestion dynamique des balises, vous pouvez utiliser le service de crochet de déploiement de gestion dynamique des balises pour pousser automatiquement les mises à jour de la bibliothèque vers AEM. Les mises à jour de la bibliothèque sont envoyées lorsque des modifications sont apportées aux bibliothèques (par exemple, lorsque les propriétés Web de gestion dynamique des balises sont modifiées).
Pour utiliser le hook de déploiement, la gestion dynamique des balises doit pouvoir se connecter à l’instance AEM qui héberge les bibliothèques. Autorisez l’accès à AEM pour les serveurs de gestion dynamique des balises.
Dans certains cas, AEM peut être inaccessible (par exemple, lorsqu’il se trouve derrière un pare-feu). Dans ces cas, vous pouvez utiliser l’option d’importateur d’interrogations d’AEM pour récupérer régulièrement les bibliothèques. Une expression de travail cron détermine la planification des téléchargements de bibliothèque.
Activation de l’accès au service Hook de déploiement enabling-access-for-the-deployment-hook-service
Autorisez le service de crochet de déploiement de gestion dynamique des balises à accéder à AEM afin qu’il puisse mettre à jour les bibliothèques hébergées dans AEM. Indiquez l’adresse IP des serveurs de gestion dynamique des balises qui mettent à jour les bibliothèques d’évaluation et d’exploitation en fonction des besoins :
- Évaluation :
107.21.99.31
- Exploitation :
23.23.225.112
et204.236.240.48
Exécutez la configuration à l’aide de la console Web ou d’un nœud sling:OsgiConfig
:
- Dans la console Web, utilisez l’élément Configuration du crochet de déploiement de gestion dynamique des balises Adobe de la page Configuration.
- Pour une configuration OSGi, le PID du service est
com.adobe.cq.dtm.impl.servlets.DTMDeployHookServlet
.
Le tableau suivant décrit les propriétés à configurer.
dtm.staging.ip.whitelist
dtm.production.ip.whitelist
Création de la configuration de la gestion dynamique des balises creating-the-dynamic-tag-management-configuration
Créez une configuration cloud de sorte que l’instance AEM puisse s’authentifier auprès de la gestion dynamique des balises et interagir avec votre propriété web.
Paramètres généraux general-settings
Propriétés d’auto-hébergement – Évaluation et production self-hosting-properties-staging-and-production
Les propriétés suivantes de la configuration de gestion dynamique des balises permettent à AEM d’héberger les bibliothèques gestion de dynamique des balises. Les propriétés permettent à AEM de télécharger et d’installer les bibliothèques. Vous pouvez éventuellement mettre à jour automatiquement les bibliothèques afin de vous assurer qu’elles reflètent les modifications apportées à l’application de gestion dynamique des balises.
Certaines propriétés utilisent des valeurs obtenues à partir de la section Téléchargement de bibliothèque de l’onglet Incorporer de votre propriété web de gestion dynamique des balises. Pour plus d’informations, voir Téléchargement de bibliothèque dans l’aide de la gestion dynamique des balises.
Lorsque les bibliothèques de gestion dynamique des balises sont hébergées sur AEM, AEM configure automatiquement certaines propriétés de la propriété web en fonction de votre configuration. Consultez les descriptions du tableau suivant.
Propriétés d’hébergement dans le cloud – Test et production cloud-hosting-properties-staging-and-production
Configurez les propriétés suivantes pour la configuration de la gestion dynamique des balises lorsque celle-ci est hébergée dans le cloud.
La procédure suivante utilise l’interface utilisateur optimisée pour les écrans tactiles afin de configurer l’intégration à la gestion dynamique des balises.
-
Sur le rail, cliquez sur Outils > Opérations > Cloud > Services cloud.
-
Dans la zone Gestion dynamique des balises, un des liens suivants s’affiche pour ajouter une configuration :
- Cliquez sur Configurer maintenant s’il s’agit de la première configuration que vous ajoutez.
- Cliquez sur Afficher les configurations, puis sur le lien + en regard de Configurations disponibles si une ou plusieurs configurations ont été créées.
-
Saisissez le titre de la configuration, puis cliquez sur Créer.
-
Dans le champ Jeton API, saisissez la valeur de la propriété Jeton API de votre compte d’utilisateur de gestion dynamique des balises.
Pour obtenir la valeur de votre jeton API, contactez le service client de gestion dynamique des balises.
note note NOTE Le jeton API n’expire que lorsque l’utilisateur de la gestion dynamique des balises le demande explicitement. -
Cliquez sur Connexion à la gestion dynamique des balises. AEM s’authentifie auprès de la gestion dynamique des balises et récupère la liste des sociétés auxquelles votre compte est associé.
-
Sélectionnez la société, puis la propriété que vous utilisez pour effectuer le suivi de votre site AEM.
-
Si vous utilisez du code d’évaluation sur l’instance de création, désélectionnez l’option Inclure le code de production sur l’instance de création.
-
Si nécessaire, indiquez les valeurs des propriétés dans les onglets Paramètres d’évaluation et Paramètres de production, puis cliquez sur OK.
Télécharger manuellement la bibliothèque de gestion dynamique des balises manually-downloading-the-dynamic-tag-management-library
Téléchargez manuellement les bibliothèques de gestion dynamique des balises pour les mettre immédiatement à jour dans AEM. Par exemple, téléchargez manuellement une bibliothèque mise à jour avant que l’importateur d’interrogations ne soit programmé pour télécharger automatiquement la bibliothèque.
-
Sur le rail, cliquez sur Outils > Opérations > Cloud > Services cloud.
-
Dans la zone Gestion dynamique des balises, cliquez sur Afficher les configurations, puis cliquez sur votre configuration.
-
Dans la zone Paramètres d’évaluation ou Paramètres de production, cliquez sur le bouton Déclencher le processus de téléchargement pour télécharger et déployer le lot de bibliothèques.
/etc/clientlibs/dtm/my config/companyID/propertyID/servertype
.myconfig
companyID
propertyID
servertype
Associer une configuration de la gestion dynamique des balises à votre site associating-a-dynamic-tag-management-configuration-with-your-site
Associez votre configuration de gestion dynamique des balises aux pages de votre site web de sorte qu’AEM ajoute le script requis aux pages. Associez la page racine de votre site à la configuration. Tous les descendants de cette page héritent de l’association. Si nécessaire, vous pouvez remplacer l’association sur une page descendante.
Utilisez la procédure suivante pour associer une page et les descendants à une configuration de gestion dynamique des balises.
-
Ouvrez la page racine de votre site dans l’IU classique.
-
Utilisez le sidekick pour ouvrir les propriétés de la page.
-
Dans l’onglet Services cloud, cliquez sur Ajouter un service, sélectionnez Gestion dynamique des balises, puis cliquez sur OK.
-
Utilisez le menu déroulant Gestion dynamique des balises pour sélectionner votre configuration, puis cliquez sur OK.
Utilisez la procédure suivante pour remplacer l’association de configuration héritée pour une page. Le remplacement affecte la page et tous ses descendants.
-
Ouvrez la page dans l’IU classique.
-
Utilisez le sidekick pour ouvrir les propriétés de la page.
-
Dans l’onglet Services cloud, cliquez sur l’icône de cadenas en regard de la propriété Hérité de, puis cliquez sur Oui dans la boîte de dialogue de confirmation.
-
Supprimez ou sélectionnez une autre configuration de gestion dynamique des balises, puis cliquez sur OK.