Dépannage et FAQ

Problèmes courants et réponses#

Mon lot ne s’affiche pas sur ma boutique#

Si votre lot est défini sur Actif, mais que les clients ne le voient pas, parcourez cette liste de vérification.

Toujours pas de résultat?

Cliquez sur l’icône de clavardage dans le coin inférieur droit de n’importe quelle page xBundle, ouvrez l’onglet Questions et envoyez-nous :

• Le nom et le type du lot
• L’URL de la page produit où vous vous attendez à le voir
• Une capture d’écran de Paramètres → Widgets de lots montrant les badges des widgets

Les rabais ne s’appliquent pas#

Si le rabais de votre lot ne s’applique pas au moment du paiement, voici ce qu’il faut vérifier.

Vérification 1 : le rabais est configuré correctement

Allez dans Lots, ouvrez le lot et passez en revue la carte Configurer les rabais :

• Un Nom du rabais est-il défini? Il est obligatoire, et c’est l’étiquette que les acheteurs voient au paiement.
• Un Type de rabais est-il sélectionné : Pourcentage, Montant fixe, Achetez X obtenez Y ou Livraison gratuite?
• La Valeur du rabais est-elle supérieure à 0? Un Pourcentage (et le rabais cadeau d’un Achetez X obtenez Y) ne peut pas dépasser 100 %.
• Pour Achetez X obtenez Y, la Quantité de produits-cadeaux est-elle d’au moins 1, et avez-vous sélectionné des produits-cadeaux?

Les erreurs de validation apparaissent sur le formulaire de rabais lorsque vous cliquez sur Enregistrer. Le panneau Aperçu des rabais du lot résume chaque rabais enregistré et ses règles, pour que vous puissiez vérifier ce qui sera appliqué.

Vérification 2 : les règles de rabais sont respectées

Si vous avez coché Activer le rabais basé sur des règles et ajouté des conditions, le panier de l’acheteur doit les respecter :

• Quantité : Le client achète-t-il suffisamment d’articles (et pas plus que le maximum, si vous en avez défini un)?
• Valeur du panier : Le total du panier se situe-t-il dans la plage que vous avez définie?
• Inventaire : Le niveau de stock du produit se situe-t-il dans la plage que vous avez définie?

Les conditions sont combinées avec les opérateurs ET / OU que vous avez choisis, et Inverser cette condition inverse une règle. Si vous avez coché Activer le rabais basé sur le temps, le rabais ne s’applique que de la Date de début à la Date de fin (les deux jours inclus, selon le fuseau horaire de votre boutique). En dehors de cette fenêtre, le rabais est ignoré au paiement et, pour les lots Fixe et Mix & Match, sa carte de rabais est masquée sur la vitrine.

Vérification 3 : le lot est Actif

Seuls les lots Actifs voient leurs rabais appliqués. Les lots Brouillon et Archivés n’appliquent jamais de rabais au paiement, même si un acheteur a encore le produit dans son panier.

Vérification 4 : les produits sont ajoutés correctement au panier

Pour que le rabais s’applique, le client doit ajouter les produits via le widget de lot, et non individuellement depuis le bouton d’ajout au panier habituel. Le widget marque les lignes du panier pour que le paiement sache qu’elles appartiennent à un lot. Assurez-vous que le bloc d’application est installé et fonctionnel (voir ci-dessus).

Vérification 5 : le rabais automatique de xBundle existe toujours

xBundle crée un rabais automatique dans votre admin Shopify, nommé Discount by bundles - (NO DELETE) (admin Shopify → Réductions). Tous les rabais de lots passent par lui. S’il a été supprimé ou désactivé, aucun rabais de lot ne peut s’appliquer. Ne le supprimez pas, et contactez-nous via l’icône de clavardage (coin inférieur droit) s’il est manquant.

Vérification 6 : les autres rabais

