Vous consultez actuellement l'aide de la version:

Remarque :

ClientContext a été remplacé par ContextHub. Pour plus de détails, voir la documentation associée concernant la configuration et la documentation développeur.

ClientContext est un mécanisme qui fournit certaines informations sur la page et le visiteur actuels. 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. En fonction de votre instance, certaines informations sont demandées ou dérivées.
  • Les balises de page et le nombre de fois que ces balises ont été consultées par le visiteur actuel (ceci s’affiche lorsque vous placez le curseur de la souris sur une balise).
  • Informations sur la page.
  • Informations sur l’environnement technique, telles que l’adresse IP, le navigateur et la résolution d’écran.
  • Tous les segments actuellement résolus.

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

ClientContext_Icons

Composants ClientContext disponibles

ClientContext peut afficher les propriétés suivantes (selon les éléments ayant été sélectionnés à l’aide de Modifier) :

Flux d’activités

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

La boutique de session de panier informe également le serveur des changements de promotion résolus (en fonction des modifications de segmentation) avec la propriété 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 de la boutique générique.

La boutique générique doit être configurée avec un rendu JS qui affiche les données d’une 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 inclut un 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 aux limites d’utilisation de l’API Google.

Remarque :

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. La boutique Géolocalisation contient uniquement la latitude et la longitude de l’emplacement.

Boutique 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 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 <script> à 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. Voir l’exemple figurant dans Stockage de données dans le contexte client via JSONP.

Remarque :

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

Remarque :

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, voir la section :

    /home/users/geometrixx/aparker@geometrixx.info/profile => propriété friends

Nuage de tags

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.

Remarque :

Les balises définies sur des ressources DAM qui s’affichent sur les pages visitées ne sont pas prises en compte.

ViewedProducts

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

Cette boutique de session ne comporte pas de composant de contexte client par défaut.

Pour plus d’informations, voir ClientContext en détail.

Remarque :

Le composant Données de page ne figure plus dans le contexte client comme composant par défaut. Si nécessaire, vous pouvez ajouter ce composant en modifiant le contexte client, en ajoutant le composant Propriétés de la boutique générique, puis en le configurant pour définir la Boutique comme composant Données de page.

Modification du profil ClientContext

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

  • Modifier le profil utilisé dans ClientContext vous permet de voir les différentes expériences de l’utilisateur sur 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

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

Lorsque vous avez terminé, vous pouvez réinitialiser le profil.

Chargement d’un nouveau profil de visiteur avec l’icône de chargement de profil

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

    ClientContext_LoadProfile
  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

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

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

    ClientContext_ResetProfile

Changement de la plateforme de navigateur

  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.

Changement de la géolocalisation

  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

  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 procéder au chargement dans ClientContext.

Modification de ClientContext

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

Modification des détails des propriétés

La modification de ClientContext 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é

Après avoir ouvert la page de conception de ClientContext, 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 de propriété

Après avoir ouvert la page de conception de ClientContext, vous pouvez également Supprimer une propriété si elle n’est plus utile. Ceci comprend les propriétés fournies clé en main. L’option Réinitialiser restaure ces propriétés si elles ont été supprimées.

Stockage des références dans ClientContext 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 retourne 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

Ajoutez le composant Boutique JSONP à ClientContext et utilisez-le pour récupérer et stocker des informations de géolocalisation sur le 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 ClientContext, appuyez sur Ctrl-Alt-C (Windows) ou Ctrl-Option-C (Mac).

  3. Cliquez sur l’icône de modification de ClientContext pour ouvrir le concepteur ClientContext.

    chlimage_1
  4. Faites glisser le composant Boutique JSONP sur ClientContext.

    chlimage_1
  5. Double-cliquez sur le composant pour ouvrir la boîte de dialogue d’édition. 

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

    http://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 figurent dans la liste sont celles qui seront disponibles dans ClientContext.

    chlimage_1
  7. Cliquez sur OK.

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

    chlimage_1

Création du 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 de la boutique de session et la date actuelle pour déterminer si c’est l’hiver là où se trouve le 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 Titre, saisissez Hiver.
    2. Sélectionnez le modèle de segment.
    3. Cliquez sur Créer.
  4. Cliquez avec le bouton droit de la souris sur le segment Hiver et cliquez sur Ouvrir. 

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

    chlimage_1
  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 :

    • Boutique : wipmania
    • 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

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne