Dépannage et FAQ

Commencez ici#

Neuf fois sur dix, un rabais qui « ne fonctionne pas » échoue à l’une de quatre vérifications. Faites-les avant tout le reste, elles prennent une trentaine de secondes.

Un rabais ne s’applique pas au paiement#

Descendez cette liste dans l’ordre. Elle est classée selon la fréquence à laquelle chaque cause se révèle être la vraie.

1. Le rabais est un brouillon ou archivé#

Seuls les rabais Actifs (Active) sont écrits dans votre boutique. Mettre un rabais en brouillon ou l’archiver le retire de la configuration de vos produits, alors le paiement cesse de le voir.

Correctif : ouvrez le rabais et cliquez sur Activer le rabais (Activate discount) dans l’en-tête de la page, puis confirmez avec Activer (Activate). Mettre le menu déroulant Statut (Status) de la colonne de droite à Actif (Active) et cliquer sur Enregistrer (Save) fait la même chose.

2. Le produit dans le panier n’est pas ciblé#

Ouvrez le rabais et lisez la section Produits inclus (Included products).

• Un produit ajouté au complet couvre toutes les variantes, y compris celles que vous ajoutez plus tard dans Shopify. Sa ligne indique Les 4 variantes, y compris celles ajoutées plus tard.
• Un produit restreint à certaines variantes indique 2 variantes sur 4. Seules ces variantes sont en rabais.

Correctif : cliquez sur Parcourir (Browse) pour rouvrir le sélecteur, ou déployez Variantes (4) (Variants) sur le produit et cochez celles que vous voulez. Cocher la dernière variante non cochée ramène le produit au ciblage du produit complet.

3. Une condition n’a pas été remplie#

Les conditions vivent dans la section Conditions du rabais, et il y en a exactement trois.

Quatre choses prennent les gens par surprise :

• Les bornes sont inclusives. Un Articles minimum (Minimum items) de 3 veut dire qu’un panier d’exactement 3 se qualifie.
• Il n’y a aucun regroupement. Les lignes se replient de haut en bas. La première ligne porte l’étiquette Quand (When) et n’a rien à quoi se joindre, chaque ligne suivante porte son propre et ou ou, et il n’y a ni parenthèses ni priorité. La jonction d’une ligne Stock (Inventory) est bloquée sur et.
• Nier cette condition (Negate this condition) inverse cette ligne-là seulement, pas tout l’ensemble.
• Une ligne Stock ne juge pas le panier du tout. Elle retire des variantes du rabais avant même que le paiement s’exécute, alors aucune autre condition ne peut sauver une variante écartée. Voir le point 6.

4. Le rabais est hors de sa période#

Une date de début fixée à aujourd’hui est en vigueur aujourd’hui, et une date de fin fixée à aujourd’hui tient jusqu’à la fin de la journée de votre boutique. Si le calendrier semble décalé d’un jour, rappelez-vous que la comparaison utilise le fuseau horaire de votre boutique, pas le vôtre et pas celui du client.

5. Un autre rabais xDiscount a gagné cet article#

Un seul rabais xDiscount s’applique par article, et le plus petit numéro de priorité gagne. Les nouveaux rabais ont la priorité 10 par défaut.

Correctif : ouvrez les deux rabais et donnez à celui que vous voulez un numéro de Priorité (Priority) plus petit.

6. Une condition Stock ou l’exclusion des ruptures a écarté la variante#

Les deux fonctionnent de la même façon. xDiscount lit le stock de chaque variante ciblée sur le serveur, détermine quelles variantes tombent en dehors de votre plage, et écrit cette liste dans la configuration de vos produits. Le paiement les saute ensuite. Rien n’est relu dans le panier.

Cette réponse est un instantané, et elle peut avoir jusqu’à une journée de retard. Elle est rafraîchie :

• immédiatement, chaque fois que vous ouvrez le rabais et cliquez sur Enregistrer (Save) ;
• une fois par jour, à 03:00 UTC, pour les rabais Actifs (Active) qui utilisent Stock (Inventory) ou Ignorer les produits en rupture de stock (Skip products that are out of stock).

Alors une variante épuisée depuis la dernière vérification est encore en rabais, et une variante que vous avez réapprovisionnée depuis la dernière vérification est encore écartée. Le formulaire le dit à côté de la ligne : « Vérifié par variante de produit quand ce rabais se synchronise, puis une fois par jour. Les variantes hors de la plage sont écartées jusqu’à la prochaine vérification. »

Correctif : ouvrez le rabais et cliquez sur Enregistrer (Save). Ça prend une lecture de stock fraîche tout de suite.

