Sortie de recherche guidée

Vous pouvez personnaliser la sortie dans n’importe quel format texte, y compris XML ou JSON.

Utilisation de la sortie de recherche guidée

Le format de sortie est personnalisable pour prendre en charge les facettes, le tri et d’autres décisions spécifiques à l’implémentation qui sont prises pendant le processus de conception. Vous pouvez adapter le format lui-même pour simplifier le développement du client frontal, si nécessaire.

La sortie complète est contenue dans des balises <result> et la plupart des données dynamiques sont placées entre des balises <![CDATA[ ]]>. Cette organisation permet aux résultats de contenir du code HTML et d’autres entités non XML.

Lorsque des liens vers d’autres pages sont fournis, ils sont présentés sous la forme d’une URL relative. Ce résultat inclut également les paramètres de chaîne de requête transmis pour générer le résultat souhaité.

Présentation d'une implémentation de recherche guidée

Lorsque vous commencez une mise en oeuvre de la recherche guidée, n’oubliez pas que Adobe Search&Promote est responsable de la couche métier. C'est-à-dire la logique qui entoure les résultats et facettes présentés à un client à un moment donné.

Lorsque vous implémentez l’Application web frontale qui analyse et affiche les résultats au format HTML, limitez la fonctionnalité à l’affichage uniquement. En d'autres termes, toute logique côté serveur que vous utilisez pour créer la couche Présentation ne prend pas les décisions concernant ce que vous devez présenter à un client, sauf si cela est nécessaire. Les règles de fonctionnement ne fonctionneront pas comme vous le prévoyez si le script frontal modifie les résultats de la recherche.

Adobe Search&Promote permet de conserver l’état utilisateur des options de raffinement de recherche sélectionnées au moyen des paramètres d’URL. Tous les noeuds <link> contiennent les paramètres appropriés des sélections du client. Ces paramètres peuvent inclure des sélections de chemin de navigation, de pagination, de tri et de facettes. Le cas échéant, les noeuds <undolink> sont renvoyés pour permettre à un client de "désactiver" une sélection. Facettes et chemins de navigation offre ces types de liens.

Utilisation du serveur de recherche

Une API de type REST est utilisée avec laquelle vous pouvez interagir pour effectuer des recherches et recevoir des résultats. Les formats les plus utilisés pour les résultats sont XML ou JSON.

L’URI de base est associé à un compte spécifique et à un environnement intermédiaire ou actif. Vous pouvez demander plusieurs alias pour l’URI de base à votre gestionnaire de compte. Par exemple, une société fictive appelée Megacorp comporte les deux URL de base suivantes associées à son compte :

  • https://search.megacorp.com
  • https://stage.megacorp.com

L’URI précédent effectue des recherches sur son index actif et l’URI suivant sur son index intermédiaire.

Les demandes de recherche se composent de l’URI de base et d’un ensemble de paramètres CGI ou de paires clé-valeur qui indiquent la recherche souhaitée pour le compte associé à l’URI de base.

Trois formats de paramètres CGI sont pris en charge. Par défaut, votre compte est configuré pour séparer les paramètres CGI par un point-virgule ( ;), comme dans l'exemple suivant :

  • https://search.megacorp.com?q=shoes ;page=2

Si vous préférez, votre gestionnaire de compte peut configurer votre compte pour qu’il utilise des esperluettes ( &) pour séparer les paramètres CGI, comme dans l’exemple suivant :

  • https://search.megacorp.com?q=shoes &page=2

Un troisième format, appelé format SEO, est également pris en charge lorsqu’une barre oblique ( /) est utilisée à la place du séparateur et que le signe égal est utilisé pour générer des liens "propres", comme dans l’exemple suivant :

  • https://search.megacorp.com/q/shoes/page/2

Chaque fois que le format d’optimisation du référencement est utilisé pour envoyer une requête, tous les liens de sortie sont renvoyés au même format.

Paramètres de la requête de recherche

Le tableau suivant décrit les paramètres standard de requête de recherche prêts à l’emploi que vous pouvez utiliser. Les règles de traitement et les règles de fonctionnement peuvent être créées à partir de paramètres de requête définis par l’utilisateur pour implémenter une logique métier personnalisée adaptée à votre société. Vous pouvez travailler avec l’équipe de conseil pour obtenir de la documentation sur ces paramètres.

Paramètre de requête de recherche

Exemple

Description

q

q= chaîne

Indique la chaîne de requête pour la recherche. Ce paramètre correspond au paramètre de recherche principal sp_q .

q#

q#= chaîne

Les paramètres numérotés q et x permettent d’accomplir des facettes ou de rechercher dans un champ donné.

Le paramètre q définit le terme que vous recherchez dans la facette comme le paramètre numéroté x correspondant le désigne. Par exemple, si vous disposez de deux facettes nommées taille et couleur, vous pouvez avoir quelque chose comme ceci :

q1=small;x1=size;q2=red;x2=color

Ce paramètre correspond aux paramètres de recherche principale sp_q_exact_# .

x#

x#= chaîne

Les paramètres numérotés q et x permettent d’accomplir des facettes ou de rechercher dans un champ donné.

Le paramètre q définit le terme que vous recherchez dans la facette comme le paramètre numéroté x correspondant le désigne. Par exemple, si vous disposez de deux facettes nommées taille et couleur, vous pouvez avoir quelque chose comme ceci :

q1=small;x1=size;q2=red;x2=color

Ce paramètre correspond aux paramètres de recherche principale sp_x_# .

collecte

collection= chaîne

Indique la collection à utiliser pour la recherche. Ce paramètre correspond au paramètre de recherche principal sp_k .

count

count= nombre

Indique le nombre total de résultats affichés. La valeur par défaut est définie dans Paramètres > Recherche > Recherches . Ce paramètre correspond au paramètre de recherche principal sp_c .

page

page= nombre

Indique la page des résultats qui sont renvoyés.

rang

rang= champ

Indique le champ de classement à utiliser pour le classement statique. Le champ doit être un champ de type Classement dont la pertinence est supérieure à 0. Ce paramètre correspond au paramètre principal sp_sr .

gs_store

gs_store= chaîne

Indique le magasin à rechercher.

sort

sort= nombre

Indique l’ordre de tri. "0" est la valeur par défaut et est triée par score de pertinence ; "1" est classé par date ; "-1" n’est pas trié.

Les utilisateurs peuvent spécifier un nom de champ pour la valeur du paramètre sp_s . Par exemple, sp_s=title trie les résultats en fonction des valeurs contenues dans le champ de titre. Lorsqu’un nom de champ est utilisé pour la valeur d’un paramètre sp_s , les résultats sont triés par ce champ, puis subtriés par pertinence.

Pour activer cette fonctionnalité, procédez comme suit :

  1. Dans le menu produit, cliquez sur Paramètres > Métadonnées > Définitions .
  2. Sur la page Définitions par étapes , effectuez l'une des opérations suivantes :
    • Cliquez sur Ajouter un nouveau champ .
    • Cliquez sur Modifier pour un nom de champ particulier.
  3. Dans la liste déroulante Tri , cliquez sur Ascendant ou Descendant .

    Ce paramètre correspond au paramètre de recherche principal sp_s .

Intégration à votre système

Vous trouverez ci-dessous des recommandations pour l’intégration à votre système.

  • Communication avec le serveur de recherche.

    Vous pouvez communiquer avec les serveurs Web Adobe Search&Promote à l’aide de requêtes de GET HTTP. Vos serveurs génèrent ces requêtes ou côté client exécutant une requête Ajax.

  • Enregistrement de l'historique de recherche.

Adobe Search&Promote est sans état lorsque l’état entier est transmis dans la requête http.

  • Analyse des résultats renvoyés.

    Il est recommandé d’utiliser un analyseur XML basé sur SAX pour analyser la réponse XML. Si vous générez une requête Ajax, configurez Adobe Search&Promote pour renvoyer des réponses JSON pour ces requêtes afin de faciliter l’analyse de la réponse.

Sortie JSON de recherche guidée

Tableaux décrivant la sortie de réponse JSON standard.

Voir aussi Recherche guidée JSON Output.

Vous pouvez consulter la réponse JSON pour les éléments suivants :

Bannières

Exemple :

<banners> 
 <banner> 
  <area><![CDATA[top-left]]></area> 
  <content><![CDATA[<img src="https://www.megacorp.com/discount.gif"/>]]></content> 
 </banner> 
</banners>

Balises dans les bannières

Description

<banner>

Noeud de bannière individuel. Vous pouvez avoir plusieurs noeuds de bannière.

<area>

Zone de la page Web dans laquelle la bannière est affichée.

<content>

Contenu HTML pour la zone de bannière.

Chemin de navigation

Dans l’exemple suivant, chaque fois que le client se rétrécit davantage à travers les facettes, la sélection est ajoutée à la barre de navigation. Chaque élément est représenté sous la forme <breadcrumb-item>.

Exemple :

 <breadcrumb> 
  <breadcrumb-item> 
   <link><![CDATA[?q=new+year]]></link> 
   <value><![CDATA[new year]]></value> 
  </breadcrumb-item> 
  <breadcrumb-item> 
   <link><![CDATA[?q=new+year;q1=Articles;x1=content-type]]></link> 
   <value><![CDATA[Articles]]></value> 
  </breadcrumb-item> 
 </breadcrumb> 

Balises dans la barre de navigation

Description

<link>

Lien relatif vers les résultats de la recherche qui affiche la vue souhaitée. Le fait de cliquer sur un lien de chemin de navigation conduit le client à une vue dans laquelle toutes les améliorations suivantes sont supprimées. D’autres options sont également disponibles.

<value>

Texte destiné aux clients pour l’élément de chemin de navigation.

Facettes

Les facettes sont des options de raffinement qui permettent aux clients de filtrer les résultats. Les facettes sont généralement utilisées pour la catégorisation, les plages de prix, les sélections de couleurs et d’autres ajustements d’attributs. Les métadonnées de l’index sont ce qui motive les facettes.

Il est courant de masquer ou d’afficher les facettes de catégorisation lorsqu’un client passe par la catégorisation. Le plus haut niveau de catégorisation (catégorie) est connu sous le nom de niveau 1. Lorsqu’un client clique sur une option de niveau 1, les options de raffinement de niveau 2 (sous-catégorie) s’affichent et les options de niveau 1 disparaissent. Lorsqu’un client clique sur une option de niveau 2, les options de raffinement de niveau 3 (sous-catégorie) s’affichent et les options de niveau 2 disparaissent. Comme nous l'avons mentionné plus haut, ces options sont masquées et affichées. Votre application Web n'est pas affectée par elles.

Chaque facette est contenue dans des balises <facet-item>. Dans l’exemple suivant, il présente une facette qui permet au client d’affiner les résultats de la recherche par "vacances".

Exemple :

 <facets> 
  <facet-item> 
   <facet-title><![CDATA[Holidays]]></facet-title> 
   <facet-value> 
    <label><![CDATA[New Year]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=New+Year;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[11]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Christmas]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Christmas;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[7]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Chinese New Year]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Chinese+New+Year;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[2]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Thanksgiving]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Thanksgiving;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[2]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[4th of July]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=4th+of+July;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Father&#39;s Day]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Father's+Day;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Hanukkah]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Hanukkah;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Mother&#39;s Day]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Mother's+Day;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Valentine&#39;s Day]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Valentine's+Day;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
  </facet-item> 
  <facet-item> 
   <facet-title><![CDATA[Seasons]]></facet-title> 
   <facet-value> 
    <label><![CDATA[Winter]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Winter;x1=content-type;x2=seasons]]></link> 
    <count><![CDATA[20]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Summer]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Summer;x1=content-type;x2=seasons]]></link> 
    <count><![CDATA[7]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Autumn]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Autumn;x1=content-type;x2=seasons]]></link> 
    <count><![CDATA[4]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Spring]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Spring;x1=content-type;x2=seasons]]></link> 
    <count><![CDATA[2]]></count> 
   </facet-value> 
  </facet-item> 
 </facets> 

Balises en facettes

Description

<facet-title>

Titre orienté client pour la facette.

<libellé>

Libellé destiné au client pour l’option de facette.

<link>

Lien relatif vers les résultats que l’option affine.

<count>

Nombre de résultats dans cet ensemble de résultats affiné.

<undolink>

