Contrôler les métachamps de produits que Shoply peut utiliser

Comment exclure des métachamps de produits

Votre assistant d’achat IA est conçu pour aider les clients en lisant les informations de vos produits, en répondant à leurs questions et en formulant des recommandations.

Cependant, toutes les données produit ne sont pas destinées aux clients. Certains métachamps de produits peuvent contenir des informations internes (comme la marge bénéficiaire), des informations sur les fournisseurs ou d’autres attributs qui doivent rester privés. Dans ce cas, vous pouvez préférer que Shoply n’utilise pas ces métachamps pour répondre aux questions des clients.

Shoply utilise l’IA pour déterminer automatiquement quels métachamps peuvent être utilisés pour répondre aux questions des clients. Toutefois, pour vous donner un contrôle total, Shoply vous permet de définir une liste noire (exclusion) de métachamps de produits spécifiques ou de namespaces entiers.

Ce guide explique pourquoi cette fonctionnalité est utile et comment la configurer.

Où trouver les paramètres avancés ?

Accédez à la section « Settings » de la console d’administration de l’application, puis faites défiler jusqu’à la section « Advanced Settings ». Dans cette section, vous pouvez fournir un objet JSON pour configurer différents paramètres.

Paramètres de liste noire

Utilisez ces paramètres pour empêcher Shoply d’utiliser certains métachamps de produits lorsqu’il répond aux questions des clients.

`blacklist_product_fields`

Une liste de clés de métachamps exactes que vous souhaitez exclure. Le nom du champ doit correspondre exactement à la clé du métachamp telle qu’elle apparaît dans Shopify.

Exemples de clés de métachamps :

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

Remarque : si vous ne souhaitez pas afficher le fournisseur du produit, vous devez ajouter « brand » à la liste noire, car Shoply utilise le métachamp brand pour stocker les informations du fournisseur pour des raisons historiques.

`blacklist_display_filters`

Une liste de clés de métachamps exactes à masquer uniquement dans l’interface des filtres/facettes. Contrairement à blacklist_product_fields, ces champs restent disponibles pour l’IA afin de répondre aux questions des clients : ils ne sont simplement pas affichés comme filtres sélectionnables dans l’interface de recherche.

Cette option est utile lorsqu’un métachamp contient des informations produit précieuses que l’IA doit connaître, mais qui ne constituent pas un filtre pertinent pour les clients.

Exemple :

warehouse_region — contexte utile pour l’IA, mais filtre peu utile pour les clients
care_instructions — pertinent pour les réponses de l’IA, mais catégorie de filtre peu significative

`blacklist_namespaces`

Une liste de namespaces entiers que vous souhaitez faire ignorer par l’IA.

Exemple :

RenterInfo

Si un métachamp appartient à un namespace placé sur liste noire, tous les champs de ce namespace sont automatiquement exclus.

Cette option est utile lorsqu’un namespace entier est interne ou sensible.

Conseils pour utiliser la liste noire

Il est recommandé d’exclure :

Les codes fournisseur
Les informations d’entrepôt ou de stock
Les notes internes de préparation des commandes
Les métachamps utilisés par d’autres applications
Tout champ qui ne doit pas être visible par les clients

Évitez d’exclure des champs comme :

Le titre du produit
La description
La matière
La taille, les dimensions ou les caractéristiques
Les ingrédients
Les instructions d’entretien
Les noms/options de variantes

(Ces informations aident l’IA à fournir de meilleures réponses.)

Enrichir les données produit à partir des balises

`split_tag_to_metafield_by`

Les balises Shopify sont un moyen pratique d’étiqueter les produits, mais elles sont stockées sous forme de liste plate de chaînes et ne peuvent pas être utilisées comme filtres structurés. Ce paramètre vous permet de convertir les balises au format key:value en métachamps appropriés que Shoply peut indexer et utiliser pour le filtrage.

Fonctionnement :

Définissez split_tag_to_metafield_by sur le caractère délimiteur utilisé dans vos balises. Shoply séparera chaque balise à l’aide de ce caractère, considérera la partie gauche comme la clé du métachamp et la partie droite comme sa valeur, puis les indexera en conséquence.

Par exemple, si vos produits possèdent des balises comme celles-ci :

plaintext


material:aluminum
color:matte-black
compatible-with:iPhone 15

Définir le délimiteur sur ":" produira les métachamps suivants :

Clé	Valeur
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

Ces métachamps indexés peuvent ensuite être utilisés comme filtres de facettes dans Shoply AI Search, exactement comme les métachamps Shopify natifs.

Les balises qui ne contiennent pas le délimiteur sont ignorées par ce paramètre et restent des balises standard.

Exemple de configuration :

json


{
  "split_tag_to_metafield_by": ":"
}

Quand utiliser ce paramètre :

Votre boutique utilise déjà des balises key:value pour ses attributs (par exemple, via un import groupé ou une application tierce)
Vous souhaitez ajouter des attributs filtrables sans créer de définitions de métachamps Shopify officielles
Vous avez besoin d’un moyen rapide d’exposer des données produit structurées à Shoply sans réétiqueter votre catalogue

Contrôler l’affichage des produits

Utilisez ces paramètres pour contrôler les informations affichées lorsque les produits apparaissent dans le chat ou l’interface de recherche.

`hide_discount`

Lorsque ce paramètre est défini sur true, les pourcentages de remise (par exemple, « -40 % ») sont masqués dans l’affichage des produits. Cette option est utile si vous ne souhaitez pas mettre les remises en avant auprès des clients.

`hide_price`

Lorsque ce paramètre est défini sur true, toutes les informations de prix sont masquées, y compris les prix d’origine et les prix remisés. Utilisez-le si vous préférez que les clients consultent la page produit pour voir le prix ou si votre stratégie tarifaire exige de masquer les prix dans l’interface de chat/recherche.

`hide_review`

Lorsque ce paramètre est défini sur true, les notes des avis ne sont pas affichées sur les produits. Cette option est utile si vous ne souhaitez pas que les notes influencent les décisions des clients dans l’interface de chat/recherche.

Exemple d’objet JSON valide

Voici un exemple entièrement valide :

json


{
  "blacklist_product_fields": [
    "profit_margin",
    "inventory_level"
  ],
  "blacklist_display_filters": [
    "product_type",
    "category_name",
    "warehouse_region",
    "care_instructions"
  ],
  "blacklist_namespaces": [
    "SupplierInfo"
  ],
  "split_tag_to_metafield_by": ":",
  "hide_discount": true,
  "hide_price": false,
  "hide_review": false
}

Vous pouvez supprimer les éléments dont vous n’avez pas besoin, ou ajouter vos propres clés de métachamps et namespaces. Définissez les options hide_* sur true ou false selon vos préférences.