Le rabais automatique de xBundle est configuré pour se combiner avec les rabais de produit, de commande et de livraison. Le cumul d’un code de réduction avec lui dépend des paramètres de Combinaisons propres à ce code dans votre admin Shopify (Réductions → le code). Au paiement, le rabais de lot apparaît sous le nom que vous lui avez donné, ou sous Rabais de lot, Cadeau gratuit, Rabais cadeau ou Livraison gratuite si le nom a été laissé vide.

Les Analyses n’affichent aucune donnée#

Si votre tableau de bord affiche des zéros ou aucune donnée, voici comment procéder au dépannage.

Les lots sont-ils actifs?

Les lots Brouillon et Archivés sont masqués sur votre vitrine : les acheteurs ne peuvent donc ni les ajouter au panier ni les acheter. Il n’y a rien à enregistrer tant que le lot n’est pas Actif.

Le pixel web est-il installé?

xBundle utilise un pixel web Shopify pour compter les vues de lots, les ajouts au panier, les consultations du panier et les paiements. Le pixel est créé automatiquement lorsque vous installez (ou réinstallez) l’application, mais vous pouvez le vérifier :

1. Allez dans votre admin Shopify → Paramètres → Événements client
2. Recherchez le pixel de xBundle (web-pixel-xBundle) dans la liste
3. Assurez-vous qu’il est connecté

Le pixel n’enregistre que des événements d’analytique; les visiteurs qui refusent les cookies d’analytique dans la bannière de confidentialité de votre boutique ne sont donc pas comptés. Vos chiffres peuvent être inférieurs à votre trafic total.

Le revenu et les commandes proviennent des commandes, pas du pixel

Les cartes Revenu total, Commandes, Revenu net et Valeur moyenne de commande, ainsi que les tableaux Répartition du revenu et Ventes totales par type de lot, sont calculés à partir de vos commandes Shopify. Ils se remplissent lorsqu’un client passe réellement une commande contenant un lot; vous pouvez donc voir des événements Vues de lots et Ajouté au panier avant l’apparition du moindre revenu.

Laissez-lui le temps

Si vous venez de créer et d’activer votre premier lot, les données ont besoin de temps pour s’accumuler. Revenez après quelques heures ou le lendemain, une fois que les clients ont commencé à interagir avec vos lots.

Vérifiez la plage de dates

Le sélecteur de dates est réglé par défaut sur 7 derniers jours; vous pouvez aussi choisir Aujourd’hui, 7 dernières semaines, 7 derniers mois, 7 dernières années, ou sélectionner une plage personnalisée dans le calendrier. Assurez-vous que la plage couvre la période durant laquelle vos lots étaient actifs. Si vos lots n’ont été activés qu’aujourd’hui, l’essentiel d’une plage de 7 jours sera vide. Les événements sont regroupés par jour.

Faible trafic

Si votre boutique a un très faible trafic, il faudra peut-être plus de temps pour que des données significatives apparaissent. Concentrez-vous sur l’attraction de trafic vers les pages produit dotées de lots actifs.

Mon assistant IA ne parvient pas à se connecter#

Si vous tentez de connecter un client IA (comme Claude ou ChatGPT) et que cela ne fonctionne pas, vérifiez les éléments suivants.

Vérifiez l’URL de connexion

Allez dans Paramètres → Connecter l’IA et cliquez sur Copier à côté de Votre URL de connexion. Ce doit être exactement l’URL affichée à cet endroit, et elle est unique à votre boutique. Dans votre client IA, ouvrez ses paramètres Connecteurs / Serveurs MCP, ajoutez une nouvelle connexion et collez l’URL.

Avez-vous approuvé la connexion?

Ajouter l’URL ne suffit pas à elle seule. Votre navigateur ouvre votre admin Shopify sur la page Connecter l’IA à votre boutique, qui demande « Autoriser cette IA à se connecter à votre boutique? ». Cliquez sur Autoriser l’accès. La demande expire après un court délai (la page affiche un compte à rebours); si elle a expiré ou que vous avez fermé la fenêtre, relancez la connexion depuis votre client IA.

Deux choses à vérifier sur cette page :