Deux autres choses à savoir. Le stock est compté par variante, jamais additionné sur un produit, alors une taille peut être écartée pendant qu’une autre est en rabais. Et les variantes qui ne suivent pas le stock ne sont jamais écartées, peu importe les bornes que vous fixez.

7. C’était une commande d’abonnement#

xDiscount s’applique aux achats uniques seulement. Les commandes d’abonnement sont exclues volontairement.

8. L’entrée xDiscount dans votre liste de rabais Shopify est disparue ou éteinte#

xDiscount enregistre un rabais automatique dans votre admin Shopify, sous Rabais (Discounts), intitulé xDiscount. Chaque rabais que vous construisez dans l’application passe par lui.

Correctif : ouvrez la liste Rabais (Discounts) de Shopify et cherchez xDiscount. S’il est là mais inactif, activez-le. S’il a complètement disparu, réinstallez l’application, ce qui l’enregistre de nouveau.

9. La configuration ne s’est jamais terminée#

Si l’Accueil (Home) affiche une bannière rouge intitulée Votre boutique n’est pas complètement configurée (Your store isn’t fully set up), une partie de l’installation ne s’est pas terminée et les rabais ne peuvent vraiment pas s’appliquer. Cliquez sur Relancer la configuration (Retry setup) sur la bannière. Elle relance la même configuration depuis l’intérieur de l’application, et la bannière disparaît dès que chaque étape réussit. Si ça échoue encore après une relance, réinstaller l’application l’exécute une fois de plus avec des permissions fraîches. La bannière nomme les étapes qui ont échoué, alors gardez cette liste si vous devez la signaler.

Le cas particulier de la livraison gratuite#

La livraison gratuite est traitée séparément des rabais sur les produits, alors elle a deux exigences de plus. Un produit ciblé doit être dans le panier, parce que la livraison gratuite est rattachée à des produits comme tous les autres types, alors un panier vide n’obtient rien. Et le panier doit avoir une livraison, parce que les paniers de produits numériques ou de cueillette en magasin n’ont aucune option de livraison, alors il n’y a rien à mettre en rabais. Quand elle s’applique, elle enlève 100 % des frais de livraison, pour chaque groupe de livraison du panier.

La carte d’offre ne s’affiche pas sur une page produit#

1. Le bloc n’est pas sur votre thème en ligne#

Allez dans Paramètres (Settings), puis Carte d’offre en vitrine (Storefront offer card), et lisez le badge.

Quatre situations comptent comme pas ajouté : le bloc est sur un thème qui n’est pas votre thème en ligne publié, et publier un nouveau thème veut dire l’ajouter de nouveau ; le bloc est présent mais éteint dans l’éditeur de thème ; votre thème n’a pas de gabarit de produit moderne, car les anciens thèmes « vintage » ne peuvent pas accueillir de blocs d’application du tout ; ou le bloc a été ajouté à un gabarit de produit personnalisé, et xDiscount ne vérifie que le gabarit de produit par défaut, alors le badge peut indiquer Désactivé (Off) pendant que la carte s’affiche parfaitement sur les produits qui utilisent votre gabarit personnalisé.

Une lecture de thème qui échoue dans l’API même de Shopify aboutit à Vérification impossible (Couldn’t check), jamais à Désactivé (Off), et la carte dit en une ligne ce qui a mal tourné. Si vous savez que le bloc est là et que le badge indique encore Désactivé, cliquez sur Vérifier de nouveau avant de l’ajouter une deuxième fois. Si ça persiste, dites au soutien quel thème vous utilisez, parce que la vérification lit le gabarit de produit par défaut de votre thème en ligne, quelle que soit sa taille.

2. Ce produit n’a aucune offre en cours en ce moment#

La carte est filtrée avant d’afficher quoi que ce soit. Aucun rabais en cours et dans sa fenêtre sur ce produit veut dire aucun balisage du tout, pas de carte vide et pas de titre. Vérifiez que le rabais est Actif (Active), que le produit est ciblé, et qu’aujourd’hui tombe à l’intérieur de la Période du rabais (Discount period).

3. La configuration n’a pas encore atteint ce produit#

La carte lit exactement la même configuration que le paiement. Si la colonne Synchronisation (Sync) n’indique pas Synchronisé (Synced), la carte montre encore la dernière configuration qui a bel et bien atteint votre boutique, ou rien du tout si aucune ne l’a jamais fait.

4. La carte est là mais elle a l’air fausse#

