DocumentationAEMGuide d’AEM Screens

Configuration de ContextHub dans AEM Screens configuring-contexthub-in-aem-screens

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Intermédiaire
  • Développeur

Cette section met l’accent sur la création et la gestion des modifications de ressources liées aux données à l’aide d’un magasin de données.

Termes clés key-terms

Avant de vous attaquer aux détails de la création et de la gestion des canaux pilotés par l’inventaire dans votre projet AEM Screens, vous devez connaître quelques-uns des termes clés importants et pertinents pour les différents scénarios.

Marque  : description de votre projet de haut niveau.

Zone  : fait référence au nom de votre projet AEM Screens, comme par exemple signalétique numérique publicitaire.

Activité  : définit les règles de catégorie telles que Basé sur l’inventaire, Basé sur la météo ou Basé sur la disponibilité du service.

Audience  : définit la règle.

Segment  : version de la ressource à lire pour la règle donnée. Par exemple, si la température est inférieure à 50 degrés Fahrenheit, l’écran affiche une image d’une boisson chaude. Dans le cas contraire, une boisson froide est affichée.

Le diagramme ci-dessous illustre visuellement comment les configurations ContextHub coïncident avec l’activité, l’audience et les canaux.

screen_shot_2019-05-29at53729pm

Prérequis preconditions

Avant de commencer à définir les configurations ContextHub d’un projet AEM Screens, vous devez configurer Google Sheets (à des fins de démonstration).

IMPORTANT
Google Sheets est utilisé dans l’exemple suivant à titre d’exemple de système de base de données à partir duquel les valeurs sont récupérées et uniquement à des fins pédagogiques. Adobe n’approuve pas l’utilisation de Google Sheets dans des environnements de production.
Pour plus d’informations, reportez-vous à la section Obtenir la clé API dans la documentation Google.

Étape 1 : configuration d’un magasin de données step-setting-up-a-data-store

Vous pouvez configurer le magasin de données en tant qu’événement d’E/S local ou d’événement de base de données local.

L’exemple suivant de déclencheurs de données au niveau des ressources présente un événement de base de données local. L’événement configure un magasin de données, tel qu’une feuille de calcul Excel, qui vous permet d’utiliser les configurations et le chemin des segments ContextHub vers le canal AEM Screens.

Après avoir configuré correctement la feuille google, comme illustré dans l’exemple ci-dessous :

image

La validation suivante correspond à ce que vous verrez si vous vérifiez votre connexion en saisissant les deux valeurs *google sheet ID* et *API key*, au format indiqué ci-dessous :

https://sheets.googleapis.com/v4/spreadsheets/<your sheet id>/values/Sheet1?key=<your API key>

image

NOTE
L’exemple spécifique ci-dessous présente Google Sheets comme un magasin de données chargé de déclencher un changement de ressource si la valeur est supérieure à 100 ou inférieure à 50.

