Configuration de ContextHub dans AEM Screens

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

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 Fait référence la description générale de votre projet.

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

Activité Définit la catégorie de règles, comme Basé sur l’inventaire, Basé sur la météo, Basé sur la disponibilité du service, etc.

Audience Définit la règle.

Segment Fait référence à la version de la ressource à lire pour la règle donnée, par exemple : si la température est inférieure à 10 degrés Celsius, l’écran affiche une image d’un café chaud. Sinon, il affiche une image d’une boisson froide.

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

Conditions préalables

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é d’API dans la documentation Google.

Étape 1 : configuration d’un magasin de données

Vous pouvez configurer l’entrepôt 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 concerne les déclencheurs de données au niveau des ressources. Il montre comment un événement de base de données local configure un magasin de données, tel qu’une feuille Excel, en utilisant les configurations ContextHub et le chemin d’accès aux segments vers le canal AEM Screens.

Vous devez avoir configuré correctement la feuille de calcul Google, par exemple comme illustré ci-dessous :

image

La validation suivante correspond à ce que vous verrez si vous vérifiez votre connexion en saisissant les deux valeurs ID de feuille de calcul Google et clé API, au format indiqué ci-dessous :

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

image

Remarque

L’exemple spécifique ci-dessous présente les feuilles de calcul Google 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

  1. Accès à ContextHub

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

    image

  2. Création d’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.

      Remarque

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

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

      image

      ATTENTION

      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. /conf/screens/settings/cloudsettings doit maintenant présenter sling:Folder comme jcr:primaryType.

      Vous devez suivre ces étapes dans l’instance de création et de publication avant ou après la mise à niveau.

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

      ATTENTION

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

      image

    6. Entrez votre configuration json spécifique. Vous pouvez par exemple utiliser le fichier json suivant à des fins de démonstration, puis cliquer sur Enregistrer. La configuration du magasin s’affichera avec le nom Google Sheets dans la configuration ContextHub.

      IMPORTANT

      Veillez à remplacer le code par l’<ID de feuille> et la <clé API>, que vous avez récupérés lors de la configuration des Google Sheets.

       {
        "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
      }
      
      Remarque

      Dans l’exemple de code ci-dessus, pollInterval définit la fréquence d’actualisation des valeurs (en ms).
      Remplacez le code par l’<ID de feuille> et la <clé API>, que vous avez récupérés lors de la configuration des Google Sheets.

      ATTENTION

      Si vous créez des configurations de magasin Google Sheets 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 de magasin ContextHub et créez une autre configuration de magasin dans le conteneur de configuration screens en renseignant le Titre segmentation-contexthub, le Nom du magasin segmentation et le Type de magasin aem.segmentation.

      image

    2. Cliquez sur Suivant, puis sur Enregistrer.

      Remarque

      Vous devez ignorer le processus de définition du fichier json et le laisser vide.

Étape 3 : configuration de segments dans les audiences

  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

    6. 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

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, sélectionnez Marque et cliquez sur Suivant.

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

      image

      ATTENTION

      Problème connu :

Pour ajouter une zone, supprimez le terme « master » de l’URL, par exemple
http://localhost:4502/libs/cq/personalization/touch-ui/content/v2/activities.html/content/campaigns/screensbrand/master.

  1. 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 à partir de l’assistant Créer une page et 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é

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 Configurer l’activité.

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

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

      image

    7. 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

  1. Modification des segments

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

    2. Sélectionnez le segment Higherthan50, puis 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é pour ouvrir la boîte de dialogue Comparer une propriété une valeur.

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

      Remarque

      googlesheets/value/1/0 fait référence à la ligne 2 et à la colonne renseignée dans la feuille de calcul Google représentée dans la figure ci-dessous :

      image

    6. Sélectionnez l’Opérateur supérieur à (greater-than) dans le menu déroulant.

    7. Saisissez la Valeur 70.

      Remarque

      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.

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

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

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

    11. Sélectionnez l’Opérateur inférieur à (lower-than) dans le menu déroulant.

    12. Saisissez la Valeur 50.

Activation du ciblage dans les canaux

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. Sélectionnez l’onglet Personnalisation pour définir les configurations ContextHub.

    1. Définissez le Chemin d’accès ContextHub sur /conf/screens/settings/cloudsettings/ContextHubDemo/contexthub configurations et le Chemin d’accès de segments sur /conf/screens/settings/wcm/segments et cliquez sur Enregistrer.

    2. Cliquez sur Enregistrer et fermer.

      Remarque

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

      image

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

      Remarque

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

      image

En savoir plus : exemples de cas d’utilisation

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

Sur cette page