L’apparence de la carte se règle dans l’éditeur de thème, sur le bloc xDiscount offer, sous Texte (Text), Couleurs (Colours), Taille et espacement (Size and spacing) et Affichage (Display). Une couleur vide veut dire « hérite de votre thème », alors si la carte a soudainement une couleur que vous ne vouliez pas, cherchez un échantillon rempli sous Couleurs et videz-le. Largeur de la carte (Card width) réglée sur autre chose que Pleine largeur (Full width) plafonne la largeur de la carte, et Pleine largeur ne plafonne rien.

Je ne trouve pas l’aide#

Il y a un bouton d’aide flottant sur chaque écran de l’application, un bouton rond de clavardage (chat) dans le coin inférieur droit. Il est là sur l’Accueil, les Rabais, la page d’un rabais, les Analyses et les Paramètres.

À quoi vous attendre :

• Envoyer le message (Send message) n’est jamais grisé. S’il manque quelque chose, cliquer dessus marque d’un coup tous les champs à corriger et vous dit pourquoi. Il ne retient jamais la raison.
• En cas de succès, vous obtenez Message envoyé (Message sent) et une référence. Citez-la si vous nous réécrivez au sujet de la même chose. Envoyer un autre message (Send another message) vide le formulaire.
• En cas d’échec, vous obtenez Non envoyé (Not sent) avec la raison, et tout ce que vous avez tapé est encore là. Cliquez de nouveau sur Envoyer le message.
• Fermer le panneau, avec le bouton de fermeture, la touche Échap (Escape) ou un clic à l’extérieur, ne jette pas un message à moitié tapé. Rouvrez-le et votre brouillon est exactement où vous l’avez laissé.

Un changement n’atteint pas la vitrine#

La configuration de votre boutique est réécrite chaque fois que vous enregistrez ou supprimez un rabais, et une fois par jour pour les rabais qui dépendent du stock. Rien d’autre ne la réécrit, ni un changement de forfait ni une visite de page.

Réenregistrer un rabais est la réparation universelle. Ça relit votre forfait, revérifie le stock, et réécrit chaque produit que le rabais cible.

La synchronisation indique Échec ou Trop volumineux#

L’enregistrement réussit toujours localement, et un envoi raté vers Shopify ne jette jamais votre travail. Il est plutôt noté sur la ligne.

L’Accueil (Home) vous les signale avec une bannière rouge intitulée Certains rabais n’atteignent pas votre boutique (Some discounts aren’t reaching your store) et un bouton Les examiner (Review them) qui ouvre Rabais (Discounts) déjà filtré. Vous pouvez aussi filtrer vous-même : le bouton Filtrer (Filter) offre les facettes Statut (Status) et Synchronisation (Sync), et Synchronisation liste Synchronisé, En attente, Échec et Trop volumineux.

À propos de Trop volumineux. Le message vous donne la taille exacte :

Cette configuration de rabais fait 10 412 octets, au-delà de la limite de 10 000 octets de Shopify pour les fonctions de rabais. Shopify l’enregistrerait mais le rabais ne s’appliquerait jamais au paiement. Réduisez le nombre de variantes ciblées ou de règles et réessayez.

Cette limite s’applique à un produit, en comptant tous les rabais qui le ciblent, pas à un seul rabais isolé. Alors ciblez des produits complets plutôt que de longues listes de variantes individuelles, utilisez moins de conditions, utilisez moins de produits cadeaux sur un Achetez X, obtenez Y, et faites tourner moins de rabais sur le même produit. Une condition Stock (Inventory) ajoute la liste des variantes écartées par-dessus tout le reste, alors elle coûte des octets elle aussi.

xDiscount refuse l’écriture plutôt que de la tronquer, parce qu’une configuration enregistrée mais trop grosse est le pire résultat de tous : on montre aux clients une offre qui ne pourra jamais s’appliquer, et rien ne signale d’erreur.

Vous avez atteint une limite de forfait#

Les brouillons ne sont jamais bloqués par la limite de rabais actifs, parce que seul ce qui est en ligne au paiement compte. Et une commande avec rabais ne compte que si xDiscount a vraiment réduit le prix, alors les commandes auxquelles il n’a pas touché ne comptent jamais.

Connect AI refuse#

D’autres choses à vérifier. Le point d’accès est /mcp sur l’adresse de cette application, et Paramètres (Settings), puis Connect AI, le dit sous l’état de la clé. Le badge Clé créée, pas encore utilisée (Key created, not used yet) veut dire qu’aucun client n’a jamais appelé avec cette clé, alors le problème est du côté du client, pendant que Non connecté (Not connected) veut dire qu’aucune clé n’existe du tout. Une clé est affichée une seule fois, sous la bannière Copiez-la maintenant, elle ne sera plus affichée (Copy this now, it won’t be shown again), et seul un hachage en est conservé, alors une clé perdue ne peut pas vous être relue et il vous en faut une nouvelle.