• Elle affiche l’adresse vers laquelle les données de votre boutique seront envoyées. Assurez-vous qu’il s’agit de l’adresse de votre client IA avant d’autoriser; si l’écran est apparu de façon inattendue, cliquez sur Refuser.
• Vous devez être connecté à la même boutique Shopify que celle à laquelle appartient l’URL de connexion, dans le même navigateur que celui ouvert par votre client IA. Sinon, vous verrez un message du type « boutique différente » ou « n’a pas pu être reprise ». Connectez-vous à la bonne boutique et recommencez.

Vérifiez si le client est déjà connecté

Dans Paramètres → Connecter l’IA, regardez sous Clients IA connectés. Si votre client y figure avec un badge Connecté, la connexion a fonctionné. Le problème se situe du côté du client IA (essayez de retirer puis de rajouter le connecteur à cet endroit).

L’IA a créé un lot, mais je ne le vois pas sur ma boutique

C’est normal. Tout ce que l’IA crée est enregistré comme Brouillon. Ouvrez Lots, vérifiez-le et utilisez Définir comme actif quand vous êtes prêt, ou demandez à l’IA de le publier (la publication est marquée comme une étape nécessitant votre confirmation, votre client IA devrait donc vous consulter d’abord).

Déconnectez et reconnectez

Dans Paramètres → Connecter l’IA, cliquez sur Déconnecter à côté du client. Il perd immédiatement l’accès. Ajoutez ensuite de nouveau l’URL de connexion depuis le début dans votre client IA et approuvez-la de nouveau.

Foire aux questions#

Combien de lots puis-je créer?

Vous pouvez créer autant de lots en Brouillon que vous le souhaitez. Le nombre de lots Actifs (en ligne sur votre boutique) dépend de votre forfait : 5 sur Gratuit, 50 sur Starter, 100 sur Growth et illimité sur Enterprise. Chaque forfait inclut aussi un nombre de ventes de lots par période de facturation : 20 sur Gratuit, 200 sur Starter, 500 sur Growth, illimité sur Enterprise. Lorsque vous atteignez votre limite de lots actifs, vous verrez une bannière Limite de lots atteinte et vous ne pourrez pas activer d’autres lots tant que vous ne passez pas à un forfait supérieur. Votre utilisation actuelle est affichée sous Utilisation cette période dans Paramètres → Forfaits et facturation.

Puis-je utiliser différents types de lots en même temps?

Oui! Vous pouvez avoir des lots Fixe, Multipack, Mix & Match et FBT qui fonctionnent tous en même temps. Chaque type sert un objectif différent, et ils n’entrent pas en conflit les uns avec les autres. Chaque forfait inclut tous les types de lots et tous les types de rabais.

Est-ce que xBundle ralentit ma boutique?

Non. Les widgets de vitrine de xBundle sont légers et leurs scripts se chargent après le contenu de votre page; ils ne bloquent donc pas l’affichage de la page. Le suivi d’analytique utilise le système de pixel web de Shopify, qui s’exécute dans un bac à sable sécurisé et n’a aucune incidence sur la vitesse de chargement des pages.

Puis-je utiliser xBundle avec n’importe quel thème Shopify?

xBundle fonctionne avec tous les thèmes Shopify Online Store 2.0 qui prennent en charge les blocs d’application sur le modèle produit. La plupart des thèmes Shopify modernes le prennent en charge. Si vous utilisez un thème plus ancien (vintage), les blocs d’application pourraient ne pas être disponibles.

Qu’advient-il de mes lots si je désinstalle xBundle?

La désinstallation retire immédiatement les widgets, le rabais et le pixel de xBundle de votre boutique, et déconnecte tout client IA connecté. xBundle ne change pas le statut de vos lots lors de la désinstallation, mais il ne peut plus les changer ensuite non plus. Passez donc vos lots au statut Brouillon (ou archivez-les/supprimez-les) avant de désinstaller, afin que leurs produits de lot ne restent pas visibles sur votre vitrine sans l’application.