Lorsqu’une valeur de facette est sélectionnée, le noeud renvoie un "lien d’annulation" qui permet à un client d’annuler les résultats.

En-tête et Requête

Exemple :

<result> 
 <query> 
  <user-query><![CDATA[new year]]></user-query> 
  <lower-results><![CDATA[1]]></lower-results> 
  <upper-results><![CDATA[16]]></upper-results> 
  <total-results><![CDATA[621]]></total-results> 
 </query> 

Utilisées ensemble, ces balises présentent un message tel que ce qui suit : "Affichage des résultats 1 à 16 sur 621 pour la "nouvelle année"."

Balises dans l’en-tête et la requête

Description

<user-query>

Requête de mots-clés envoyée avec la demande.

<lower-results>

Numéro de l'article du premier résultat sur cette page.

<upper-results>

Numéro de l'article du dernier résultat sur cette page.

<total-results>

Nombre total de résultats correspondant à la requête utilisateur.

<custom-field>

Champ facultatif qui s’applique globalement aux résultats de la recherche.

Pagination

Exemple :

<pagination> 
 <total-pages><39></total-pages> 
 <pages> 
   <page position="first"></page> 
   <page position="last">?i=1;page=39;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="previous"></page> 
   <page position="next">?i=1;page=2;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="1" selected="true">?i=1;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="2">?i=1;page=2;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="3">?i=1;page=3;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="4">?i=1;page=4;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="5">?i=1;page=5;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="6">?i=1;page=6;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="7">?i=1;page=7;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="8">?i=1;page=8;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="9">?i=1;page=9;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="10">?i=1;page=10;q=new+year;q1=Articles;x1=content-type]]></page> 
 </pages> 
</pagination> 

Balises dans la pagination

Description

<total-pages>

Nombre total de pages de résultats, en fonction du nombre de résultats divisé par le nombre de résultats par page.

<page position="first">

Contient un lien relatif vers la première page du jeu de résultats, sauf si le client consulte déjà la page 1. Dans ce cas, il est vide.

<page position="last">

Contient un lien relatif vers la dernière page du jeu de résultats, sauf si le client consulte la dernière page. Dans ce cas, il est vide.

<page position="previous">

Contient un lien relatif vers la page précédente du jeu de résultats, sauf si le client consulte la page 1 ; dans ce cas, il est vide.

<page position="next">

Contient un lien relatif vers la dernière page du jeu de résultats, sauf si le client consulte la dernière page. Dans ce cas, il est vide.

<page position="x">

Contient un lien relatif vers un numéro de page particulier. Dix numéros de page contigus s’affichent. À la page 1, il s'agirait des pages 1 à 10. À la fin de l'ensemble de résultats (dans ce cas, 39), il s'agirait des pages 30 à 39. Par exemple, au centre du jeu de résultats, page 15, il s’agirait des pages 11 à 20.

selected="true">

Appliqué en tant qu’attribut à la page actuellement sélectionnée.

Recherches récentes

Les recherches récentes sont une fonctionnalité basée sur des cookies qui ne fonctionne que si vous transmettez les informations des cookies aux serveurs.

Exemple :

<recent-searches> 
 <recent-search> 
  <search-term><![CDATA[shoes]]></search-term> 
  <link><![CDATA[?q=shoes]]></link> 
 </recent-search> 
</recent-searches> 

Balises dans les recherches récentes

Description

<recent-search>

Noeud de recherche récente individuel. Vous pouvez avoir plusieurs noeuds de recherche récente.

<search-term>

Terme recherché précédemment par le client.

<link>

Liens vers la recherche précédente.

Résultats

Le jeu de résultats est une zone personnalisable de la réponse JSON. Chaque index est unique dans les mécanismes de nommage des champs des métadonnées. Des champs communs sont renvoyés pour chaque résultat, tels que le titre, la description et l’URL. Cependant, toutes les métadonnées définies pour une page de l’index peuvent être disponibles pour être utilisées dans chaque noeud de résultats. La catégorisation, les prix, les couleurs et les vignettes ne sont que quelques-unes des options que vous pouvez appliquer à un résultat pour obtenir des résultats de recherche plus convaincants.

Le format Résultats est personnalisé en fonction des métadonnées propres à votre implémentation. Toutes les données par résultat à afficher dans les résultats, y compris les URL des images miniatures, sont contenues ici.

En outre, il est possible de configurer plusieurs zones de résultats dans la page, telles que "Résultats présentés", ou de séparer les sections "Produits" et "Contenu" des résultats. Dans ce cas, plusieurs zones de résultats sont fournies dans le code HTML, bien que les facettes ne soient associées qu’au jeu de résultats Principal.

