ClientContext client-context

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.
NOTE
Le contexte client a été remplacé par ContextHub. Pour plus d’informations, voir configuration et développeur documentation.

Le contexte client. est un mécanisme qui fournit certaines informations sur la page et le visiteur actifs. Il peut être ouvert via Ctrl-Alt-C (Windows) ou Ctrl-Option-C (Mac) :

clientcontext_alisonparker

Dans l’environnement de publication et de création, il affiche des informations sur :

  • le visiteur ; selon votre instance, certaines informations sont demandées ou dérivées.
  • Les balises de page et le nombre d’accès à ces balises par le visiteur actuel (ceci s’affiche lorsque vous placez la souris sur une balise spécifique).
  • Informations sur la page.
  • des informations sur l'environnement technique ; comme l’adresse IP, la résolution du navigateur et de l’écran.
  • Tout segment actuellement résolu.

Les icônes (disponibles uniquement dans l’environnement de création) vous permettent de configurer les détails du contexte client :

Composants ClientContext disponibles available-client-context-components

ClientContext peut afficher les propriétés suivantes (selon ce qui a été sélectionné à l’aide de l’option Modifier) :

Informations sur l’utilisateur
Affiche les informations côté client suivantes :

  • La valeur Adresse IP
  • Les mots-clés utilisés pour le référencement au moteur de recherche
  • Le navigateur en cours d’utilisation
  • L’OS (système d’exploitation) utilisé
  • L’écran résolution
  • La position X de la souris
  • La position Y de la souris

Flux d’activités Cette section fournit des informations sur l’activité sociale de l’utilisateur sur différentes plateformes, telles que les forums AEM, les blogs, les évaluations, etc.

Campagne Permet aux auteurs de simuler une expérience spécifique pour une campagne. Ce composant remplace la sélection normale de résolution et d’expérience de campagne pour permettre de tester différentes variantes.

La résolution de campagne est normalement basée sur la propriété de priorité de la campagne. L’expérience est normalement sélectionnée en fonction de la segmentation.

Panier Affiche les informations sur le panier, y compris les entrées de produits (titre, quantité, propriété priceFormatted, etc.), les promotions résolues (titre, message, etc.). et les bons (code, description, etc.).

Le magasin de sessions de panier informe également le serveur des modifications de promotion résolues (en fonction des modifications de segmentation) à l’aide de ClientContextCartServlet.

Boutique générique Composant générique qui affiche le contenu d’une boutique. Il s’agit d’une version de niveau inférieur du composant Propriétés du magasin générique .

Le magasin générique doit être configuré avec un moteur de rendu JS qui affichera les données de manière personnalisée.

Propriétés de la boutique générique Composant générique qui affiche le contenu d’une boutique. Il s’agit d’une version de niveau supérieur du composant Boutique générique.

Le composant Propriétés de la boutique générique comprend un moteur de rendu par défaut qui répertorie les propriétés configurées (ainsi qu’une miniature).

Géolocalisation Affiche la latitude et la longitude du client. Elle utilise l’API de géolocalisation HTML5 pour demander la position actuelle au navigateur. Il en résulte l’affichage d’une fenêtre dans laquelle le navigateur demande à l’utilisateur s’il accepte que son emplacement soit partagé.

Lorsqu’il est affiché dans le cloud contextuel, le composant utilise une API Google pour afficher une carte sous forme de vignette. Le composant est soumis à l’API Google limites d’utilisation.

NOTE
Dans AEM 6.1, la boutique Géolocalisation ne fournit plus la fonction de géocodage inversé. Par conséquent, elle ne récupère plus de détails concernant l’emplacement actuel, tels que le nom de ville ou le code pays. Les segments qui utilisent ces données de boutique ne fonctionneront pas correctement. Le magasin Géolocalisation contient uniquement la latitude et la longitude d’un emplacement.

Magasin JSONP Un composant qui affiche le contenu qui dépend de votre installation.

La norme JSONP est un complément de JSON qui permet de contourner la stratégie de même origine (ce qui empêche les applications Web de communiquer avec les serveurs se trouvant sur un autre domaine). Elle consiste à envelopper l’objet JSON dans un appel de fonction afin de pouvoir le charger sous forme de à partir de l’autre domaine (ce qui est une exception autorisée de la stratégie de même origine).

La boutique JSONP est semblable à n’importe quelle autre boutique, mais elle charge des informations issues d’un autre domaine sans avoir besoin d’un proxy pour ces informations sur le domaine actuel. Consultez l’exemple figurant dans la section Stockage de données dans le contexte client via JSONP.

NOTE
La boutique JSONP ne met pas en cache les informations figurant dans le cookie, mais récupère ces données à chaque chargement de la page.

Données de profil Affiche les informations collectées dans le profil utilisateur. Par exemple, le sexe, l’âge ou l’adresse électronique.