Environ 48 heures après la désinstallation, Shopify demande à xBundle d’effacer définitivement toutes les données de l’application pour votre boutique : lots, rabais, paramètres, analyses et historique d’utilisation. Si vous réinstallez dans cette fenêtre, vos lots et vos paramètres sont toujours là. xBundle recrée son rabais et son pixel, et les clients IA doivent être reconnectés. Shopify annule votre abonnement payant à la désinstallation; vous repartez donc sur le forfait Gratuit et devez choisir votre forfait de nouveau sous Paramètres → Forfaits et facturation. Après l’effacement, rien ne peut être récupéré, et vous repartirez avec une application vide.

Les clients peuvent-ils utiliser un code de réduction ET un rabais de lot?

Le rabais automatique de xBundle est configuré pour se combiner avec les rabais de produit, de commande et de livraison. Le cumul d’un code de réduction précis avec lui dépend des paramètres de Combinaisons propres à ce code dans votre admin Shopify (Réductions → le code). Si un code est configuré pour ne pas se combiner avec les rabais de produit ou de livraison, Shopify décide quel rabais s’applique au paiement.

Comment l’IA sait-elle quels produits recommander?

Les recommandations automatiques reposent sur la similarité des produits, calculée à partir du titre, de la description, du type de produit et des balises de chaque produit. Les produits au contenu similaire sont recommandés ensemble. Seuls les produits actifs et en stock sont pris en compte, et les produits que vous avez ajoutés sous Produits exclus dans Paramètres → Recommander des produits au paiement sont ignorés. Si les données de similarité ne sont pas encore disponibles pour les produits du panier, xBundle se rabat sur des produits en stock choisis au hasard.

Puis-je personnaliser l’apparence du widget de lot?

Oui. Chaque widget possède ses propres paramètres dans l’éditeur de thème Shopify. Ouvrez votre modèle produit et sélectionnez le bloc :

• Discount Bundle (cartes de rabais Fixe et Mix & Match) : la couleur et la taille de la carte, la couleur du texte, l’affichage du compte à rebours, les conditions à afficher et chaque libellé de texte.
• Bundle Product Card (sélecteur de produits Mix & Match) : le texte des boutons Ajouter/Ajouté, les couleurs des cartes, des boutons et des prix, et les tailles de police.
• Multipack : la couleur d’accent, l’arrière-plan et la largeur (px) des cartes, la disposition des cartes, les badges « Populaire », le style et la position du compte à rebours, les règles à afficher et tous les textes de règles et d’inventaire.
• FBT Bundle : le titre et le sous-titre du lot, le format, la position, le style et les couleurs du compte à rebours, l’affichage des règles de rabais, la largeur maximale et les textes de règles.

Vous pouvez aussi faire glisser le bloc à une autre position sur le modèle produit. Au-delà de ces paramètres, les changements de style peuvent nécessiter du CSS personnalisé de la part d’un développeur de thèmes.

Mes données sont-elles sécurisées?

Oui. xBundle respecte les directives de sécurité de Shopify, et vous ne saisissez jamais de clé API d’IA dans xBundle. Si vous utilisez Connecter l’IA, les données de votre boutique ne sont partagées qu’avec le client IA que vous avez personnellement approuvé. Vous approuvez chaque connexion dans votre propre admin Shopify (la page d’approbation indique où vos données seront envoyées), une connexion ne fonctionne que pour la boutique qui l’a approuvée, et vous pouvez révoquer l’accès à tout moment avec Déconnecter dans l’onglet Connecter l’IA. Le pixel d’analytique de xBundle n’enregistre que les vues de lots, les ajouts au panier, les consultations du panier et les paiements (aucun identifiant d’acheteur), et l’application ne stocke aucune donnée personnelle de client.

Qui dois-je contacter pour obtenir de l’aide?

Cliquez sur l’icône de clavardage dans le coin inférieur droit de n’importe quelle page de xBundle. Elle ouvre le panneau Aide et soutien avec deux onglets : Comment utiliser, avec un bouton Ouvrir la documentation complète qui mène à l’ensemble des guides, et Questions, un court formulaire (Votre nom, Courriel, Comment pouvons-nous vous aider?). Cliquez sur Envoyer le message et nous vous répondrons par courriel.