Intégration

Utiliser des balises via Adobe Developer Console

Dernière mise à jour : 23 septembre 2024
  • S'applique à :
  • Experience Manager 6.5

Créé pour :

  • Intermédiaire
  • Développeur

AEM Sites 6.5

Conditions préalables

  • Instance de création et de publication d’AEM s’exécutant sur les ports localhost 4502 et 4503 respectivement.

  • Experience Cloud

    • Accéder à la solution Adobe Experience Cloud de votre organisation - https://<yourcompany>.experiencecloud.adobe.com

    • Experience Cloud est fourni avec les solutions suivantes :

      REMARQUE
      Vous devez disposer des autorisations nécessaires pour développer, approuver, publier, gérer des extensions et gérer des environnement dans Collecte de données. Si vous ne parvenez pas à effectuer l’une de ces étapes, car les options de l’interface utilisateur ne sont pas disponibles, contactez votre administrateur ou administratrice Experience Cloud pour en demander l’accès. Pour plus d’informations sur les autorisations de balises, voir la documentation.

  • Extensions de navigateur Chrome

    • Adobe Experience Cloud Debugger(https://chrome.google.com/webstore/detail/adobe-experience-platform/bfnnokhpnncpkdmbokanobigaccjkpob)

Utilisateurs et utilisatrices impliqués

Pour cette intégration, les audiences suivantes doivent être impliquées. Pour effectuer certaines tâches, vous aurez peut-être besoin d’un accès administratif.

  • Développeur ou développeuse
  • Administrateur ou administratrice AEM
  • Administrateur ou administratrice Experience Cloud

Présentation

AEM offre une intégration aux balises prête à l’emploi. Cette intégration permet aux administrateurs et administratrices d’AEM de configurer facilement des balises via une interface conviviale, réduisant ainsi le niveau d’effort et le nombre d’erreurs lors de la configuration de ces deux outils. Et rien que le fait d’ajouter l’extension Adobe Target aux balises permet d’utiliser toutes les fonctionnalités d’Adobe Target sur la ou les pages web d’AEM.

Dans cette section, nous passerons en revue les étapes d’intégration suivantes :

  • Balises

    • Créer une propriété de balises
    • Ajouter une extension Target
    • Créer un élément de données
    • Créer une règle de page
    • Configurer des environnements
    • Créer et publier

  • AEM

    • Créer un service cloud
    • Créer

Balises

Créer une propriété de balises

Une propriété est un conteneur que vous remplissez d’extensions, de règles, d’éléments de données et de bibliothèques lorsque vous déployez des balises sur votre site.

  1. Accéder à vos organisations Adobe Experience Cloud (https://<yourcompany>.experiencecloud.adobe.com)
  2. Connectez-vous à l’aide de votre Adobe ID et vérifiez que vous vous trouvez dans la bonne organisation.
  3. Dans le sélecteur de solutions, cliquez sur Experience Platform, la section Collecte de données, puis sélectionnez Balises.

Experience Cloud - Balises

  1. Vérifiez que vous vous trouvez dans la bonne organisation, puis créez une propriété de balises.
    Experience Cloud - Balises

    Pour plus d’informations sur la création de propriétés, consultez Création d’une propriété dans la documentation du produit.

  2. Cliquez sur le bouton Nouvelle propriété.

  3. Attribuez un nom à votre propriété (par exemple, Tutoriel AEM Target).

  4. En tant que domaine, saisissez localhost.com puisqu’il s’agit du domaine sur lequel le site de démonstration WKND est exécuté. Bien que le champ «  Domaine  » soit obligatoire, la propriété de balises fonctionne sur n’importe quel domaine où elle est implémentée. L’objectif principal de ce champ est de préremplir les options de menu du créateur de règles.

  5. Cliquez sur le bouton Enregistrer.

    Balises - Nouvelle propriété

  6. Ouvrez la propriété que vous venez de créer, puis cliquez sur l’onglet Extensions.

Ajouter une extension Target

L’extension Adobe Target prend en charge les implémentations côté client en utilisant le SDK JavaScript Target pour le web moderne, at.js. Les clientes et clients qui utilisent toujours l’ancienne bibliothèque de Target, mbox.js, doivent effectuer la mise à niveau vers at.js pour utiliser des balises.

L’extension Target se compose de deux parties principales :

  • La configuration de l’extension, qui gère les paramètres de bibliothèque principaux.

  • Des actions de règle pour effectuer les opérations suivantes :

    • Chargement de Target (at.js)
    • Ajout de paramètres à toutes les mBox
    • Ajout de paramètres à la mBox globale
    • Déclenchement de la mBox globale

  1. Sous Extensions, vous pouvez voir la liste des extensions déjà installées pour votre propriété de balises (l’extension principale Adobe Launch est installée par défaut).

  2. Sélectionnez l’option Catalogue des extensions, puis recherchez Target dans le filtre.

  3. Sélectionnez la dernière version du fichier at.js d’Adobe Target et cliquez sur Installer.
    Balises - Nouvelle propriété

  4. Cliquez sur le bouton Configurer et vous verrez apparaître la fenêtre de configuration avec les informations d’identification de votre compte Target importées, ainsi que la version du fichier at.js de cette extension.
    Target - Configuration de l’extension.

    Lorsque Target est déployé via des codes asynchrones intégrés aux balises, vous devez coder en dur un extrait de code de masquage préalable sur vos pages avant les codes intégrés aux balises afin de gérer le scintillement du contenu. Nous aborderons plus en détail l’extrait de code de masquage préalable plus tard. Vous pouvez télécharger l’extrait de code de masquage préalable ici.

  5. Cliquez sur Enregistrer pour terminer l’ajout de l’extension Target à votre propriété de balises. Vous devriez maintenant pouvoir voir l’extension Target affichée dans la liste des extensions Installées.

  6. Répétez les étapes ci-dessus pour rechercher l’extension « Experience Cloud ID Service » et l’installer.
    Extension - Experience Cloud ID Service.