Segments résolus Indique quels segments sont actuellement résolus (souvent selon d’autres informations affichées dans le contexte client). Ceci s’avère utile lors de la configuration d’une campagne.

Par exemple, si la souris se trouve sur la partie gauche ou droite de la fenêtre. Ce segment est principalement utilisé à des fins de test, car les modifications sont visibles immédiatement.

Graphique des réseaux sociaux Affiche le graphique des réseaux sociaux des amis et des abonnés de l’utilisateur.

NOTE
Il s’agit actuellement d’une fonction de démonstration qui repose sur des données pré-configurées définies sur les nœuds de profil de nos utilisateurs de démonstration. Pour obtenir un exemple, reportez-vous à :
/home/users/geometrixx/aparker@geometrixx.info/profile => propriété amis

Nuage de balises Affiche les balises définies sur la page actuelle et celles qui ont été collectées lors de la navigation sur le site. Déplacer le curseur sur une balise affiche le nombre de fois que l’utilisateur actuel a accédé aux pages contenant cette balise.

NOTE
Les balises définies sur des ressources de gestion des ressources numériques qui s’affichent sur les pages visitées ne sont pas prises en compte.

Boutique Technographics Ce composant dépend de votre installation.

ViewedProducts Conserve la trace des produits que l’acheteur a affichés. Peut être interrogé pour le produit le plus récemment consulté ou le produit le plus récemment consulté qui ne figure pas déjà dans le panier.

Ce magasin de sessions ne comporte pas de composant ClientContext par défaut.

Pour plus d’informations, consultez Contexte client en détail.

NOTE
« Données de page » ne figure plus dans le contexte client sous la forme d’un composant par défaut. Au besoin, vous pouvez l’ajouter en modifiant le contexte client, en ajoutant le composant Propriétés de la boutique générique, puis en le configurant de manière à définir Boutique en tant que pagedata.

Modification du profil ClientContext changing-the-client-context-profile

ClientContext vous permet de modifier les détails de manière interactive :

  • La modification du profil utilisé dans ClientContext vous permet de voir les différentes expériences que les différents utilisateurs verront pour la page en cours.
  • En plus de modifier le profil utilisateur, vous pouvez modifier certains détails du profil pour voir comment le contenu de la page diffère selon différentes conditions.

Chargement d’un nouveau profil utilisateur loading-a-new-user-profile

Vous pouvez modifier le profil en effectuant l’une des opérations suivantes :

Lorsque vous avez terminé, vous pouvez réinitialisation du profil.

Chargement d’un nouveau profil de visiteur à l’aide de l’icône Charger le profil loading-a-new-visitor-profile-with-the-load-profile-icon

  1. Cliquez sur l’icône de chargement de profil :

  2. Cette action ouvre la boîte de dialogue, où vous pouvez sélectionner le profil à charger :

    clientcontext_profileloader

  3. Cliquez sur OK pour procéder au chargement.

Chargement d’un nouveau profil utilisateur avec le curseur de sélection loading-a-new-user-profile-with-the-selection-slider

Vous pouvez également sélectionner un profil avec le curseur de sélection :

  1. Double-cliquez sur l’icône représentant l’utilisateur actuel. Le sélecteur s’ouvre ; utilisez les flèches pour passer en revue les profils disponibles :

    clientcontext_profileselector

  2. Cliquez sur le profil à charger. Lorsque les informations sont chargées, cliquez en dehors du sélecteur pour le fermer.

Réinitialisation du profil sur l’utilisateur actuel resetting-the-profile-to-the-current-user

  1. Utilisez l’icône de réinitialisation pour réinitialiser le profil dans le contexte client sur celui de l’utilisateur actuel :

Modification de la plateforme du navigateur changing-the-browser-platform

  1. Double-cliquez sur l’icône représentant la plateforme de navigateur. Le sélecteur s’ouvre ; utilisez les flèches pour passer en revue les plateformes/navigateurs disponibles :

    clientcontext_browserplatform

  2. Cliquez sur la plateforme de navigateur que vous souhaitez charger. Lorsque les informations sont chargées, cliquez en dehors du sélecteur pour le fermer.

Modification de la géolocalisation changing-the-geolocation

  1. Double-cliquez sur l’icône de géolocalisation. Une carte étendue s’ouvre ; vous pouvez y faire glisser le marqueur vers un nouvel emplacement :

    clientcontext_geomocationrelocate

  2. Cliquez en dehors de la carte pour la fermer.

Modification de la sélection des balises changing-the-tag-selection

  1. Double-cliquez sur la section Nuage de tags de ClientContext. La boîte de dialogue s’ouvre, et vous pouvez y sélectionner des balises :

    clientcontext_tagselection

  2. Cliquez sur OK pour charger dans ClientContext.

Modification de ClientContext editing-the-client-context

La modification d’un contexte client peut être utilisée pour définir (ou réinitialiser) les valeurs de certaines propriétés, ajouter une nouvelle propriété ou en supprimer une qui n’est plus nécessaire.

