Vous pouvez personnaliser la sortie dans n’importe quel format texte, y compris XML ou JSON.
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é.
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.
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.
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 :
|
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.
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 :
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. |
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. |
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'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'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'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. |
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. |
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. |
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. |
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. |
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. |
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. |
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é. |
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. |
Tableaux décrivant la sortie de réponse XML standard.
Vous pouvez consulter la réponse XML pour les éléments suivants :
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. |
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. |
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'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'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'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. |
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. |
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. |
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. |
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. |
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. |
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. |
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é. |
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. |
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 :
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. |
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. |
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. |
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&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. |
Exemple :
xml version="1.0" encoding="utf-8" standalone="yes"
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. |
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. |
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. |
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. |
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. |
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. |
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é. |
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. |
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. |
|
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 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 & 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 & 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 & 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 & 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 & 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 & 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 & 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 & 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 & 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 & 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 & 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 & 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 & 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>
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>