Souscrire à Adobe Analytics et Adobe Target opting-into-adobe-analytics-and-adobe-target
AEM dispose d’une procédure de souscription pour vous aider à l’intégrer à Adobe Analytics et Target. Elle est prête à l’emploi sous la forme d’une tâche préchargée attribuée au groupe d’utilisateurs administrateurs.
Lorsque vous vous connectez en tant qu’administrateur, cette tâche (Configurer Analytics et Targeting) est disponible dans la boîte de réception. Sur la base des informations d’identification que vous fournissez, elle vous aide à configurer et à intégrer ces services.
Vous disposez des options suivantes pour configurer l’intégration :
-
Configurer l’intégration via la tâche.
Cela peut être effectué immédiatement ou ultérieurement ; la tâche reste dans la boîte de réception jusqu’à ce qu’une action soit effectuée. Dans les deux cas, la configuration peut être réalisée directement dans l’IU ou à l’aide d’un fichier
.properties
prédéfini. -
Exclusion de l’intégration
Sélectionnez cette option si vous préférez configurer manuellement l’intégration. Consultez également la section Intégration d’AEM à Adobe Target et Adobe Analytics à l’aide de DTM.
-
Paramétrer la configuration et l’approvisionnement à l’aide d’un script.
Configurer l’intégration configuring-the-integration
Optez pour l’intégration avec :
- Analytics pour permettre l’utilisation des capacités de suivi et d’analyse de pages ;
- Target pour permettre l’utilisation de ses fonctionnalités de personnalisation.
Pour l’une ou l’autre de ces options, saisissez les informations de votre compte d’utilisateur et indiquez les pages qui font l’objet d’un suivi.
Lorsque vous optez pour l’intégration, AEM effectue les tâches suivantes :
- Création des configurations cloud qui permettent la connexion à Analytics et Target.
- Création des frameworks qui déterminent les données qui font l’objet d’un suivi.
- Configuration des pages web pour utiliser ces services.
Pour accepter la tâche préchargée et prête à l’emploi :
-
Dans votre boîte de réception, sélectionnez et ouvrez la tâche Configurer les analyses et le ciblage.
-
Pour Analytics :
- Saisissez les informations du compte d’utilisateur pour Analytics, puis cliquez sur le bouton Ajouter correspondant.
- Les informations d’identification appropriées sont authentifiées.
- Lorsque le compte Analytics est authentifié, sélectionnez suite de rapports Analytics à utiliser. AEM récupère ces suites de rapports Analytics. Le statut devient Ajouté.
-
Pour Target :
- Saisissez les informations du compte d’utilisateur pour Target puis cliquez sur le bouton Ajouter correspondant.
- Les informations d’identification appropriées sont authentifiées. Le statut devient Ajouté.
-
Sélectionnez Suivant.
-
Sélectionnez les sites pour lesquels Analytics et/ou Target doivent être utilisés.
-
Sélectionnez Terminé.
note caution CAUTION Une fois que vous avez souscrit à la configuration, vous devez publier les sites ou les pages concernés afin de répliquer ces modifications sur votre instance de publication.
Désactivation de l’intégration opting-out-of-the-integration
Désactivez l’intégration avec Analytics et Target lorsque vous :
-
ne voulez pas intégrer ces produits ;
-
Préférez la configuration manuelle des intégrations.
Pour plus d’informations sur la configuration manuelle des intégrations, voir Intégration à Adobe Analytics et Intégration à Adobe Target.
Pour vous exclure, vous devez terminer la tâche préchargée :
Fournir des informations de compte à l’aide d’un fichier de propriétés providing-account-information-using-a-properties-file
Installez un fichier de propriétés qu’AEM lit au démarrage du serveur pour configurer les propriétés de compte pour l’intégration à Analytics et Target. Lorsque vous utilisez le fichier de propriétés, l’assistant d’activation utilise automatiquement les propriétés du fichier et la configuration cloud est créée en conséquence.
Le fichier de propriétés est un fichier texte appelé marketingcloud.properties que vous enregistrez dans le répertoire de travail utilisé par le processus AEM (généralement le même répertoire que le fichier JAR). Le fichier inclut les propriétés suivantes :
- analytics.server : URL du centre de données Analytics que vous utilisez.
- analytics.company : société associée à votre compte d’utilisateur Analytics.
- analytics.username : votre nom d’utilisateur Analytics.
- analytics.secret : secret associé à votre nom d’utilisateur Analytics.
- analytics.reportsuite : nom de la suite de rapports Analytics à utiliser.
- target.clientcode : code client associé à votre compte Target.
- target.email : adresse e-mail que vous utilisez pour authentifier votre compte Target.
- target.password : mot de passe associé à votre adresse e-mail.
Les propriétés et les valeurs sont séparées par des signes égal (=). Les propriétés d’Analytics sont dotées du préfixe analytics
, et les propriétés de Target du préfixe target
. Pour configurer un service, fournissez les valeurs de toutes ses propriétés. Si vous ne souhaitez pas configurer de service, ne fournissez aucune valeur pour un service.
Le fichier .properties
de l’exemple suivant inclut les valeurs de propriétés afin de créer une configuration cloud pour Analytics :
analytics.server=https://test.omniture.com/login/
analytics.company=MyCompany
analytics.username=sbroders
analytics.secret=12345678
analytics.reportsuite=myreportsuite
target.clientcode=
target.email=
target.password=
La procédure suivante explique comment s’exclure de l’intégration à l’aide du fichier de propriétés.
-
Créez le fichier
marketingcloud.properties
dans le répertoire de travail utilisé par le processus AEM (instance de création).note note NOTE Le répertoire de travail est généralement le répertoire contenant le fichier JAR ou license.properties
.Toutefois, il peut également être défini en tant que chemin absolu par la propriété système : mac.provisioning.file.container
-
Ajoutez les valeurs de propriété en fonction de vos comptes Analytics et/ou Target.
-
Démarrez ou redémarrez le serveur, puis connectez-vous à l’aide d’un compte d’administration.
-
Ouvrez la tâche Configurer Analytics et Targeting comme indiqué dans Configuration de l’intégration. Plutôt que de demander les informations relatives à votre compte, l’assistant utilise les valeurs figurant dans le fichier
.properties
.Sélectionnez Ajouter pour le service approprié, puis poursuivez avec l’assistant.
À propos des configurations cloud about-the-cloud-configurations
Lorsque vous configurez l’intégration à Analytics et Target, AEM crée automatiquement les configurations et les structures cloud requises. Par exemple, la configuration cloud Analytics est appelée Compte Analytics approvisionné.
Vous n’avez pas besoin de modifier les configurations cloud. Toutefois, vous pouvez configurer les structures selon vos besoins. (Voir Mappage des données de composant aux propriétés Adobe Analytics et Ajout d’une structure Target.)
reportsuite
spécifique est sélectionné, la structure est alors limitée au mode d’exécution de publication. Cela signifie que le suivi fonctionne uniquement sur l’instance de publication.all
.Paramétrer la configuration et l’approvisionnement via un script configuring-the-setup-and-provisioning-via-script
En tant qu’administrateur, vous pouvez déclencher l’installation et la mise en service avec un script plutôt que de suivre une à une les étapes de l’assistant. Vous pouvez le faire en procédant comme suit :
- Envoyez une requête POST à /libs/cq/cloudservicesprovisioning/content/autoprovisioning.json avec les paramètres requis.
Les paramètres que vous envoyez dépendent des éléments suivants :
-
Si vous souhaitez utiliser le fichier marketingcloud.properties rempli avec toutes les informations d’identification requises, vous devez alors envoyer les paramètres suivants :
automaticProvisioning
=true
servicename
=analytics|target
path
=chemin d’une page AEM à laquelle joindre les configurations de services cloud créées
Par exemple, une requête curl qui crée à la fois des configurations Analytics et Target, et les joint à la page we.retail prendrait la forme suivante :
code language-shell curl -v -u admin:admin -X POST -d"automaticProvisioning=true&servicename=target&servicename=analytics&path=/content/we-retail" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json
-
Si vous ne souhaitez pas utiliser le fichier marketingcloud.properties, vous devez alors envoyer les informations d’identification et les paramètres. Par exemple :
- automaticProvisioning=
true
- serviceName=
analytics|target
- path=chemin d’une page AEM à laquelle joindre les configurations de services cloud créées ; plusieurs chemins peuvent être définis.
- analytics.server=
https://servername
- analytics.company=
Name of company
- analytics.username=
me
- analytics.secret=
secret
- analytics.reportsuite=
we-retail
- target.clientcode=
mycompany
- target.email=
me@adobe.com
- target.password=
password
Dans ce cas, la requête curl qui crée à la fois des configurations Analytics et Target, et qui les joint à la page we-retail, prendrait la forme suivante :
code language-shell curl -v -u admin:admin -X POST -d"automaticProvisioning=false&servicename=target&servicename=analytics&path=/content/we-retail&analytics.server=https://servername/&analytics.company=Name of company&analytics.username=me&analytics.secret=secret&analytics.reportsuite=weretail&target.clientcode=mycompany&target.email=me@adobe.com&target.password=password" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json
- automaticProvisioning=