Modification des détails d’une propriété editing-property-details

La modification du contexte client peut être utilisée pour définir (ou réinitialiser) les valeurs de certaines propriétés. Ceci vous permet de tester certains scénarios spécifiques (ce qui est particulièrement utile pour la segmentation et les campagnes).

clientcontext_alisonparker_edit

Ajout d’un composant de propriété adding-a-property-component

Après avoir ouvert la page de conception du contexte client, vous pouvez également Ajouter une propriété entièrement nouvelle à l’aide des composants disponibles (les composants sont répertoriés dans le sidekick ou la boîte de dialogue Insérer un nouveau composant qui s’affiche si vous double-cliquez sur la case Faire glisser des composants ou éléments ici) :

clientcontext_alisonparker_new

Suppression d’un composant Propriété removing-a-property-component

Après avoir ouvert la page de conception de ClientContext, vous pouvez également Supprimer une propriété si elle n’est plus utile. Cela inclut les propriétés fournies d’usine ; Réinitialiser les rétablissent s’ils ont été supprimés.

Stockage des données dans ClientContext via JSONP storing-data-in-client-context-via-jsonp

Suivez cet exemple pour utiliser le composant de boutique contextuel Boutique JSONP afin d’ajouter des données externes à ClientContext. Ensuite, créez un segment basé sur les informations issues de ces données. Cet exemple utilise le service JSONP que WIPmania.com fournit. Le service renvoie des informations de géolocalisation en fonction de l’adresse IP du client web.

Cet exemple utilise l’exemple de site web Geometrixx Outdoors pour accéder à ClientContext et tester le segment créé. Vous pouvez utiliser un autre site web tant que la page a activé ClientContext. (Voir Ajout de ClientContext à une page.)

Ajout du composant Boutique JSONP add-the-jsonp-store-component

Ajoutez le composant Boutique JSONP à ClientContext et utilisez-le pour récupérer et stocker les informations de géolocalisation du client web.

  1. Ouvrez la page d’accueil en anglais du site Geometrixx Outdoors sur l’instance de création AEM. (http://localhost:4502/content/geometrixx-outdoors/en.html).

  2. Pour ouvrir le contexte client, appuyez sur Ctrl+Alt+C (Windows) ou Ctrl+Option+C (Mac).

  3. Cliquez sur l’icône de modification en haut de ClientContext pour ouvrir ClientContext Designer.

  4. Faites glisser le composant Boutique JSONP vers ClientContext.

    chlimage_1-40

  5. Double-cliquez sur le composant pour ouvrir la boîte de dialogue de modification.

  6. Dans la zone URL du service JSONP, saisissez l’URL suivante, puis cliquez sur Récupérer la boutique :

    https://api.wipmania.com/jsonp?callback=${callback}

    Le composant appelle le service JSONP et répertorie toutes les propriétés que les données renvoyées contiennent. Les propriétés qui se trouvent dans la liste sont celles qui seront disponibles dans ClientContext.

    chlimage_1-274

  7. Cliquez sur OK.

  8. Revenez à la page d’accueil Geometrixx Outdoors et actualisez-la. ClientContext inclut désormais les informations du composant Boutique JSONP.

    chlimage_1-275

Création du segment create-the-segment

Utilisez les données de la boutique de session que vous avez créée à l’aide du composant Boutique JSONP. Le segment utilise la latitude du magasin de sessions et la date courante pour déterminer s’il s’agit de l’heure d’hiver sur le site du client.

  1. Ouvrez la console Outils dans votre navigateur web (http://localhost:4502/miscadmin#/etc).

  2. Dans l’arborescence, cliquez sur le dossier Outils/Segmentation, puis sur Nouveau > Nouveau dossier. Spécifiez les valeurs de propriété suivantes, puis cliquez sur Créer :

    • Nom : mysegments
    • Titre : Mes segments
  3. Sélectionnez le dossier Mes segments et cliquez sur Nouveau > Nouvelle page :

    1. Pour le champ Titre, saisissez Hiver.
    2. Sélectionnez le modèle Segment .
    3. Cliquez sur Créer.
  4. Cliquez avec le bouton droit sur le segment Hiver, puis cliquez sur Ouvrir.

  5. Faites glisser la propriété de magasin générique vers le conteneur ET par défaut.

    chlimage_1-41

  6. Double-cliquez sur le composant pour ouvrir la boîte de dialogue de modification, spécifiez les valeurs de propriété suivantes, puis cliquez sur OK :

    • Magasin : wipmanie
    • Nom de la propriété : latitude
    • Opérateur : est supérieur à
    • Valeur de propriété : 30
  7. Faites glisser le composant Script vers le même conteneur ET, puis ouvrez sa boîte de dialogue de modification. Ajoutez le script suivant, puis cliquez sur OK :

    3 < new Date().getMonth() < 12

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8