Exemple :

 <results> 
  <result> 
    <index><![CDATA[1]]></index> 
    <result-title><![CDATA[New Year's Eve Slumber Party]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/new-years-eve-slumber-party-705199/]]></url> 
    <meta-description><![CDATA[Fun New Year's celebration ideas for your kids]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <small-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/new-years-eve-

slumber-party-parties-photo-80-FF1200SLEEPA18.jpg]]></small-thumbnail-img> 
    <large-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/new-years-eve- 
slumber-party-parties-photo-160-FF1200SLEEPA18.jpg]]></large-thumbnail-img> 
    <byline><![CDATA[Nancy Mades]]></byline> 
    <blurb><![CDATA[Fun New Year's celebration ideas for your kids]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[2]]></index> 
    <result-title><![CDATA[10 Holiday Traditions to Start This Year]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/10-holiday-traditions-to-start-this-year-704781/]]></url> 
    <meta-description><![CDATA[Reader ideas to make Thanksgiving, Christmas, and New Year's even more magical]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <small-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/10-holiday- 
traditions-to-start-this-year-parties-photo-80-FF1107HOLIA01.jpg]]></small-thumbnail-img> 
    <large-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/10-holiday- 
traditions-to-start-this-year-parties-photo-160-FF1107HOLIA01.jpg]]></large-thumbnail-img> 
    <byline><![CDATA[Julie Taylor]]></byline> 
    <blurb><![CDATA[Reader ideas to make Thanksgiving, Christmas, and New Year's even more magical]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[3]]></index> 
    <result-title><![CDATA[A Perfect New Year's Eve]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/a-perfect-new-years-eve-705258/]]></url> 
    <meta-description><![CDATA[You can turn New Year's into a celebration for the whole family.]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <byline><![CDATA[Teri Keough]]></byline> 
    <blurb><![CDATA[You can turn New Year's into a celebration for the whole family.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[4]]></index> 
    <result-title><![CDATA[New Year's Fun and Games]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/new-years-fun-and-games-705220/]]></url> 
    <meta-description><![CDATA[Craft, game and food ideas for a New Year's celebration with kids.]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <byline><![CDATA[Charlotte Meryman]]></byline> 
    <blurb><![CDATA[Craft, game and food ideas for a New Year's celebration with kids.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[5]]></index> 
    <result-title><![CDATA[11 Great Ways to Start the New Year]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/11-great-ways-to-start-the-new-year-705552/]]></url> 
    <meta-description><![CDATA[11 New Family Traditions to Start This Year from My Magazine]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <byline><![CDATA[Emily Block]]></byline> 
    <blurb><![CDATA[11 New Family Traditions to Start This Year from My Magazine]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[6]]></index> 
    <result-title><![CDATA[Celebrating Chinese New Year]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/celebrating-chinese-new-year-705260/]]></url> 
    <meta-description><![CDATA[Crafts, food, and games to help you celebrate Chinese New Year.]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Crafts, food, and games to help you celebrate Chinese New Year.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[7]]></index> 
    <result-title><![CDATA[New Year's Eve, Family Style]]></result-title> 
    <url><![CDATA[https://mysite.com/holidays/new-years-eve-family-style-701283/]]></url> 
    <meta-description><![CDATA[Start a family New Year's Eve tradition by having an evening of kid-focused fun at home]]></meta-description> 
    <category><![CDATA[holidays]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Start a family New Year's Eve tradition by having an evening of kid-focused fun at home]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[8]]></index> 
    <result-title><![CDATA[Chinese New Year Activities]]></result-title> 
    <url><![CDATA[https://mysite.com/crafts/chinese-new-year-activities-710345/]]></url> 
    <meta-description><![CDATA[Activities for celebrating Chinese New Year.]]></meta-description> 
    <category><![CDATA[crafts]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Activities for celebrating Chinese New Year.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[9]]></index> 
    <result-title><![CDATA[More Organized in the New Year]]></result-title> 
    <url><![CDATA[https://mysite.com/holidays/more-organized-in-the-new-year-701284/]]></url> 
    <meta-description><![CDATA[Tips for getting your household more organized--and getting the kids to help.]]></meta-description> 
    <category><![CDATA[holidays]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Tips for getting your household more organized--and getting your kids to help out.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[10]]></index> 
    <result-title><![CDATA[Checklists: Year-End Safety Checklist]]></result-title> 
    <url><![CDATA[https://mysite.com/holidays/checklists-year-end-safety-checklist-701352/]]></url> 
    <meta-description><![CDATA[Make sure that your home is safe with our year-end safety checklist!]]></meta-description> 
    <category><![CDATA[holidays]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Make sure that your home is safe with our year-end safety checklist!]]></blurb> 
  </result>   
 </results> 
</customer-result> 

Balises dans les résultats

Description

<index>

Numéro de série du résultat dans ce jeu de résultats. Dans cet exemple, où dix résultats sont affichés par page, à la page 2 des résultats, le premier élément aurait un index de 11.

<result-title>

Titre destiné aux clients pour cette page.

<url>

URL de cette page. Il est utilisé pour créer un hyperlien qui permet au client de cliquer sur les résultats.

Formulaire de recherche

Exemple :

<search-form> 
 <include-tnt-mbox>1 </included-tnt-mbox> 
 <autocomplete> 
  <css><![CDATA[<!--link rel="stylesheet" type="te 
        xt/css"href="//content.atomz.com/sp000000a8/publish/autoc 
        omplete_styles.css?sp_css_cache_ver=2" /-->]]> 
  </css> 
  <form-content><![CDATA[<div id="autocomplete"></div>]]> 
  </form-content> 
  <js><![CDATA[<script type="text/javascript" 
   src="//content.atomz.com/sp100491de/publish/autoc 
   omplete_data.js?sp_js_cache_ver=3"></script>]]> 
  </js> 
 </autcomplete> 
 <hidden-parameters> 
  <parameter> 
   <name><![CDATA[store]]></name> 
   <value><![CDATA[mens]]></value> 
  </parameter> 
 </hidden-parameters> 
</search-form>

Balises dans le formulaire de recherche

Description

<include-tnt-mbox>

Facultatif. Lorsqu’elle est présente dans le fichier JSON, une valeur de 1 indique que votre compte est lié à Test&Cible et qu’il comporte au moins une règle métier qui fait partie d’un test A:B.

<autocomplete>

Facultatif. Lors de l’utilisation de la saisie semi-automatique, ce noeud est présent pour indiquer que le code CSS et JavaScript est présent sur la page, ainsi que le contenu du formulaire. En règle générale, ces champs ne changent pas, sauf si un utilisateur a modifié un paramètre de saisie semi-automatique. Dans ce cas, le champ xxx_cache_ver est incrémenté pour forcer l’invalidation du contenu mis en cache dans le navigateur de votre client.

<css>

CSS associé à la saisie semi-automatique. Il est recommandé de placer cette balise en haut de la page pour améliorer le rendu des pages.

<form-content>

Contenu requis dans votre recherche depuis l'utilitaire de saisie automatique pour se connecter au contrôle approprié.

<js>

JavaScript personnalisé requis pour la saisie semi-automatique. Il est recommandé de placer cette balise en bas de la page pour améliorer le rendu des pages. Le code JavaScript YUI est également requis pour la saisie automatique.

<hidden-parameters>

Contient tous les paramètres masqués (nom et valeur) à inclure dans le formulaire de recherche.

Tri

L'exemple suivant montre les données d'un menu de tri à trois options. Le menu permet au client de trier par pertinence, titre ou classement. L’élément actuellement sélectionné comprend un attribut "selected=true". ". Toujours offre une option de pertinence pour permettre à un client de revenir aux résultats de recherche par défaut qui étaient initialement affichés.

Exemple :

 <sort> 
  <sort-item selected="true"> 
   <label><![CDATA[Relevance]]></label> 
   <value><![CDATA[relevance]]></value> 
   <link><![CDATA[]]></link> 
  </sort-item> 
  <sort-item> 
   <label><![CDATA[Title]]></label> 
   <value><![CDATA[title]]></value> 
   <link><![CDATA[?q=new+year;q1=Articles;sort=title;x1=content-type]]></link>     
  </sort-item> 
  <sort-item> 
   <label><![CDATA[Rating]]></label> 
   <value><![CDATA[user-rating]]></value> 
   <link><![CDATA[?q=new+year;q1=Articles;sort=user-rating;x1=content-type]]></link>     
  </sort-item> 
 </sort>

Balises dans le menu Trier

Description

<libellé>

Texte de l’option destiné aux clients.

<value>

Représente la valeur du paramètre de chaîne de requête "sort" pour cette option. Cette balise n’est pas nécessaire si la valeur <link> est utilisée.

<link>

Pour les options non sélectionnées, le paramètre <link> contient le lien relatif qui renvoie le même jeu de résultats, trié par le nouveau paramètre de tri. Ce champ est vide pour l’option de tri actuellement sélectionnée.

Suggestions

Les suggestions sont renvoyées lorsqu’il n’y a que quelques résultats ou qu’aucun résultat n’est obtenu. Ce noeud contient des termes qui génèrent des requêtes réussies et peut être affiché sur une page "Aucun résultat". Le lien est également renvoyé afin qu’un client puisse accéder à la nouvelle requête.

Exemple :

 <suggestions> 
  <suggestion-item> 
   <link><![CDATA[?q=video]]></link> 
   <word><![CDATA[video]]> 

Balises dans les suggestions

Description

<link>

Lien relatif utilisé pour créer un hyperlien permettant de rechercher les résultats du terme de suggestion.

<word>

Terme suggéré.

Zones

Exemple :

<zones> 
 <zone> 
  <name><![CDATA[best-sellers]]></name> 
  <display><![CDATA[1]]></display> 
 </zone> 
</zones> 

Balises en zones

Description

<zone>

Noeud de zone individuel. Vous pouvez avoir plusieurs noeuds de zone.

<name>

Nom de la zone.

<display>

1 ou 0 pour indiquer si la zone est affichée ou non. Le contenu de la zone peut être statique sur votre page Web ou dans les résultats de la recherche, par exemple les meilleurs vendeurs ou les produits associés.

Sortie XML de recherche guidée

Tableaux décrivant la sortie de réponse XML standard.

Vous pouvez consulter la réponse XML pour les éléments suivants :

Bannières

Exemple :

<banners> 
 <banner> 
  <area><![CDATA[top-left]]></area> 
  <content><![CDATA[<img src="https://www.megacorp.com/discount.gif"/>]]></content> 
 </banner> 
</banners>

Balises dans les bannières

Description

<banner>

Noeud de bannière individuel. Vous pouvez avoir plusieurs noeuds de bannière.

<area>

Zone de la page Web dans laquelle la bannière est affichée.

<content>

Contenu HTML pour la zone de bannière.

Chemin de navigation

Dans l’exemple suivant, chaque fois que le client se rétrécit davantage à travers les facettes, la sélection est ajoutée à la barre de navigation. Chaque élément est représenté sous la forme <breadcrumb-item>.

Exemple :

 <breadcrumb> 
  <breadcrumb-item> 
   <link><![CDATA[?q=new+year]]></link> 
   <value><![CDATA[new year]]></value> 
  </breadcrumb-item> 
  <breadcrumb-item> 
   <link><![CDATA[?q=new+year;q1=Articles;x1=content-type]]></link> 
   <value><![CDATA[Articles]]></value> 
  </breadcrumb-item> 
 </breadcrumb> 

Balises dans la barre de navigation

Description

<link>

Lien relatif vers les résultats de la recherche qui affiche la vue souhaitée. Le fait de cliquer sur un lien de chemin de navigation conduit le client à une vue dans laquelle toutes les améliorations suivantes sont supprimées. D’autres options sont également disponibles.

<value>

Texte destiné aux clients pour l’élément de chemin de navigation.

Facettes

Les facettes sont des options de raffinement qui permettent aux clients de filtrer les résultats. Les facettes sont généralement utilisées pour la catégorisation, les plages de prix, les sélections de couleurs et d’autres ajustements d’attributs. Les métadonnées de l’index sont ce qui motive les facettes.

Il est courant de masquer ou d’afficher les facettes de catégorisation lorsqu’un client passe par la catégorisation. Le plus haut niveau de catégorisation (catégorie) est connu sous le nom de niveau 1. Lorsqu’un client clique sur une option de niveau 1, les options de raffinement de niveau 2 (sous-catégorie) s’affichent et les options de niveau 1 disparaissent. Lorsqu’un client clique sur une option de niveau 2, les options de raffinement de niveau 3 (sous-catégorie) s’affichent et les options de niveau 2 disparaissent. Comme nous l'avons mentionné plus haut, ces options sont masquées et affichées. Votre application Web n'est pas affectée par elles.

Chaque facette est contenue dans des balises <facet-item>. Dans l’exemple suivant, il présente une facette qui permet au client d’affiner les résultats de la recherche par "vacances".

Exemple :

 <facets> 
  <facet-item> 
   <facet-title><![CDATA[Holidays]]></facet-title> 
   <facet-value> 
    <label><![CDATA[New Year]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=New+Year;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[11]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Christmas]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Christmas;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[7]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Chinese New Year]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Chinese+New+Year;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[2]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Thanksgiving]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Thanksgiving;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[2]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[4th of July]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=4th+of+July;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Father&#39;s Day]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Father's+Day;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Hanukkah]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Hanukkah;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Mother&#39;s Day]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Mother's+Day;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Valentine&#39;s Day]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Valentine's+Day;x1=content-type;x2=holidays]]></link> 
    <count><![CDATA[1]]></count> 
   </facet-value> 
  </facet-item> 
  <facet-item> 
   <facet-title><![CDATA[Seasons]]></facet-title> 
   <facet-value> 
    <label><![CDATA[Winter]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Winter;x1=content-type;x2=seasons]]></link> 
    <count><![CDATA[20]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Summer]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Summer;x1=content-type;x2=seasons]]></link> 
    <count><![CDATA[7]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Autumn]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Autumn;x1=content-type;x2=seasons]]></link> 
    <count><![CDATA[4]]></count> 
   </facet-value> 
   <facet-value> 
    <label><![CDATA[Spring]]></label> 
    <link><![CDATA[?q=new+year;q1=Articles;q2=Spring;x1=content-type;x2=seasons]]></link> 
    <count><![CDATA[2]]></count> 
   </facet-value> 
  </facet-item>  
 </facets> 

Balises en facettes

Description

<facet-title>

Titre orienté client pour la facette.

<libellé>

Libellé destiné au client pour l’option de facette.

<link>

Lien relatif vers les résultats que l’option affine.

<count>

Nombre de résultats dans cet ensemble de résultats affiné.

<undolink>

Lorsqu’une valeur de facette est sélectionnée, le noeud renvoie un "lien d’annulation" qui permet à un client d’annuler les résultats.

En-tête et Requête

Exemple :

<?xml version="1.0" encoding="utf-8" standalone="yes" ?> 
<result> 
 <query> 
  <user-query><![CDATA[new year]]></user-query> 
  <lower-results><![CDATA[1]]></lower-results> 
  <upper-results><![CDATA[16]]></upper-results> 
  <total-results><![CDATA[621]]></total-results> 
 </query> 

Utilisées ensemble, ces balises présentent un message tel que ce qui suit : "Affichage des résultats 1 à 16 sur 621 pour la "nouvelle année"."

Balises dans l’en-tête et la Requête

Description

<user-query>

Requête de mots-clés envoyée avec la demande.

<lower-results>

Numéro de l'article du premier résultat sur cette page.

<upper-results>

Numéro de l'article du dernier résultat sur cette page.

<total-results>

Nombre total de résultats correspondant à la requête utilisateur.

<custom-field>

Champ facultatif qui s’applique globalement aux résultats de la recherche.

Pagination

Exemple :

<pagination> 
 <total-pages><39></total-pages> 
 <pages> 
   <page position="first"></page> 
   <page position="last">?i=1;page=39;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="previous"></page> 
   <page position="next">?i=1;page=2;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="1" selected="true">?i=1;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="2">?i=1;page=2;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="3">?i=1;page=3;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="4">?i=1;page=4;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="5">?i=1;page=5;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="6">?i=1;page=6;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="7">?i=1;page=7;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="8">?i=1;page=8;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="9">?i=1;page=9;q=new+year;q1=Articles;x1=content-type]]></page> 
   <page position="10">?i=1;page=10;q=new+year;q1=Articles;x1=content-type]]></page> 
 </pages> 
</pagination> 

Balises dans la pagination

Description

<total-pages>

Nombre total de pages de résultats, en fonction du nombre de résultats divisé par le nombre de résultats par page.

<page position="first">

Contient un lien relatif vers la première page du jeu de résultats, sauf si le client consulte déjà la page 1. Dans ce cas, il est vide.

<page position="last">

Contient un lien relatif vers la dernière page du jeu de résultats, sauf si le client consulte la dernière page. Dans ce cas, il est vide.

<page position="previous">

Contient un lien relatif vers la page précédente du jeu de résultats, sauf si le client consulte la page 1 ; dans ce cas, il est vide.

<page position="next">

Contient un lien relatif vers la dernière page du jeu de résultats, sauf si le client consulte la dernière page. Dans ce cas, il est vide.

<page position="x">

Contient un lien relatif vers un numéro de page particulier. Dix numéros de page contigus s’affichent. À la page 1, il s'agirait des pages 1 à 10. À la fin de l'ensemble de résultats (dans ce cas, 39), il s'agirait des pages 30 à 39. Par exemple, au centre du jeu de résultats, page 15, il s’agirait des pages 11 à 20.

selected="true">

Appliqué en tant qu’attribut à la page actuellement sélectionnée.

Recherches récentes

Les recherches récentes sont une fonctionnalité basée sur des cookies qui ne fonctionne que si vous transmettez les informations des cookies aux serveurs.

Exemple :

<recent-searches> 
 <recent-search> 
  <search-term><![CDATA[shoes]]></search-term> 
  <link><![CDATA[?q=shoes]]></link> 
 </recent-search> 
</recent-searches> 

Balises dans les recherches récentes

Description

<recent-search>

Noeud de recherche récente individuel. Vous pouvez avoir plusieurs noeuds de recherche récente.

<search-term>

Terme recherché précédemment par le client.

<link>

Liens vers la recherche précédente.

Résultats

Le jeu de résultats est une zone personnalisable de la réponse XML. Chaque index est unique dans les mécanismes de nommage des champs des métadonnées. Des champs communs sont renvoyés pour chaque résultat, tels que le titre, la description et l’URL. Cependant, toutes les métadonnées définies pour une page de l’index peuvent être disponibles pour être utilisées dans chaque noeud de résultats. La catégorisation, les prix, les couleurs et les vignettes ne sont que quelques-unes des options que vous pouvez appliquer à un résultat pour obtenir des résultats de recherche plus convaincants.

Le format Résultats est personnalisé en fonction des métadonnées propres à votre implémentation. Toutes les données par résultat à afficher dans les résultats, y compris les URL des images miniatures, sont contenues ici.

En outre, il est possible de configurer plusieurs zones de résultats dans la page, telles que "Résultats présentés", ou de séparer les sections "Produits" et "Contenu" des résultats. Dans ce cas, plusieurs zones de résultats sont fournies dans le code HTML, bien que les facettes ne soient associées qu’au jeu de résultats Principal.

Exemple :

 <results> 
  <result> 
    <index><![CDATA[1]]></index> 
    <result-title><![CDATA[New Year's Eve Slumber Party]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/new-years-eve-slumber-party-705199/]]></url> 
    <meta-description><![CDATA[Fun New Year's celebration ideas for your kids]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <small-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/new-years-eve-

slumber-party-parties-photo-80-FF1200SLEEPA18.jpg]]></small-thumbnail-img> 
    <large-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/new-years-eve- 
slumber-party-parties-photo-160-FF1200SLEEPA18.jpg]]></large-thumbnail-img> 
    <byline><![CDATA[Nancy Mades]]></byline> 
    <blurb><![CDATA[Fun New Year's celebration ideas for your kids]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[2]]></index> 
    <result-title><![CDATA[10 Holiday Traditions to Start This Year]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/10-holiday-traditions-to-start-this-year-704781/]]></url> 
    <meta-description><![CDATA[Reader ideas to make Thanksgiving, Christmas, and New Year's even more magical]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <small-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/10-holiday- 
traditions-to-start-this-year-parties-photo-80-FF1107HOLIA01.jpg]]></small-thumbnail-img> 
    <large-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/10-holiday- 
traditions-to-start-this-year-parties-photo-160-FF1107HOLIA01.jpg]]></large-thumbnail-img> 
    <byline><![CDATA[Julie Taylor]]></byline> 
    <blurb><![CDATA[Reader ideas to make Thanksgiving, Christmas, and New Year's even more magical]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[3]]></index> 
    <result-title><![CDATA[A Perfect New Year's Eve]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/a-perfect-new-years-eve-705258/]]></url> 
    <meta-description><![CDATA[You can turn New Year's into a celebration for the whole family.]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <byline><![CDATA[Teri Keough]]></byline> 
    <blurb><![CDATA[You can turn New Year's into a celebration for the whole family.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[4]]></index> 
    <result-title><![CDATA[New Year's Fun and Games]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/new-years-fun-and-games-705220/]]></url> 
    <meta-description><![CDATA[Craft, game and food ideas for a New Year's celebration with kids.]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <byline><![CDATA[Charlotte Meryman]]></byline> 
    <blurb><![CDATA[Craft, game and food ideas for a New Year's celebration with kids.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[5]]></index> 
    <result-title><![CDATA[11 Great Ways to Start the New Year]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/11-great-ways-to-start-the-new-year-705552/]]></url> 
    <meta-description><![CDATA[11 New Family Traditions to Start This Year from My Magazine]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <byline><![CDATA[Emily Block]]></byline> 
    <blurb><![CDATA[11 New Family Traditions to Start This Year from My Magazine]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[6]]></index> 
    <result-title><![CDATA[Celebrating Chinese New Year]]></result-title> 
    <url><![CDATA[https://mysite.com/parties/celebrating-chinese-new-year-705260/]]></url> 
    <meta-description><![CDATA[Crafts, food, and games to help you celebrate Chinese New Year.]]></meta-description> 
    <category><![CDATA[parties]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Crafts, food, and games to help you celebrate Chinese New Year.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[7]]></index> 
    <result-title><![CDATA[New Year's Eve, Family Style]]></result-title> 
    <url><![CDATA[https://mysite.com/holidays/new-years-eve-family-style-701283/]]></url> 
    <meta-description><![CDATA[Start a family New Year's Eve tradition by having an evening of kid-focused fun at home]]></meta-description> 
    <category><![CDATA[holidays]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Start a family New Year's Eve tradition by having an evening of kid-focused fun at home]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[8]]></index> 
    <result-title><![CDATA[Chinese New Year Activities]]></result-title> 
    <url><![CDATA[https://mysite.com/crafts/chinese-new-year-activities-710345/]]></url> 
    <meta-description><![CDATA[Activities for celebrating Chinese New Year.]]></meta-description> 
    <category><![CDATA[crafts]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Activities for celebrating Chinese New Year.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[9]]></index> 
    <result-title><![CDATA[More Organized in the New Year]]></result-title> 
    <url><![CDATA[https://mysite.com/holidays/more-organized-in-the-new-year-701284/]]></url> 
    <meta-description><![CDATA[Tips for getting your household more organized--and getting the kids to help.]]></meta-description> 
    <category><![CDATA[holidays]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Tips for getting your household more organized--and getting your kids to help out.]]></blurb> 
  </result>   
  <result> 
    <index><![CDATA[10]]></index> 
    <result-title><![CDATA[Checklists: Year-End Safety Checklist]]></result-title> 
    <url><![CDATA[https://mysite.com/holidays/checklists-year-end-safety-checklist-701352/]]></url> 
    <meta-description><![CDATA[Make sure that your home is safe with our year-end safety checklist!]]></meta-description> 
    <category><![CDATA[holidays]]></category> 
    <content-type><![CDATA[Articles]]></content-type> 
    <blurb><![CDATA[Make sure that your home is safe with our year-end safety checklist!]]></blurb> 
  </result>   
 </results> 
</customer-result> 

Balises dans les résultats

Description

<index>

Numéro de série du résultat dans ce jeu de résultats. Dans cet exemple, où dix résultats sont affichés par page, à la page 2 des résultats, le premier élément aurait un index de 11.

<result-title>

Titre destiné aux clients pour cette page.

<url>

URL de cette page. Il est utilisé pour créer un hyperlien qui permet au client de cliquer sur les résultats.

Formulaire de recherche

Exemple :

<search-form> 
 <include-tnt-mbox>1 </included-tnt-mbox> 
 <autocomplete> 
  <css><![CDATA[<!--link rel="stylesheet" type="te 
        xt/css"href="//content.atomz.com/sp000000a8/publish/autoc 
        omplete_styles.css?sp_css_cache_ver=2" /-->]]> 
  </css> 
  <form-content><![CDATA[<div id="autocomplete"></div>]]> 
  </form-content> 
  <js><![CDATA[<script type="text/javascript" 
   src="//content.atomz.com/sp100491de/publish/autoc 
   omplete_data.js?sp_js_cache_ver=3"></script>]]> 
  </js> 
 </autcomplete> 
 <hidden-parameters> 
  <parameter> 
   <name><![CDATA[store]]></name> 
   <value><![CDATA[mens]]></value> 
  </parameter> 
 </hidden-parameters> 
</search-form>

Balises dans le formulaire de recherche

Description

<include-tnt-mbox>

Facultatif. Lorsqu’elle est présente dans le code XML, la valeur 1 indique que votre compte est lié à Test&Cible et qu’il comporte au moins une règle métier qui fait partie d’un test A:B.

<autocomplete>

Facultatif. Lors de l’utilisation de la saisie semi-automatique, ce noeud est présent pour indiquer que le code CSS et JavaScript est présent sur la page, ainsi que le contenu du formulaire. En règle générale, ces champs ne changent pas, sauf si un utilisateur a modifié un paramètre de saisie semi-automatique. Dans ce cas, le champ xxx_cache_ver est incrémenté pour forcer l’invalidation du contenu mis en cache dans le navigateur de votre client.

<css>

CSS associé à la saisie semi-automatique. Il est recommandé de placer cette balise en haut de la page pour améliorer le rendu des pages.

<form-content>

Contenu requis dans votre recherche depuis l'utilitaire de saisie automatique pour se connecter au contrôle approprié.

<js>

JavaScript personnalisé requis pour la saisie semi-automatique. Il est recommandé de placer cette balise en bas de la page pour améliorer le rendu des pages. Le code JavaScript YUI est également requis pour la saisie automatique.

<hidden-parameters>

Contient tous les paramètres masqués (nom et valeur) à inclure dans le formulaire de recherche.

Tri

L'exemple suivant montre les données d'un menu de tri à trois options. Le menu permet au client de trier par pertinence, titre ou classement. L’élément actuellement sélectionné comprend un attribut "selected=true". ". Toujours offre une option de pertinence pour permettre à un client de revenir aux résultats de recherche par défaut qui étaient initialement affichés.

Exemple :

 <sort> 
  <sort-item selected="true"> 
   <label><![CDATA[Relevance]]></label> 
   <value><![CDATA[relevance]]></value> 
   <link><![CDATA[]]></link> 
  </sort-item> 
  <sort-item> 
   <label><![CDATA[Title]]></label> 
   <value><![CDATA[title]]></value> 
   <link><![CDATA[?q=new+year;q1=Articles;sort=title;x1=content-type]]></link>     
  </sort-item> 
  <sort-item> 
   <label><![CDATA[Rating]]></label> 
   <value><![CDATA[user-rating]]></value> 
   <link><![CDATA[?q=new+year;q1=Articles;sort=user-rating;x1=content-type]]></link>     
  </sort-item> 
 </sort>

Balises dans le menu Trier

Description

<libellé>

Texte de l’option destiné aux clients.

<value>

Représente la valeur du paramètre de chaîne de requête "sort" pour cette option. Cette balise n’est pas nécessaire si la valeur <link> est utilisée.

<link>

Pour les options non sélectionnées, le paramètre <link> contient le lien relatif qui renvoie le même jeu de résultats, trié par le nouveau paramètre de tri. Ce champ est vide pour l’option de tri actuellement sélectionnée.

Suggestions

Les suggestions sont renvoyées lorsqu’il n’y a que quelques résultats ou qu’aucun résultat n’est obtenu. Ce noeud contient des termes qui génèrent des requêtes réussies et peut être affiché sur une page "Aucun résultat". Le lien est également renvoyé afin qu’un client puisse accéder à la nouvelle requête.

Exemple :

 <suggestions> 
  <suggestion-item> 
   <link><![CDATA[?q=video]]></link> 
   <word><![CDATA[video]]> 

Balises dans les suggestions

Description

<link>

Lien relatif utilisé pour créer un hyperlien permettant de rechercher les résultats du terme de suggestion.

<word>

Terme suggéré.

Zones

Exemple :

<zones> 
 <zone> 
  <name><![CDATA[best-sellers]]></name> 
  <display><![CDATA[1]]></display> 
 </zone> 
</zones> 

Balises en zones

Description

<zone>

Noeud de zone individuel. Vous pouvez avoir plusieurs noeuds de zone.

<name>

Nom de la zone.

<display>

1 ou 0 pour indiquer si la zone est affichée ou non. Le contenu de la zone peut être statique sur votre page Web ou dans les résultats de la recherche, par exemple les meilleurs vendeurs ou les produits associés.

Sortie XML de recherche guidée pour Adobe Experience Manager

Tableaux décrivant la sortie de réponse XML standard pour AEM (Adobe Experience Manager).

Voir également . Sortie XML de recherche guidée

Vous pouvez consulter la réponse XML pour les éléments suivants :

Bannières

La recherche sur site/le marchandisage peut gérer les bannières d’un client, en branchant les bannières en plusieurs parties sur une page Web.

Exemple de bannière :

Voici un exemple de bannière placée dans la zone des pages appelée "haut".

   <banners> 
       <banner> 
           <area><![CDATA[top]]></area> 
           <content><![CDATA[<div style="color:#70A100">We have custom shipping</div>]]></content> 
       </banner> 
    </banners> 

Noeud

Noeud parent

Description

bannières

client-results

Contient des noeuds de bannière 0-n indiquant chaque zone de bannière et le contenu connecté à cette zone.

bannière

bannières

Noeud de bannière individuel. Vous pouvez avoir plusieurs noeuds de bannière.

area

bannière

Zone de la page Web dans laquelle la bannière est affichée.

content

bannière

Contenu de la bannière.

Chemin de navigation

Plusieurs chemins de navigation sont pris en charge. Vous pouvez définir des chemins de navigation et leur comportement correspondant dans Design > Navigation > Breadcrumbs. En outre, vous devez attribuer un nom unique pour chaque chemin de navigation que vous définissez. Le noeud XML des chemins de navigation effectue une itération sur tous les chemins de navigation définis. Il est recommandé de n'afficher qu'un seul chemin de navigation dans les résultats de la recherche.

Dans l’exemple suivant, chaque fois que le client se rétrécit davantage à travers les facettes, la sélection est ajoutée à la barre de navigation. Chaque élément est représenté sous la forme <breadcrumb-item>.

Exemple de noeud de chemin de navigation :

    <breadcrumbs> 
  <breadcrumb> 
            <name><![CDATA[default]]></name> 
     <breadcrumb-item> 
   <link><![CDATA[?i=1;q=mens;sp_cs=UTF-8;view=xml]]></link> 
   <value><![CDATA[mens]]></value> 
                <label><![CDATA[]]></label> 
      </breadcrumb-item> 
     <breadcrumb-item> 
   <link><![CDATA[?i=1;q=mens;q1=Channel;sp_cs=UTF-8;view=xml;x1=brand]]></link> 
   <value><![CDATA[Channel]]></value> 
                <label><![CDATA[brand]]></label> 
      </breadcrumb-item> 
   </breadcrumb> 
    </breadcrumbs> 

Noeud

Noeud parent

Description

fil d'Ariane

client-results

Contient des noeuds de chemin de navigation 0-n qui définissent chaque chemin de navigation. La plupart des clients n'ont qu'un seul chemin de navigation.

fil d'Ariane

fil d'Ariane

Contient les noeuds enfants définissant la définition d’un chemin de navigation.

name

fil d'Ariane

Nom du chemin de navigation.

breadcrumb-item

Élément individuel dans le chemin de navigation. Chaque élément indique une étape de la piste lorsque l’utilisateur affine l’ensemble de résultats.

link

breadcrumb-item

Lien relatif vers les résultats de la recherche qui affiche la vue souhaitée. Le fait de cliquer sur un lien de chemin de navigation conduit le client à une vue dans laquelle toutes les améliorations suivantes sont supprimées. D’autres options sont également disponibles, telles que déposer et supprimer.

value

breadcrumb-item

Texte destiné aux clients pour l’élément de chemin de navigation.

libellé

breadcrumb-item

La balise d’étiquette génère un libellé pour une valeur de chemin de navigation qui détaille la facette sélectionnée pour générer cet élément de chemin de navigation. Il n'est utilisé que dans le contexte d'un bloc de chemin de fer guidé. Pour l’étape de requête terme, ce champ est vide.

Champs personnalisés

Les champs personnalisés sont une collection diverse de variables avec un contexte global. Il est généralement utilisé pour transmettre des variables à des fins d’optimisation du référencement définies dans les métadonnées de la page des résultats de la recherche.

Exemple de noeud de champs personnalisés :

    <custom-fields> 
        <custom-field name="seo-search-title"><![CDATA[Geometrixx Search Results]]></custom-field> 
        <custom-field name="seo-search-keywords"><![CDATA[]]></custom-field> 
    </custom-fields> 

Noeud

Noeud parent

Description

champs personnalisés

client-results

Peut contenir des noeuds enfants 0-n qui définissent des champs personnalisés.

champ personnalisé

champs personnalisés

Facultatif. Contient une valeur pour un champ personnalisé donné indiqué par l’attribut name.

Facettes

Les facettes sont des options de raffinement qui permettent aux clients de filtrer les résultats. Les facettes sont généralement utilisées pour la catégorisation, les plages de prix, les sélections de couleurs et d’autres ajustements d’attributs. Les facettes sont construites sur les métadonnées de l’index.

Il est courant de masquer ou d’afficher les facettes de catégorisation lorsqu’un client passe par la catégorisation. Le plus haut niveau de catégorisation (catégorie) est connu sous le nom de niveau 1. Lorsqu’un client clique sur une option de niveau 1, les options de raffinement de niveau 2 (sous-catégorie) s’affichent et les options de niveau 1 disparaissent. Lorsqu’un client clique sur une option de niveau 2, les options de raffinement de niveau 3 (sous-catégorie) s’affichent et les options de niveau 2 disparaissent. Comme indiqué ci-dessus, ces options sont masquées et affichées ; votre application web ne les affecte pas.

Chaque facette est contenue dans des balises <facet-item>. Dans l’exemple suivant, il présente une facette qui permet au client d’affiner les résultats de recherche par "vacances".

Exemple de bloc de facettes :

<facets>          
     <facet> 
         <facet-title><![CDATA[Department]]></facet-title> 
                <behavior><![CDATA[sticky]]></behavior> 
                <selected>1</selected> 
                <undo-link><![CDATA[?i=1;lang=enus;q=*;q1=Armora+Jeans;sp_staged=1;view=xml;x1=brand]]></undo-link> 
      <facet-value> 
          <selected><![CDATA[true]]></selected> 
              <label><![CDATA[Mens]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Armora+Jeans;q2=Mens;sp_staged=1;view=xml;x1=brand;x2=leveli]]></link> 
       <count><![CDATA[3]]></count> 
                        <undolink><![CDATA[?i=1;lang=enus;q=*;q1=Armora+Jeans;sp_staged=1;view=xml;x1=brand]]></undolink> 
      </facet-value> 
      </facet> 
     <facet> 
         <facet-title><![CDATA[Sub-Category]]></facet-title> 
                <behavior><![CDATA[sticky]]></behavior> 
                <selected>0</selected> 
      <facet-value>           
              <label><![CDATA[Apparel]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans;q3=Apparel;sp_staged=1;view=xml;x1=leveli;x2=brand;x3=levelii]]></link> 
       <count><![CDATA[3]]></count>                         
      </facet-value>   
      </facet>         
     <facet> 
         <facet-title><![CDATA[Brand]]></facet-title> 
                <behavior><![CDATA[multi-select]]></behavior> 
                <selected>1</selected> 
                <undo-link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;sp_staged=1;view=xml;x1=leveli]]></undo-link> 
      <facet-value>        
              <label><![CDATA[Amoura]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Amoura;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link> 
       <count><![CDATA[9]]></count>                         
      </facet-value>   
      <facet-value>         
              <label><![CDATA[Armora]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Armora;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link> 
       <count><![CDATA[12]]></count>                        
      </facet-value>   
      <facet-value> 
          <selected><![CDATA[true]]></selected> 
              <label><![CDATA[Armora Jeans]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Armora+Jeans;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link> 
 
       <count><![CDATA[3]]></count> 
                        <undolink><![CDATA[?i=1;lang=enus;q=*;q1=Mens;sp_staged=1;view=xml;x1=leveli]]></undolink> 
      </facet-value>   
      <facet-value>           
              <label><![CDATA[Art of Grooming]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Art+of+Grooming;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link> 
       <count><![CDATA[4]]></count>                         
      </facet-value>   
      <facet-value>          
              <label><![CDATA[Bear Co.]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Bear+Co.;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link> 
       <count><![CDATA[1]]></count> 
      </facet-value> 
      <facet-value>      
              <label><![CDATA[Citizens]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Citizens;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link> 
       <count><![CDATA[4]]></count> 
      </facet-value> 
      <facet-value> 
              <label><![CDATA[D&amp;B]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|D%26B;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link> 
       <count><![CDATA[17]]></count> 
      </facet-value> 
      <facet-value> 
              <label><![CDATA[David Yuri]]></label> 
       <link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|David+Yuri;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link> 
       <count><![CDATA[2]]></count>    
      </facet-value>   
      </facet> 
    </facets> 

Noeud

Noeud parent

Description

facettes

client-results

Noeud de facettes de conteneur contenant des noeuds enfants 0-n représentant chaque facette.

facette

facettes

Une instance de facette unique.

facette-titre

facette

Titre orienté client pour la facette.

comportement

facette

Comportement de la facette. Par exemple, normal, bascule ou à sélection multiple.

sélectionnés

facette

1 si la facette a une valeur sélectionnée sinon 0.

undo-link

facette

Uniquement présente lorsque la facette est sélectionnée. Annuler le lien inverse la facette entière. Par exemple, s’il s’agit d’une facette à sélection multiple, elle désélectionne toutes les options sélectionnées pour la facette.

facet-value

facette

Contient tous les éléments de facette individuels appartenant à la facette.

sélectionnés

facet-value

Si l’élément actif avec la facette est sélectionné, ce noeud est présent et défini sur "true".

libellé

facet-value

Libellé destiné au client pour l’option de facette. Par défaut, cette option doit déjà être précédée d’une séquence d’échappement HTML.

link

facet-value

Lien relatif aux résultats que l’option affine davantage.

count

facet-value

Nombre de résultats dans cet ensemble de résultats affiné.

undo-link

facet-value

Lorsqu’une valeur de facette est sélectionnée, le noeud renvoie un "lien d’annulation" qui permet au client d’annuler la sélection de cette facette individuelle.

En-tête

Exemple :

xml version="1.0" encoding="utf-8" standalone="yes" 

Menus et tri

Les menus permettant de trier les résultats sont pris en charge et de modifier le nombre de résultats à renvoyer par page. Il prend également en charge un menu de navigation utile pour l’utilisation de la fonction "recherche en tant que navigation". Un compte peut définir plusieurs menus du même type et utiliser n'importe lequel des menus pour leur présentation.

Exemple de noeud de menus :

L'exemple suivant montre les données d'un menu de tri et d'un menu de navigation à trois options. Le menu de tri permet au client de trier par pertinence, titre ou classement. L’élément actuellement sélectionné comprend un attribut "selected=true". ". Toujours offre une option de pertinence pour permettre à un client de revenir aux résultats de recherche par défaut qui étaient initialement affichés.

<menus> 
        <menu> 
           <name><![CDATA[sort]]></name>         
             <item selected="true"> 
          <label><![CDATA[Relevance]]></label> 
          <value><![CDATA[relevance]]></value> 
          <link><![CDATA[ ]]></link> 
             </item> 
             <item> 
          <label><![CDATA[Lowest Price]]></label> 
          <value><![CDATA[Price]]></value> 
          <link><![CDATA[?i=1;q=mens;sort=Price;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>     
             </item> 
             <item> 
          <label><![CDATA[Highest Price]]></label> 
          <value><![CDATA[Price_r]]></value> 
          <link><![CDATA[?i=1;q=mens;sort=Price_r;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>     
             </item> 
             <item> 
          <label><![CDATA[Brand]]></label> 
          <value><![CDATA[brand]]></value> 
          <link><![CDATA[?i=1;q=mens;sort=brand;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>     
             </item> 
        </menu> 
        <menu> 
            <name><![CDATA[ss_head_nav]]></name>   
                    <item> 
                        <label><![CDATA[WOMEN'S]]></label> 
          <value><![CDATA[?q1=Womens;sp_sfvl_field=levelii|leveli|brand|leveliii;x=0;x1=leveli;y=0;view=nav;top=1]]></value> 
          <link><![CDATA[?q1=Womens;sp_sfvl_field=levelii|leveli|brand|leveliii;x=0;x1=leveli;y=0;view=nav;top=1;i=1;m_ss_head_nav=WOMEN'S]]></link> 
                    </item> 
                    <item> 
                        <label><![CDATA[MEN'S]]></label> 
          <value><![CDATA[/q1/Mens/x1/leveli/view/nav/top/1/]]></value> 
          <link><![CDATA[/q1/Mens/x1/leveli/view/nav/top/1/]]></link> 
                    </item> 
                    <item> 
                        <label><![CDATA[JEWELRY & ACCESSORIES]]></label> 
          <value><![CDATA[?q1=Jewelry+%26+Accessories&sp_sfvl_field=levelii|leveli|brand|leveliii&x1=leveli&view=nav&top=1]]></value> 
          <link><![CDATA[?q1=Jewelry+%26+Accessories&sp_sfvl_field=levelii|leveli|brand|leveliii&x1=leveli&view=nav&top=1;i=1;m_ss_head_nav=JEWELRY+%26+ACCESSORIES]]></link> 
                    </item> 
                    <item> 
                        <label><![CDATA[BEAUTY & FRAGRANCE]]></label> 
          <value><![CDATA[?q1=Beauty+%26+Fragrance;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value> 
          <link><![CDATA[?q1=Beauty+%26+Fragrance;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=BEAUTY+%26+FRAGRANCE]]></link> 
                    </item> 
                    <item> 
                        <label><![CDATA[GIFTS & HOME]]></label> 
          <value><![CDATA[?q1=Gifts+%26+Home;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value> 
          <link><![CDATA[?q1=Gifts+%26+Home;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=GIFTS+%26+HOME]]></link> 
                    </item> 
                    <item> 
                        <label><![CDATA[CHILDREN & TOYS]]></label> 
          <value><![CDATA[?q1=Children+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value> 
          <link><![CDATA[?q1=Children+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=CHILDREN+%26+TOYS]]></link> 
                    </item> 
                    <item> 
                        <label><![CDATA[ELECTRONICS]]></label> 
          <value><![CDATA[?q1=Electronics+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value> 
          <link><![CDATA[?q1=Electronics+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=ELECTRONICS]]></link> 
                    </item> 
        </menu> 
    </menus> 

Noeud

Noeud parent

Description

menus

client-results

Contient des noeuds enfants 0-n définissant chaque menu.

menu

menus

Instance unique d'un menu (correspond à un menu défini dans Conception > Navigation > Menus ).

name

menu

Nom du menu.

élément

menu

Définit chaque élément du menu. L'attribut facultatif sélectionné est défini sur true si l'élément de menu donné est actuellement sélectionné.

libellé

élément

Texte orienté client de l’élément de menu.

value

élément

Représente la valeur de l'élément de menu (la valeur du paramètre de requête définie pour le menu). Cette balise n’est pas nécessaire si la valeur <link> est utilisée.

link

élément

Pour les options non sélectionnées, le paramètre <link> contient le lien relatif qui renvoie le même jeu de résultats, mais avec l'option de menu appliquée. Ce champ est vide pour l’option de tri actuellement sélectionnée.

Pagination

Les jeux de résultats sont répartis sur plusieurs pages. En règle générale, les clients affichent 10 à 20 résultats sur une seule page. Les résultats suivants s’affichent sur la page suivante. Le code XML de pagination vous permet de créer un ensemble de liens de navigation afin que vos clients puissent parcourir les jeux de résultats page par page. Il existe quatre liens de navigation disponibles : premier, dernier, suivant et précédent. Chaque type de lien permet aux clients de parcourir rapidement les pages afin de pouvoir examiner et affiner facilement ce qu'ils recherchent.

L'exemple suivant montre la pagination d'une recherche qui se trouve sur la première page et dont la pagination est configurée pour afficher les liens renvoyant à cinq pages.

Exemple de pagination :

    <pagination> 
        <total-pages><![CDATA[112]]></total-pages> 
        <pages> 
     <page position="first"><![CDATA[]]></page> 
     <page position="last"><![CDATA[?i=1;page=112;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page> 
     <page position="next"><![CDATA[?i=1;page=2;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page> 
            <page position="1" selected="true"><![CDATA[?i=1;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page> 
            <page position="2"><![CDATA[?i=1;page=2;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page> 
            <page position="3"><![CDATA[?i=1;page=3;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page> 
            <page position="4"><![CDATA[?i=1;page=4;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page> 
            <page position="5"><![CDATA[?i=1;page=5;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page> 
        </pages> 
    </pagination> 

Noeud

Noeud parent

Description

pagination

client-results

Nombre total de pages de résultats, en fonction du nombre de résultats divisé par le nombre de résultats par page.

nombre total de pages

pagination

Nombre total de pages sur lesquelles les résultats de la recherche sont répartis.

pages spécifiques

pagination

Contient des noeuds de page 0 n définissant chaque page de la pagination.

page

pages spécifiques

Il existe quatre noeuds de page spéciaux : premièrement, dernier, précédent et suivant. Ces quatre pages sont facultatives et apparaissent dans le jeu de résultats uniquement si elles ont du sens. Par exemple, si vous êtes à la page 1, il n’existe aucun lien "précédent". Toutes les autres pages indiquent une position. Le nombre de pages répertoriées dépend du "nombre de liens vers les pages" configuré dans l’interface utilisateur de pagination. L’attribut "sélectionné" indique la page sur laquelle se trouve actuellement le client.

Requête

Exemple de noeud de requête :

    <query> 
        <user-query><![CDATA[mens]]></user-query> 
 <lower-results><![CDATA[1]]></lower-results> 
 <upper-results><![CDATA[12]]></upper-results> 
 <total-results><![CDATA[265]]></total-results> 
    </query> 

Noeud

Noeud parent

Description

query

client-results

Noeud global qui fournit un aperçu de la requête.

requête utilisateur

requête

Mot-clé recherché. Si Voulez-vous dire a automatiquement recherché un terme suggéré en raison du terme d'origine qui n'a donné aucun résultat, il est reflété dans le nouveau mot-clé recherché (voir le noeud suggestions pour obtenir le mot-clé d'origine).

résultats inférieurs

requête

Numéro de l'article du premier résultat sur cette page.

résultats supérieurs

requête

Numéro de l'article du dernier résultat sur cette page.

total-results

requête

Nombre total de résultats correspondant à la requête utilisateur.

Recherches récentes

Les recherches récentes sont une fonctionnalité basée sur des cookies qui ne fonctionne que si vous transmettez les informations des cookies aux serveurs de recherche/marchandisage de site.

Exemple de recherches récentes :

    <recent-searches> 
        <clear-link><![?q=womens&gscr=clear]]></clear-link> 
        <recent-search> 
            <link><![?q=mens]]></link> 
            <label><![CDATA[mens]]></label> 
        <recent-search> 
    </recent-searches> 

Noeud

Noeud parent

Description

Recherches récentes

client-results

Le noeud n’est présent que si la recherche comporte des recherches récentes.

lien clair

Recherches récentes

Chemin relatif qui efface toutes les recherches récentes du client.

recherche récente

Recherches récentes

Définit les recherches récentes.

link

recherche récente

Chemin d’accès permettant de créer un lien qui effectue une recherche récemment effectuée par l’utilisateur.

libellé

recherche récente

Libellé d’affichage destiné au client pour la recherche récente.

Résultats

Le jeu de résultats est une zone personnalisable de la réponse XML. Chaque index est unique dans les mécanismes de nommage des champs des métadonnées. Des champs communs sont renvoyés pour chaque résultat, tels que le titre, la description et l’URL. Cependant, toutes les métadonnées définies pour une page de l’index peuvent être disponibles pour être utilisées dans chaque noeud de résultats. La catégorisation, les prix, les couleurs et les vignettes ne sont que quelques-unes des options que vous pouvez appliquer à un résultat pour obtenir des résultats de recherche plus convaincants.

Le format des résultats est personnalisé en fonction des métadonnées propres à votre implémentation. Toutes les données par résultat à afficher dans les résultats, y compris les URL des images miniatures, sont contenues ici.

En outre, il est possible de configurer plusieurs zones de résultats dans la page, telles que "Résultats présentés", ou de séparer les sections "Produits" et "Contenu" des résultats. Dans ce cas, plusieurs zones de résultats sont fournies dans le code HTML, bien que les facettes ne soient associées qu’au jeu de résultats Principal.

Exemple de noeud de résultats :

    <results> 
        <result-set> 
            <name><![CDATA[default]]></name> 
         <result> 
                    <field name="index"><![CDATA[1]]></field> 
                    <field name="sku"><![CDATA[200190]]></field> 
                    <field name="pagename"><![CDATA[Relaxed Paint Splattered]]></field> 
 
                    <field name="img_sm_url"><![CDATA[https://geometrixx.com/images/08_geometrixx_icon_men.jpg]]></field> 
      <field name="brand"><![CDATA[Armora Jeans]]></field> 
      <field name="price"><![CDATA[195]]></field> 
      <field name="foundIn"><![CDATA[Mens,  
            Apparel,  
          Denim]]></field> 
         </result>   
         <result> 
                    <field name="index"><![CDATA[2]]></field> 
                    <field name="sku"><![CDATA[200195]]></field> 
                    <field name="pagename"><![CDATA[Tumbled Jeans]]></field> 
 
                    <field name="img_sm_url"><![CDATA[https://geometrixx.com/images/08_geometrixx_icon_men.jpg]]></field> 
      <field name="brand"><![CDATA[Armora Jeans]]></field> 
      <field name="price"><![CDATA[235]]></field> 
      <field name="foundIn"><![CDATA[Mens,  
            Apparel,  
          Denim]]></field> 
         </result>    
         <result> 
                    <field name="index"><![CDATA[3]]></field> 
                    <field name="sku"><![CDATA[200196]]></field> 
                    <field name="pagename"><![CDATA[Montana Relaxed]]></field> 
 
                    <field name="img_sm_url"><![CDATA[https://geometrixx.com/images/08_geometrixx_icon_men.jpg]]></field> 
      <field name="brand"><![CDATA[Armora Jeans]]></field> 
      <field name="price"><![CDATA[220]]></field> 
      <field name="foundIn"><![CDATA[Mens,  
            Apparel,  
          Denim]]></field> 
         </result>         
        </result-set>   
    </results> 

Noeud

Noeud parent

Description

résultats

client-results

Noeud de conteneur pour les jeux de résultats 0-n. Les jeux de résultats zéro signifient que vous êtes sur un landing page spécial sans résultat.

jeu de résultats

résultats

Une recherche entrante peut déclencher plusieurs recherches. Chaque jeu de résultats contient les résultats d’une recherche nommée spécifique qui a été effectuée.

name

jeu de résultats

Nom de la recherche à laquelle appartient le jeu de résultats.

résultat

jeu de résultats

Contient tous les champs associés à un résultat individuel pour le jeu de résultats.

field

résultat

L’attribut name définit le nom du champ de l’index affiché. La valeur est la valeur réelle de ce champ. Certains résultats peuvent comporter des champs manquants qui ne sont pas pertinents pour ce résultat individuel.

Formulaire de recherche

Le formulaire de recherche est inclus dans le jeu de résultats pour permettre aux clients de créer leur formulaire de recherche de manière dynamique. Cette étape est facultative. La plupart des clients ont un formulaire de recherche fixe. Cependant, il permet aux clients de déterminer si le formulaire de recherche a besoin d’une mbox Test&Cible, en fonction d’au moins une règle de fonctionnement qui effectue un test A:B. De même, il permet aux clients de récupérer automatiquement la dernière saisie automatique de CSS et de JavaScript.

Exemple de formulaire de recherche XML :

    <search-form> 
        <include-tnt-mbox>1</include-tnt-mbox> 
        <autocomplete> 
            <enabled>1</enabled> 
            <css><![CDATA[<link rel="stylesheet" type="text/css" href="https://content.t1.atomz.com/sp10043554/stage/autocomplete_styles.css?sp_js_param=2" /> 
]]></css> 
 
            <form-content><![CDATA[<div id="autocomplete"></div> 
<input type="hidden" name="sp_staged" id="sp_staged" value="1" /> 
]]></form-content> 
            <javascript><![CDATA[<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/utilities/utilities.js"></script> 
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/datasource/datasource-min.js"></script> 
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/autocomplete/autocomplete-min.js"></script> 
<script type="text/javascript" src="https://content.t1.atomz.com/sp10043554/stage/autocomplete_data.js?sp_js_param=3"></script>]]></javascript> 
        </autocomplete> 
    </search-form> 

Noeud

Noeud parent

Description

search-form

client-results

Contient les données permettant de générer le formulaire de recherche.

include-tnt-mbox

search-form

Techniquement, vous n’avez besoin d’une mbox dans le formulaire de recherche que si au moins une règle métier effectue un test Test&Cible A:B. Ce noeud indique si vous avez besoin d’une mbox ou si vous ne pouvez pas réduire le nombre d’accès sur les serveurs Test&Cible.

saisie automatique

search-form

Met en place le noeud enfant associé à la saisie semi-automatique.

enabled

saisie automatique

Définissez cette valeur sur 1 lorsque le compte de recherche utilise la saisie semi-automatique.

css

saisie automatique

CSS pour la saisie automatique. Placez ce noeud aussi haut que possible sur la page.

form-content

saisie automatique

Contenu injecté dans le formulaire de recherche.

javascript

saisie automatique

JavaScript pour la saisie automatique. Placez ce noeud aussi bas que possible sur la page.

Suggestions

Les clients peuvent configurer la fonctionnalité Did You Mean de trois manières : faites des suggestions en raison de l'absence de résultats, recherchez automatiquement la première suggestion lorsque nous n'avons pas de résultats, ou faites des suggestions en raison de résultats faibles (lorsque les suggestions ont un nombre de résultats plus élevé). Toutes les suggestions donnent des résultats.

Ce noeud de suggestions contient les termes qui génèrent des requêtes réussies. Le lien est également renvoyé afin qu’un client puisse accéder à la nouvelle requête.

Exemple de résultat pour une suggestion en raison de 0 résultat :

    <suggestions> 
        <auto-searched>0</auto-searched> 
        <suggestions-low-results>0</suggestions-low-results> 
 <suggestion-item> 
     <link><![CDATA[?i=1;q=arcade;sp_cs=UTF-8;view=xml]]></link> 
     <word><![CDATA[arcade]]></word> 
 </suggestion-item>    
    </suggestions>

Exemple de sortie pour une recherche automatique par rapport à une suggestion :

    <suggestions> 
        <auto-searched>1</auto-searched> 
        <orig-query><![CDATA[arcace]]></orig-query> 
        <suggestions-low-results>0</suggestions-low-results>         
    </suggestions> 

Exemple de résultat pour une suggestion en raison de résultats faibles :

   <suggestions> 
        <auto-searched>0</auto-searched> 
        <suggestions-low-results>1</suggestions-low-results> 
 <suggestion-item> 
     <link><![CDATA[?i=1;q=coffee;sp_cs=UTF-8;view=xml]]></link> 
     <word><![CDATA[coffee]]></word> 
 </suggestion-item>  
    </suggestions> 

Noeud

Noeud parent

Description

suggestion

client-results

Contient des noeuds enfants qui définissent la suggestion, le cas échéant.

recherche automatique

suggestions

S’il est présent, indique si la recherche/marchandisage sur le site a automatiquement effectué une recherche sur un nouveau terme en raison de l’absence de résultats.

orig-requête

suggestions

Lorsque la recherche/marchandisage sur le site effectue automatiquement des recherches par rapport à la première suggestion, la requête utilisateur dans le noeud de requête affiche le mot-clé recherché. Ce noeud affiche le terme de requête d’origine. La combinaison des deux permet aux clients de créer des structures telles que "Recherche d’arcade au lieu d’arcade".

suggestions-résultats faibles

suggestions

S’il est présent, indique si la recherche/le marchandisage du site fait des suggestions en raison du terme de recherche actuel produisant de faibles résultats et une suggestion produisant des résultats considérablement plus élevés. Les deux seuils sont configurables dans Voulez-vous dire .

suggestion-élément

suggestions

Contient des noeuds 0-n indiquant les différentes suggestions.

link

suggestion-élément

Contient le chemin de création d’un lien vers le terme suggéré.

word

suggestion-élément

Contient le mot suggéré.

Modèle

La possibilité de changer une expérience de recherche de clients en fonction des résultats est prise en charge. Cela implique en partie de basculer entre différents modèles avec une disposition différente des résultats de recherche. Par exemple, vous pouvez avoir un modèle avec une grille de vue de produits pour quand vous avez beaucoup de produits. Vous pouvez également utiliser un modèle de "projecteur" lors de l’affichage d’un seul résultat contenant plus de détails. Vous pouvez également avoir un modèle "aucun résultat" lorsqu’une recherche ne donne aucun résultat. Le noeud de modèle indique quel modèle est utilisé pour afficher les résultats de la recherche.

Exemple de modèle :

<template><![CDATA[grid]]></template>

Noeud

Noeud parent

Description

le modèle

client-results

Indique le nom du modèle utilisé pour afficher les résultats de la recherche.

Zones

Les zones sont des sections des pages qui peuvent être activées ou désactivées par les règles de fonctionnement. Une zone peut contenir tout contenu, y compris, mais sans s’y limiter, les facettes, les recherches, les chemins de navigation, le contenu statique. Les zones de la page Web des clients doivent correspondre aux mêmes zones que la recherche/le marchandisage du site.

Exemple de noeuds de zone :

    <zones> 
        <zone> 
            <name><![CDATA[brand-facet]]></name> 
            <display>1</display> 
        </zone> 
    </zones> 

Noeud

Noeud parent

Description

zones

client-results

Contient des zones 0-n.

zone

zones

Noeud de zone individuel. Vous pouvez avoir plusieurs noeuds de zone.

name

zone

Nom de la zone.

affichage

1 ou 0, indiquant si la zone correspondant au nom de la zone est affichée ou masquée.

Exemples

Exemple de sortie pour une recherche * sur un site Web fictif appelé Geometrixx et exemple de modèle de présentation utilisé pour produire l’exemple de sortie.

Exemple de sortie

Exemple de sortie pour une recherche * sur un site Web fictif appelé Geometrixx.

<?xml version="1.0" encoding="utf-8" standalone="yes" ?> 
<customer-results> 
    <query> 
        <user-query><![CDATA[*]]></user-query> 
 <lower-results><![CDATA[1]]></lower-results> 
 <upper-results><![CDATA[12]]></upper-results> 
 <total-results><![CDATA[1337]]></total-results> 
    </query> 
 
    <custom-fields> 
 
        <custom-field name="seo-search-title"><![CDATA[Geometrixx Search Results]]></custom-field> 
        <custom-field name="seo-search-keywords"><![CDATA[]]></custom-field> 
    </custom-fields> 
 
    <menus> 
 
        <menu> 
           <name>sort</name>

             <item selected="true"> 
 
          <label><![CDATA[Relevance]]></label> 
          <value><![CDATA[relevance]]></value> 
          <link><![CDATA[ ]]></link> 
             </item>

             <item> 
          <label><![CDATA[Lowest Price]]></label> 
          <value><![CDATA[Price]]></value> 
          <link><![CDATA[?i=1;q=*;sort=Price;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>     
             </item>

             <item> 
          <label><![CDATA[Highest Price]]></label> 
          <value><![CDATA[Price_r]]></value> 
          <link><![CDATA[?i=1;q=*;sort=Price_r;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>     
             </item>

             <item> 
          <label><![CDATA[Brand]]></label> 
          <value><![CDATA[brand]]></value> 
          <link><![CDATA[?i=1;q=*;sort=brand;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>     
             </item>

        </menu> 
        <menu> 
            <name><![CDATA[ss_head_nav]]></name>

                    <label><![CDATA[WOMEN'S]]></label> 
      <value><![CDATA[?q1=Womens;sp_sfvl_field=levelii|leveli|brand|leveliii;x=0;x1=leveli;y=0;view=nav;top=1]]></value> 
      <link><![CDATA[?q1=Womens;sp_sfvl_field=levelii|leveli|brand|leveliii;x=0;x1=leveli;y=0;view=nav;top=1;i=1;m_ss_head_nav=WOMEN'S]]></link>

                    <label><![CDATA[MEN'S]]></label> 
      <value><![CDATA[/q1/Mens/x1/leveli/view/nav/top/1/]]></value> 
      <link><![CDATA[/q1/Mens/x1/leveli/view/nav/top/1/]]></link>

                    <label><![CDATA[JEWELRY & ACCESSORIES]]></label> 
      <value><![CDATA[?q1=Jewelry+%26+Accessories&sp_sfvl_field=levelii|leveli|brand|leveliii&x1=leveli&view=nav&top=1]]></value> 
      <link><![CDATA[?q1=Jewelry+%26+Accessories&sp_sfvl_field=levelii|leveli|brand|leveliii&x1=leveli&view=nav&top=1;i=1;m_ss_head_nav=JEWELRY+%26+ACCESSORIES]]></link>

                    <label><![CDATA[BEAUTY & FRAGRANCE]]></label> 
      <value><![CDATA[?q1=Beauty+%26+Fragrance;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value> 
      <link><![CDATA[?q1=Beauty+%26+Fragrance;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=BEAUTY+%26+FRAGRANCE]]></link>

                    <label><![CDATA[GIFTS & HOME]]></label> 
      <value><![CDATA[?q1=Gifts+%26+Home;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value> 
      <link><![CDATA[?q1=Gifts+%26+Home;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=GIFTS+%26+HOME]]></link>

                    <label><![CDATA[CHILDREN & TOYS]]></label> 
      <value><![CDATA[?q1=Children+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value> 
      <link><![CDATA[?q1=Children+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=CHILDREN+%26+TOYS]]></link>

                    <label><![CDATA[ELECTRONICS]]></label> 
      <value><![CDATA[?q1=Electronics+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value> 
      <link><![CDATA[?q1=Electronics+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=ELECTRONICS]]></link>

        </menu> 
    </menus> 
 
    <breadcrumbs> 
  <breadcrumb> 
            <name><![CDATA[default]]></name> 
       
  <breadcrumb-item> 
    <link><![CDATA[?i=1;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></link> 
    <value><![CDATA[*]]></value> 
                        <label><![CDATA[]]></label> 
   </breadcrumb-item> 
          
   </breadcrumb> 
 
    </breadcrumbs> 
 
    <suggestions> 
        <auto-searched>0</auto-searched> 
         
        <suggestions-low-results>0</suggestions-low-results> 
         
    </suggestions> 
 
    <pagination> 
        <total-pages><![CDATA[112]]></total-pages> 
 
        <pages> 
     <page position="first"><![CDATA[]]></page> 
     <page position="last"><![CDATA[?i=1;page=112;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page> 
      
     <page position="next"><![CDATA[?i=1;page=2;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>

                <page position="1" selected="true"><![CDATA[?i=1;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>

                <page position="2"><![CDATA[?i=1;page=2;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>

                <page position="3"><![CDATA[?i=1;page=3;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>

                <page position="4"><![CDATA[?i=1;page=4;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>

                <page position="5"><![CDATA[?i=1;page=5;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>

        </pages> 
    </pagination> 
 
    <facets>  
         
     <facet-item> 
         <facet-title><![CDATA[Department]]></facet-title> 
                <selected>0</selected>

      <facet-value> 
           
              <label><![CDATA[Womens]]></label> 
 
       <link><![CDATA[?i=1;q=*;q1=Womens;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link> 
       <count><![CDATA[219]]></count> 
                         
      </facet-value> 
   
      <facet-value> 
           
              <label><![CDATA[Mens]]></label> 
       <link><![CDATA[?i=1;q=*;q1=Mens;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link> 
       <count><![CDATA[202]]></count> 
                         
      </facet-value> 
   
      <facet-value>

              <label><![CDATA[Beauty &amp; Fragrance]]></label> 
       <link><![CDATA[?i=1;q=*;q1=Beauty+%26+Fragrance;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link> 
       <count><![CDATA[169]]></count> 
                         
      </facet-value> 
   
      <facet-value> 
           
              <label><![CDATA[Children &amp; Toys]]></label> 
       <link><![CDATA[?i=1;q=*;q1=Children+%26+Toys;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link> 
       <count><![CDATA[209]]></count> 
                         
      </facet-value>

      <facet-value> 
           
              <label><![CDATA[Electronics &amp; Toys]]></label> 
       <link><![CDATA[?i=1;q=*;q1=Electronics+%26+Toys;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link> 
       <count><![CDATA[200]]></count> 
                         
      </facet-value> 
   
      <facet-value> 
           
              <label><![CDATA[Gifts &amp; Home]]></label> 
       <link><![CDATA[?i=1;q=*;q1=Gifts+%26+Home;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link> 
       <count><![CDATA[156]]></count>

      </facet-value> 
   
      <facet-value> 
           
              <label><![CDATA[Jewelry &amp; Accessories]]></label> 
       <link><![CDATA[?i=1;q=*;q1=Jewelry+%26+Accessories;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link> 
       <count><![CDATA[182]]></count> 
                         
      </facet-value> 
   
      </facet-item> 
  
    </facets> 
 
    <results> 
        <result-set> 
            <name><![CDATA[default]]></name> 
               
         <result> 
                    <field name="index"><![CDATA[1]]></field> 
      <field name="brand"><![CDATA[Citizens]]></field> 
      <field name="price"><![CDATA[149]]></field> 
      <field name="foundIn"><![CDATA[Womens,  
            Apparel,  
          Denim]]></field> 
         </result>   
        
         <result> 
 
                    <field name="index"><![CDATA[2]]></field> 
      <field name="brand"><![CDATA[One For All]]></field> 
      <field name="price"><![CDATA[145]]></field> 
      <field name="foundIn"><![CDATA[Womens,  
            Apparel,  
          Denim]]></field> 
         </result>   
        
         <result> 
                    <field name="index"><![CDATA[3]]></field> 
      <field name="brand"><![CDATA[Citizens]]></field> 
      <field name="price"><![CDATA[208]]></field> 
 
      <field name="foundIn"><![CDATA[Womens,  
            Apparel,  
          Denim]]></field> 
         </result>   
        
         <result> 
                    <field name="index"><![CDATA[4]]></field> 
      <field name="brand"><![CDATA[Vera Watson]]></field> 
      <field name="price"><![CDATA[850]]></field> 
      <field name="foundIn"><![CDATA[Womens,  
            Dresses,  
          Day]]></field> 
         </result>   
        
         <result> 
                    <field name="index"><![CDATA[5]]></field> 
 
      <field name="brand"><![CDATA[Ray Laredo]]></field> 
      <field name="price"><![CDATA[195]]></field> 
      <field name="foundIn"><![CDATA[Children &amp; Toys,  
            Apparel,  
          Boys Toddler (2T-4T)]]></field> 
         </result>   
        
         <result> 
                    <field name="index"><![CDATA[6]]></field> 
      <field name="brand"><![CDATA[Ray Laredo]]></field> 
      <field name="price"><![CDATA[80]]></field> 
      <field name="foundIn"><![CDATA[Children &amp; Toys,  
            Apparel,  
          Boys Toddler (2T-4T)]]></field> 
 
         </result>   
        
         <result> 
                    <field name="index"><![CDATA[7]]></field> 
      <field name="brand"><![CDATA[Petrol]]></field> 
      <field name="price"><![CDATA[85]]></field> 
      <field name="foundIn"><![CDATA[Children &amp; Toys,  
            Apparel,  
          Boys Toddler (2T-4T)]]></field> 
         </result>   
        
         <result> 
                    <field name="index"><![CDATA[8]]></field> 
      <field name="brand"><![CDATA[Woolberry]]></field> 
 
      <field name="price"><![CDATA[280]]></field> 
      <field name="foundIn"><![CDATA[Children &amp; Toys,  
            Apparel,  
          Boys Toddler (2T-4T)]]></field> 
         </result>   
        
         <result> 
                    <field name="index"><![CDATA[9]]></field> 
      <field name="brand"><![CDATA[Petrol]]></field> 
      <field name="price"><![CDATA[149]]></field> 
      <field name="foundIn"><![CDATA[Children &amp; Toys,  
            Apparel,  
          Boys Toddler (2T-4T)]]></field> 
         </result>   
        
         <result> 
 
                    <field name="index"><![CDATA[10]]></field> 
      <field name="brand"><![CDATA[Ray Laredo]]></field> 
      <field name="price"><![CDATA[55]]></field> 
      <field name="foundIn"><![CDATA[Children &amp; Toys,  
            Apparel,  
          Boys Toddler (2T-4T)]]></field> 
         </result>   
        
         <result> 
                    <field name="index"><![CDATA[11]]></field> 
      <field name="brand"><![CDATA[Petrol]]></field> 
      <field name="price"><![CDATA[45]]></field> 
 
      <field name="foundIn"><![CDATA[Children &amp; Toys,  
            Apparel,  
          Boys Toddler (2T-4T)]]></field> 
         </result>   
        
         <result> 
                    <field name="index"><![CDATA[12]]></field> 
      <field name="brand"><![CDATA[Ray Laredo]]></field> 
      <field name="price"><![CDATA[47]]></field> 
      <field name="foundIn"><![CDATA[Children &amp; Toys,  
            Apparel,  
          Boys Toddler (2T-4T)]]></field> 
         </result>   
      
        </result-set>   
    </results>

    <banners> 
         
            <banner> 
                <area><![CDATA[top]]></area> 
                <content><![CDATA[<div style="color:#70A100">We have custom shipping</div>]]></content> 
            </banner>

    </banners> 
 
    <zones> 
        <zone> 
 
            <name><![CDATA[brand-facet]]></name> 
            <display>1</display> 
        </zone> 
    </zones> 
 
    <search-form> 
        <include-tnt-mbox>1</include-tnt-mbox> 
        <autocomplete> 
 
            <enabled>1</enabled> 
            <css><![CDATA[<link rel="stylesheet" type="text/css" href="https://content.t1.atomz.com/sp10043554/stage/autocomplete_styles.css?sp_js_param=2" /> 
]]></css> 
            <form-content><![CDATA[<div id="autocomplete"></div> 
<input type="hidden" name="sp_staged" id="sp_staged" value="1" /> 
]]></form-content> 
            <javascript><![CDATA[<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/utilities/utilities.js"></script> 
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/datasource/datasource-min.js"></script> 
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/autocomplete/autocomplete-min.js"></script> 
<script type="text/javascript" src="https://content.t1.atomz.com/sp10043554/stage/autocomplete_data.js?sp_js_param=3"></script>]]></javascript> 
        </autocomplete> 
    </search-form> 
 
</customer-results> 

Exemple de modèle de présentation

Voici un exemple de modèle de présentation utilisé pour produire l’exemple de sortie ci-dessus.

<?xml version="1.0" encoding="utf-8" standalone="yes" ?> 
<customer-results> 
    <query> 
        <user-query><![CDATA[<guided-query-param gsname="q" />]]></user-query> 
 <lower-results><![CDATA[<guided-results-lower>]]></lower-results> 
 <upper-results><![CDATA[<guided-results-upper>]]></upper-results> 
 <total-results><![CDATA[<guided-results-total>]]></total-results> 
    </query> 
 
    <custom-fields> 
        <custom-field name="seo-search-title"><![CDATA[Geometrixx Search Results]]></custom-field> 
        <custom-field name="seo-search-keywords"><![CDATA[<guided-general-field gsname="default" field="seo_search_keywords"/>]]></custom-field> 
    </custom-fields> 
 
    <menus> 
 
        <menu> 
           <name>sort</name> 
     <guided-menu gsname="sort"> 
         <guided-if-menu-item-selected> 
             <item selected="true"> 
          <label><![CDATA[<guided-menu-item-label />]]></label> 
          <value><![CDATA[<guided-menu-item-value />]]></value> 
          <link><![CDATA[ ]]></link> 
             </item> 
        <guided-else-menu-item-selected> 
             <item> 
          <label><![CDATA[<guided-menu-item-label />]]></label> 
          <value><![CDATA[<guided-menu-item-value />]]></value> 
          <link><![CDATA[<guided-menu-item-path />]]></link>     
             </item> 
        </guided-if-menu-item-selected> 
    </guided-menu> 
        </menu> 
        <menu> 
            <name><![CDATA[ss_head_nav]]></name> 
            <guided-menu gsname="ss_head_nav"> 
                <guided-if-menu-item-selected> 
                    <item selected="true"> 
                    <label><![CDATA[<guided-menu-item-label />]]></label> 
      <value><![CDATA[<guided-menu-item-value />]]></value> 
      <link><![CDATA[<guided-menu-item-path />]]></link> 
                <guided-else-menu-item-selected> 
                    <label><![CDATA[<guided-menu-item-label />]]></label> 
      <value><![CDATA[<guided-menu-item-value />]]></value> 
      <link><![CDATA[<guided-menu-item-path />]]></link> 
                </guided-if-menu-item-selected> 
            </guided-menu>  
        </menu> 
    </menus> 
 
    <breadcrumbs> 
  <breadcrumb> 
            <name><![CDATA[default]]></name> 
      <guided-breadcrumb gsname="default"> 
  <breadcrumb-item> 
    <link><![CDATA[<guided-breadcrumb-path gsname="goto">]]></link> 
    <value><![CDATA[<guided-breadcrumb-value />]]></value> 
                        <label><![CDATA[<guided-breadcrumb-label>]]></label> 
   </breadcrumb-item> 
         </guided-breadcrumb> 
   </breadcrumb> 
    </breadcrumbs> 
 
    <suggestions> 
        <auto-searched><guided-if-suggestion-autosearch>1<guided-else-suggestion-autosearch>0</guided-if-suggestion-autosearch></auto-searched> 
        <guided-if-suggestion-autosearch><orig-query><![CDATA[<guided-suggestion-original-query/>]]></orig-query></guided-if-suggestion-autosearch> 
        <suggestions-low-results><guided-if-suggestion-low-results>1<guided-else-suggestion-low-results>0</guided-if-suggestion-low-results></suggestions-low-results> 
        <guided-suggestions> 
     <suggestion-item> 
         <link><![CDATA[<guided-suggestion-path />]]></link> 
  <word><![CDATA[<guided-suggestion />]]></word> 
     </suggestion-item> 
 </guided-suggestions> 
    </suggestions> 
 
    <pagination> 
        <total-pages><![CDATA[<guided-page-total />]]></total-pages> 
        <pages> 
     <page position="first"><![CDATA[<guided-page-path gsname="first" />]]></page> 
     <page position="last"><![CDATA[<guided-page-path gsname="last" />]]></page> 
     <guided-if-page-prev><page position="prev"><![CDATA[<guided-page-path gsname="prev" />]]></page></guided-if-page-prev> 
     <guided-if-page-next><page position="next"><![CDATA[<guided-page-path gsname="next" />]]></page></guided-if-page-next> 
     <guided-if-page-viewall><page position="viewall"><![CDATA[<guided-page-path gsname="viewall" />]]></page></guided-if-page-viewall> 
     <guided-if-page-viewpages><page position="viewall"><![CDATA[<guided-page-path gsname="viewpages" />]]></page></guided-if-page-viewpages> 
 
     <guided-pages> 
                <guided-if-page-selected><page position="<guided-page-number />" selected="true"><![CDATA[<guided-page-path />]]></page> 
  <guided-else-page-selected><page position="<guided-page-number />"><![CDATA[<guided-page-path />]]></page> 
  </guided-if-page-selected> 
     </guided-pages> 
        </pages> 
    </pagination> 
 
    <facets>  
        <guided-facet gsname="leveli"> 
     <facet-item> 
         <facet-title><![CDATA[Department]]></facet-title> 
                <selected><guided-if-facet-selected>1<guided-else-facet-selected>0</guided-if-facet-selected></selected> 
                <guided-if-facet-selected><undo-link><![CDATA[<guided-facet-undo-path gsname="leveli">]]></undo-link></guided-if-facet-selected> 
  <guided-facet-values> 
      <facet-value> 
          <guided-if-facet-value-selected><selected><![CDATA[true]]></selected></guided-if-facet-value-selected> 
              <label><![CDATA[<guided-facet-value>]]></label> 
       <link><![CDATA[<guided-facet-value-path />]]></link> 
       <count><![CDATA[<guided-facet-count>]]></count> 
                        <guided-if-facet-value-selected><undolink><![CDATA[<guided-facet-value-undo-path />]]></undolink></guided-if-facet-value-selected> 
      </facet-value> 
  </guided-facet-values> 
      </facet-item> 
 </guided-facet> 
    </facets> 
 
    <results> 
        <result-set> 
            <name><![CDATA[default]]></name> 
            <guided-results gsname="default">   
         <result> 
                    <field name="index"><![CDATA[<guided-result-index />]]></field> 
      <field name="brand"><![CDATA[<guided-result-field gsname="brand" />]]></field> 
      <field name="price"><![CDATA[<guided-result-field gsname="price" />]]></field> 
      <field name="foundIn"><![CDATA[<guided-if-result-field gsname="leveli"><!--tmpl_var name='leveli'-->, </guided-if-result-field> 
            <guided-if-result-field gsname="levelii"><!--tmpl_var name='levelii'-->, </guided-if-result-field> 
          <guided-if-result-field gsname="leveliii"><!--tmpl_var name='leveliii'--></guided-if-result-field>]]></field> 
         </result>   
     </guided-results> 
        </result-set>   
    </results> 
 
    <guided-if-recent-searches> 
    <recent-searches> 
        <clear-link><guided-recent-searches-clear-path/></clear-link> 
        <guided-recent-searches> 
            <recent-search> 
                <link><guided-recent-searches-path></link> 
                <label><guided-recent-searches-value></label> 
            <recent-search> 
        </guided-recent-searches> 
    </recent-searches> 
    </guided-if-recent-searches> 
 
    <banners> 
        <guided-if-banner-set gsname="top"> 
            <banner> 
                <area><![CDATA[top]]></area> 
                <content><![CDATA[<guided-banner gsname="top">]]></content> 
            </banner> 
        </guided-if-banner-set> 
        <guided-if-banner-set gsname="bottom"> 
            <banner> 
                <area><![CDATA[bottom]]></area> 
                <content><![CDATA[<guided-banner gsname="bottom">]]></content> 
            </banner> 
        </guided-if-banner-set> 
    </banners> 
 
    <zones> 
        <zone> 
            <name><![CDATA[brand-facet]]></name> 
            <display><guided-if-zone gsname="brand-facet">1<guided-else-zone>0</guided-if-zone></display> 
        </zone> 
    </zones> 
 
    <search-form> 
        <include-tnt-mbox><guided-if-tnt-business-rules>1<guided-else-tnt-business-rules>0</guided-if-tnt-business-rules></include-tnt-mbox> 
        <autocomplete> 
            <enabled><guided-if-autocomplete>1<guided-else-autocomplete>0</guided-if-autocomplete></enabled> 
            <css><![CDATA[<guided-ac-css/>]]></css> 
            <form-content><![CDATA[<guided-ac-form-content/>]]></form-content> 
            <javascript><![CDATA[<guided-ac-javascript/>]]></javascript> 
        </autocomplete> 
    </search-form> 
 
</customer-results> 

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free