Étape 2 : paramétrage des configurations de magasin step-setting-store-configurations

  1. Parcourir ContextHub

    Accédez à votre instance AEM et cliquez sur l’icône Outils dans la barre latérale de gauche. Cliquez sur Sites > ContextHub, comme illustré ci-dessous.

    image

  2. Création une configuration de magasin ContextHub

    1. Accédez au conteneur de configuration intitulé screens.

    2. Cliquez sur Créer  > Créer un conteneur de configuration et saisissez le titre ContextHubDemo.

      image

    3. Accédez à ContextHubDemo  > Créer Configuration ContentHub, puis cliquez sur Enregistrer.

      note note
      NOTE
      Après avoir cliqué sur Enregistrer, vous vous trouvez ensuite sur l’écran Configuration ContextHub.

    4. Sur l’écran Configuration ContextHub, cliquez sur Créer  > Configuration de magasin ContextHub.

    image

    note caution
    CAUTION
    Dans le cadre d’AEM 6.5 Feature Pack 4 ou d’AEM 6.4 Feature Pack 8, les clients doivent effectuer une mise à jour de /conf/screens/settings/cloudsettings vers sling:Folder.
    Suivez les étapes ci-dessous :
    1. Accédez à CRXDE Lite, puis à /conf/screens/settings/cloudsettings.
    2. Vérifiez que cloudsettings jcr:primaryType se trouve dans sling:Folder. Si jcr:primaryType ne se trouve pas dans sling:folder, passez aux étapes suivantes.
    3. Cliquez avec le bouton droit sur /conf/screens/settings et créez un nœud avec le nom cloudsettings1 et le type sling:Folder, puis enregistrez les modifications.
    4. Déplacez tous les nœuds sous /conf/screens/settings/cloudsettings vers cloudsettings1.
    5. Supprimez cloudsettings et enregistrez.
    6. Renommez cloudsettings1 en cloudsettings et enregistrez.
    7. Observez que /conf/screens/settings/cloudsettings dispose du jcr:primaryType sling:Folder.
    Vous devez suivre ces étapes dans l’instance de création et de publication avant ou après la mise à niveau.

    1. Saisissez le Titre Google Sheets, le Nom du magasin googlesheets et le Type de magasin contexthub.generic-jsonp, puis cliquez sur Suivant.

      note caution
      CAUTION
      Si vous utilisez Adobe Experience Manager (AEM) 6.4, saisissez le Titre de configuration googlesheets et le Type de magasin contexthub.generic-jsonp.

      image

    2. Entrez votre configuration json spécifique. Vous pouvez par exemple utiliser le code json ci-dessous à des fins de démonstration et cliquer sur Enregistrer. La configuration du magasin s’affiche sous le titre Google Sheets dans la configuration ContextHub.

      note important
      IMPORTANT
      Veillez à remplacer le code par l’*<Sheet ID>* et la *<API Key>*, que vous avez récupérés lors de la configuration des Google Sheets.
      code language-none 
       {
  "service": {
  "host": "sheets.googleapis.com",
  "port": 80,
  "path": "/v4/spreadsheets/<your google sheets id>/values/Sheet1",
  "jsonp": false,
  "secure": true,
  "params": {
  "key": "<your Google API key>"
 }
},
"pollInterval": 10000
}
      note note
      NOTE
      Dans l’exemple de code ci-dessus, pollInterval définit la fréquence d’actualisation des valeurs (en ms).
      Remplacez le code par l’*<Sheet ID>* et la *<API Key>*, que vous avez récupérés lors de la configuration des Google Sheets.
      note caution
      CAUTION
      Si vous créez vos documents Google Sheets pour stocker des configurations en dehors du dossier global (par exemple, dans votre propre dossier de projet), le ciblage ne fonctionnera pas immédiatement.

  3. Configuration de la segmentation du magasin

    1. Accédez à Configuration du magasin ContentHub et créez une autre configuration de magasin dans le conteneur de configuration AEM Screens, puis définissez le Titre sur segmentation-contexthub, le Nom du magasin sur segmentation et le Type de magasin sur aem.segmentation.

      image

    2. Cliquez sur Suivant, puis sur Enregistrer.

      note note
      NOTE
      Ignorez le processus de définition du fichier json et laissez-le vide.

Étape 3 : configuration de segments dans les audiences setting-up-audience

  1. Création de segments dans les audiences

    1. Dans votre instance AEM, accédez à Personnalisation  > Audiences  > screens.

    2. Cliquez sur Créer  > Créer un segment ContextHub. La boîte de dialogue Nouveau segment ContextHub s’ouvre.

    3. Saisissez le Titre **Higherthan50**, puis cliquez sur Créer. De la même manière, créez un autre segment intitulé **Lowerthan50**.

      image

    4. Sélectionnez le segment **Higherthan50**, puis cliquez sur Propriétés dans la barre d’actions.
      image

    5. Sélectionnez l’onglet Personnalisation dans Propriétés du segment. Définissez le Chemin d’accès ContextHub sur /conf/screens/settings/cloudsettings/ContextHubDemo/contexthub configurations et le Chemin d’accès aux segments sur /conf/screens/settings/wcm/segments, puis cliquez sur Enregistrer, comme illustré dans la figure ci-dessous.

    image

    1. De même, définissez le Chemin d’accès ContextHub et le Chemin d’accès aux segments pour le segment **Lowerthan50**.

Étape 4 : configuration de la marque et de la zone setting-brand-area

Pour créer une marque dans vos activités et une zone dans votre marque :

  1. Création d’une marque dans les activités

    1. Dans votre instance AEM, accédez à Personnalisation > Activités.

    2. Cliquez sur Créer  > Créer une marque.

    3. Dans l’assistant Créer une page, cliquez sur Marque, puis sur Suivant.

    4. Saisissez le Titre ScreensBrand, puis cliquez sur Créer. Votre marque a été créée, comme illustré ci-dessous.

      image

      note caution
      CAUTION
      Problème connu :
      Pour ajouter une zone, supprimez le principal de l’URL, par exemple
      http://localhost:4502/libs/cq/personalization/touch-ui/content/v2/activities.html/content/campaigns/screensbrand/master.

  2. Création d’une zone dans votre marque

    Pour créer une zone dans la marque, procédez comme suit :

    1. Cliquez sur Créer, puis sur Créer une zone.

      image

    2. Sélectionnez Zone dans l’assistant Créer une page, puis cliquez sur Suivant.

    3. Saisissez le Titre ScreensValue, puis cliquez sur Créer.
      Une zone sera créée dans votre marque.