Une offre est estompée et indique « Non offert pour la variante sélectionnée »#

C’est la carte qui fait son travail. Le client a sélectionné une variante que le rabais ne couvre pas : soit vous avez restreint le rabais à d’autres variantes, soit cette variante a été sautée par Sauter les produits en rupture de stock (Skip products that are out of stock) ou par une condition de Stock lors de la dernière vérification. Le paiement la facturerait plein tarif, alors la carte le dit plutôt que d’annoncer l’offre. Choisir une variante couverte fait revenir la tuile.

Pour couvrir la variante, ouvrez le rabais, dépliez le produit sous Produits inclus et cochez-la. Pour un saut de stock, réapprovisionnez-la ; la prochaine vérification quotidienne, ou l’ouverture du rabais suivie d’un clic sur Enregistrer, la reprend.

Les clients n’arrivent pas à ajouter le cadeau#

Achetez X, obtenez Y est le seul type avec une dépendance stricte. Un rabais ne peut pas mettre un article dans un panier, alors c’est la carte d’offre en vitrine qui y met le cadeau. Sans la carte sur votre thème, un client n’a aucun moyen de le réclamer.

Descendez cette liste :

1. La carte d’offre est-elle sur votre thème en ligne ? Voir La carte d’offre ne s’affiche pas ci-dessus. La carte est incluse dans tous les forfaits, Free compris, alors la seule question est de savoir si le bloc est sur le gabarit de produit de votre thème en ligne.
2. Avez-vous choisi des produits cadeaux ? Le formulaire avertit : « Aucun cadeau choisi pour l’instant, les clients ne peuvent pas réclamer cette offre tant que vous n’en choisissez pas un. » L’enregistrer comme Actif (Active) sans cadeau est bloqué net.
3. Un cadeau a-t-il perdu sa variante ? La validation dit : « Un de vos cadeaux n’a pas de variante. Retirez-le et choisissez-le de nouveau. » Un cadeau sans variante est écarté en vitrine, alors son bouton ne s’affiche jamais.
4. Cliquer sur un cadeau ne fait rien ? Le bouton se désactive lui-même, tente d’ajouter l’article, puis se réactive si l’ajout a échoué. Les causes habituelles sont un produit cadeau qui n’est pas publié sur votre boutique en ligne, ou une variante épuisée depuis l’ouverture de la fenêtre. Une variante déjà épuisée à l’ouverture de la fenêtre ne se rend pas jusque-là : elle est grisée et marquée Épuisé (Sold out), et elle ne peut pas être cliquée.
5. Le panier ne s’est pas mis à jour visiblement ? La carte ajoute le cadeau puis demande à votre thème de rafraîchir son propre panier. Certains thèmes n’écoutent pas, alors rechargez la page ou ouvrez le panier pour confirmer que le cadeau est là.
6. Le cadeau a-t-il été ajouté autrement ? Un cadeau ajouté depuis sa propre page produit, ou restauré d’un ancien panier, n’est pas marqué comme cadeau et n’est pas en rabais. Il doit venir des boutons cadeau de la carte.
7. Le produit déclencheur est-il encore dans le panier ? Le cadeau n’est en rabais que pendant qu’un produit portant ce rabais Achetez X, obtenez Y est dans le panier à côté de lui.
8. Combien de cadeaux attendiez-vous ? Nombre d’articles cadeaux (Number of gift items) plafonne le cadeau pour tout le panier. S’il est vide ou inutilisable, le plafond est 1, jamais illimité.
9. Le cadeau est-il au bon prix ? Achetez X, obtenez Y est un pourcentage de rabais sur le cadeau. Pour un cadeau vraiment gratuit, mettez Pourcentage de rabais sur le cadeau (Percentage off the gift) à 100.

Avant de demander de l’aide#

Utilisez le bouton d’aide flottant dans le coin inférieur droit, puis Questions. Quand vous signalez un problème, ayez ceci sous la main :

• Le nom du rabais, son Statut (Status) et son badge de Synchronisation (Sync) dans le tableau Rabais (Discounts).
• L’adresse de la page produit où vous attendiez l’offre, et votre forfait sous Forfaits et facturation (Plans & billing) dans Paramètres (Settings).
• Le libellé exact de toute bannière ou de tout message d’erreur, y compris les noms d’étapes listés si l’Accueil (Home) a affiché Votre boutique n’est pas complètement configurée.
• Votre référence d’un message précédent, si c’est un suivi.