Étape 5 : création de segments dans une activité step-setting-up-audience-segmentation

Après avoir configuré un magasin de données et défini votre activité (marque et zone), procédez comme suit pour créer des segments dans l’activité.

  1. Création de segments dans les activités

    1. Dans votre instance AEM, accédez à Personnalisation  > Activités  > ScreensBrand  > ScreensValue.

    2. Cliquez sur Créer  > Créer une activité. L’assistant Configurer l’activité s’ouvre.

    3. Saisissez le titre ValueCheck50 et le nom valuecheck50. Sélectionnez le Moteur de ciblage ContextHub (AEM) dans la liste déroulante, puis cliquez sur Suivant.

      image

    4. Cliquez sur Ajouter une expérience  dans l’assistant **Configure Activity**.

    5. Dans Audiences, cliquez sur **Higherthan50**, puis sur Ajouter une expérience et saisissez le Titre **higherthan50** et le Nom **higherthan50**. Cliquez sur OK.

    6. Dans Audiences, cliquez sur **Lowerthan50**, puis sur Ajouter une expérience et saisissez le Titre **lowerthan50** et le Nom **lowerthan50**. Cliquez sur OK.

    image

    1. Cliquez sur Suivant, puis sur Enregistrer. L’activité **ValueCheck50** est désormais créée et configurée.

      image

Étape 5 : modification des segments dans les audiences editing-audience-segmentation

  1. Modification des segments

    1. Dans votre instance AEM, accédez à Personnalisation  > Audiences  > screens.

    2. Sélectionnez le segment **Higherthan50** et cliquez sur Modifier dans la barre d’actions.

    3. Faites glisser le composant Comparaison : Propriété - Valeur et déposez-le dans l’éditeur.

    4. Cliquez sur l’icône en forme de clé à molette pour ouvrir la boîte de dialogue Comparer une propriété et une valeur.

    5. Sélectionnez googlesheets/value/1/0 dans la liste déroulante du Nom de la propriété.

      note note
      NOTE
      L’élément googlesheets/value/1/0 fait référence à la ligne 2 et à la colonne renseignée dans google Sheets représentée ci-dessous :

      image

    6. Sélectionnez l’Opérateur supérieur à dans le menu déroulant.

    7. Saisissez la Valeur 70.

      note note
      NOTE
      AEM valide alors vos données dans la feuille de calcul Google en affichant votre segment en vert.

      image

    De même, modifiez les valeurs de propriété en indiquant **Lowerthan50**.

    1. Faites glisser le composant Comparaison : Propriété - Valeur et déposez-le dans l’éditeur.

    2. Cliquez sur l’icône en forme de clé à molette.

    3. Dans la boîte de dialogue Comparer une propriété avec une valeur, sélectionnez googlesheets/value/1/0 dans la liste déroulante du Nom de la propriété.

    4. Sélectionnez l’Opérateur inférieur à dans le menu déroulant.

    5. Saisissez la Valeur 50.

Activation du ciblage dans les canaux step-enabling-targeting-in-channels

Suivez les étapes ci-dessous pour activer le ciblage dans vos canaux.

  1. Accédez à l’un des canaux AEM Screens. Les étapes suivantes montrent comment activer le ciblage à l’aide de DataDrivenChannel créé dans un canal AEM Screens.

  2. Sélectionnez le canal TargetChannel et cliquez sur Propriétés dans la barre d’actions.

    image

  3. Cliquez sur l’onglet Personnalisation pour définir les configurations ContextHub.

    1. Définissez le Chemin d’accès ContextHub sur /conf/screens/settings/wcm/segments et le Chemin d’accès de segments sur /conf/screens/settings/wcm/segments.

    2. Définissez la marque sur ScreensBrand dans la liste déroulante. Définissez la référence de zone sur ScreensValue.

    3. Cliquez sur Enregistrer et fermer.

      note note
      NOTE
      Utilisez le chemin ContextHub et le chemin des segments où vous avez initialement enregistré vos segments et configurations ContextHub.

      Image

    4. Accédez au canal TargetChannel et sélectionnez-le, puis cliquez sur Modifier dans la barre d’actions.

      note note
      NOTE
      Si vous avez tout configuré correctement, l’option Ciblage s’affiche dans la liste déroulante de l’éditeur, comme illustré ci-dessous.

      image

En savoir plus : exemples de cas d’utilisation learn-more-example-use-cases

Après avoir configuré ContextHub pour votre projet AEM Screens, vous pouvez suivre les différents cas d’utilisation pour comprendre comment les ressources déclenchées par des données jouent un rôle essentiel dans différents secteurs d’activité :

  1. Activation ciblée du stock de vente au détail
  2. Activation de la température de l’agence de voyages
  3. Activation de la réservation d’hébergements
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053