Snap Bundle : Mon offre ou mon widget n’apparaît pas

Pour résoudre le problème d’une offre ou d’un widget Snap Bundle qui n’apparaît pas sur votre boutique dans cet ordre : les blocs d’application du thème et l’extension d’application, l’éligibilité de l’offre, la disponibilité des produits et des variantes, les sélecteurs de position personnalisée et de masquage, le bloc Bundle at Checkout, puis la sélection de l’application post-achat. La plupart des échecs de Snap Bundle sont silencieux — l’espace du widget reste simplement vide — donc l’absence d’un widget n’est presque jamais une erreur affichée à l’écran.

Vérifiez les blocs d’application du thème et l’extension d’application

Un widget qui n’apparaît jamais n’a généralement pas un bloc d’application du thème, il n’est pas mal configuré. Chaque type de bundle doit avoir son bloc ajouté une fois au thème ; seuls les types de bundle dont le bloc a été ajouté peuvent être affichés sur votre boutique.

Dans le tableau de bord Snap Bundle, ouvrez la section Blocs de bundle dans votre thème. Un bloc installé affiche Configurer et Activé ; un bloc manquant affiche Ajouter un bloc et Désactivé. Le widget a besoin de ce bloc et de sa racine de page :

• Fixed Bundle → le bloc Fixed Bundle, rendu dans la racine de page #snapbundle-fixbundle

• Mix & Match → le bloc Mix & Match Bundle, rendu dans #snapbundle-mixmatchbundle

• Volume offer / Quantity Selector → le bloc Volume Offer Table, utilisé à la fois pour les offres de volume et les paliers de quantité

• Product Add-on → le bloc Product add-ons, rendu dans #snapbundle-product-add-on

• Bundle builder page → chargé par l’extension d’application globale SnapBundle dans la racine de page #snb-page-content

Un bloc Volume Offer Table manquant affiche un avertissement dans l’éditeur d’offre : Ajouter le tableau d’offre à votre boutique, avec le message « Pour afficher le tableau d’offre à vos clients, vous devez ajouter notre bloc d’application à votre thème. » Cliquez sur Ajouter le bloc d’application pour ouvrir l’éditeur de thème.

Le Fixed Bundle, le Mix & Match, le Volume Offer Table et le bloc Product Add-on chargent leurs propres scripts et ne dépendent pas de l’extension d’application globale. Seule la page Bundle builder nécessite l’extension. Pour confirmer l’extension, vérifiez Statut de l’application dans le tableau de bord — il indique Activé ou Désactivé, avec « L’extension d’application est activée. Vos offres sont visibles sur la boutique. » lorsqu’elle est activée — et ouvrez l’éditeur de thème si elle est désactivée. La configuration est expliquée dans SnapBundle: Quick Start Guide.

L’offre est inactive ou ne correspond pas à la page

Une offre qui passe la vérification de son bloc mais ne s’affiche toujours pas a généralement échoué à une vérification d’éligibilité : sa période est expirée, elle n’est pas active, ou elle ne cible pas la page, le produit, la variante ou le client. Lorsqu’aucune offre ne correspond, Snap Bundle vide le widget sans afficher de message.

Vérifiez ces paramètres pour le type d’offre :

• Statut et planification. Une offre n’est éligible que lorsque l’heure actuelle se situe entre sa date de début et sa date de fin (les deux limites étant inclusives), ou, lorsqu’aucune date de début n’est définie, lorsque son statut est actif. Une offre en pause n’est pas affichée.

• Ciblage des produits et des collections. Une offre sur une page produit doit correspondre à un produit de cette page. Les offres de volume correspondent aussi au niveau de la variante : une offre SPECIFIC_PRODUCTS exige que le produit actuel et la variante actuelle fassent tous deux partie des variantes configurées. Mix & Match correspond aux ID de produits et d’ensembles configurés. Lorsqu’aucune offre ne correspond à la page, l’offre active la plus récente n’est utilisée que si l’affichage de l’offre est défini sur tous les produits.

• Tags client. Pour une offre Volume limitée par des tags client, l’acheteur doit posséder au moins un tag configuré, sinon le tableau n’est pas affiché. Voir Comment afficher votre offre Volume uniquement à un groupe de clients spécifique/aux clients B2B ?.

• Priorité et récence. Les offres de volume sont prises en compte par priorité croissante, et Fixed Bundle ainsi que Mix & Match par ordre du plus récent au plus ancien, donc une offre plus prioritaire ou plus récente peut l’emporter sur celle que vous vous attendiez à voir.

• Marchés. Lorsqu’une offre cible des marchés spécifiques, elle est exclue pour tout acheteur dont le marché n’est pas sélectionné.

Les produits ou variantes ne sont pas disponibles

Lorsque tout ce qu’il y a dans un bundle est en rupture de stock, Snap Bundle masque ou vide le widget au lieu de l’afficher désactivé. Vérifiez si le produit ou la variante actuellement sélectionnée pour la page en cours n’est pas disponible.

• Fixed Bundle : les options de variante indisponibles sont désactivées, et un produit sans variante disponible affiche Rupture de stock. Le bouton d’ajout du bundle est désactivé tant qu’une variante choisie est indisponible, et si aucun produit du bundle n’a de variante disponible, tout le widget est masqué.

• Mix & Match : un produit actuel ou une variante sélectionnée indisponible vide le widget. L’action principale est désactivée lorsqu’un élément sélectionné est indisponible.

• Volume offer / Quantity Selector : une variante actuelle indisponible masque le tableau. Dans la console du navigateur, cela enregistre SnapBundle: Variant not found or not available avant que le tableau ne soit masqué.

• Vente incitative post-achat : l’offre post-achat n’est pas filtrée selon le stock avant d’être affichée. Si un acheteur choisit un article que Shopify ne peut pas traiter, le passage en caisse renvoie l’erreur visible par le client Rupture de stock, et l’acheteur doit choisir une autre option ou retirer l’article.

Les sélecteurs de position personnalisée et de masquage échouent

Snap Bundle positionne un widget ou masque un élément du thème en faisant correspondre son sélecteur CSS. Lorsque le sélecteur est incorrect, le widget reste à son emplacement par défaut ou l’élément du thème reste visible, et aucun message d’erreur Snap Bundle n’apparaît à l’écran.

Pour le Volume Offer Table, ouvrez Paramètres du Volume Offer Table et vérifiez le bouton Activer la position personnalisée ainsi que son champ Position CSS, qui contient le sélecteur CSS où le tableau doit apparaître. Un sélecteur valide qui ne correspond à aucun élément ignore silencieusement le repositionnement, donc le tableau reste à son emplacement par défaut. La même vérification s’applique aux paramètres Bouton Ajouter au panier du thème lorsque l’option de masquage est activée : un sélecteur qui ne correspond à rien laisse le bouton du thème visible. Réinspectez l’élément et copiez le sélecteur le plus précis possible. Voir Comment masquer le bouton Ajouter au panier de votre thème pour éviter la duplication avec Snap Bundle, qui explique aussi comment restaurer un élément masqué.

Pour un Fixed Bundle, l’échec de la position personnalisée est consigné dans la console du navigateur sous SnapBundle: Error: Custom position not found lorsque le sélecteur ne correspond à aucun élément. Le widget s’affiche quand même dans sa racine d’origine ; s’il apparaît au mauvais endroit, corrigez ou videz le champ Position CSS.

Bundle at Checkout ne s’affiche pas

Bundle at Checkout est une extension de passage en caisse Shopify, pas un bloc de thème, donc l’extension d’application ne le contrôle pas. Il n’est disponible que sur les boutiques Shopify Plus, et il doit être activé dans Snap Bundle puis placé dans l’éditeur de paiement.

Dans les paramètres de Fixed Bundle, ouvrez l’onglet Bundle at Checkout (à côté de Paramètres) et activez le composant de paiement sous Composant de paiement. Cliquez ensuite sur Ajouter au paiement pour ouvrir l’éditeur de paiement Shopify, faites glisser le bloc Bundle at Checkout dans le flux de paiement, puis enregistrez. La configuration complète se trouve dans Configurer Fixed bundle.

L’affichage au paiement est également soumis à des conditions. Par défaut, le bundle s’affiche sans conditions ; si vous le définissez sur Afficher selon des conditions, chaque condition doit être validée pour Toutes les conditions remplies, et au moins une pour Au moins une condition remplie. Les conditions prises en charge vérifient le fournisseur du produit, le tag produit, la collection produit, le total du panier, le sous-total du panier, la quantité du panier, la connexion du client, le pays de livraison, la devise et la langue. Si le bundle s’affiche pour les mauvais acheteurs, revoyez les règles de conditions.

Lorsqu’aucun bundle éligible ou aucun produit configuré n’existe, le passage en caisse n’affiche rien plutôt qu’une erreur. Si le passage en caisse ne peut pas mettre à jour les attributs de commande, Snap Bundle affiche la bannière Les modifications d’attributs ne sont pas prises en charge dans ce passage en caisse.

La vente incitative post-achat ne s’affiche pas

Votre vente incitative post-achat est invisible jusqu’à ce que Snap Bundle soit sélectionné comme application post-achat dans les paramètres de paiement Shopify. Corrigez d’abord cette sélection, puis revérifiez les conditions de déclenchement de l’offre.

Lorsque Snap Bundle n’est pas l’application post-achat sélectionnée, l’éditeur d’offre affiche : Snap Bundle isn't selected app on the checkout post purchase page, avec « Votre offre post-achat ne sera pas visible. Pour l’afficher, sélectionnez l’application Snap Bundle dans les paramètres de paiement de votre boutique. » Cliquez sur Ouvrir les paramètres de paiement pour accéder au paramètre de la page post-achat, sélectionnez Snap Bundle à cet endroit, puis revenez à l’éditeur d’offre. Cela est également expliqué dans Configurer Post purchase up-sell.

L’offre elle-même doit aussi correspondre à la commande. La vérification post-achat confirme les dates de début et de fin de l’offre, le produit et la variante configurés, les tags produit, les tags client, les segments client et la valeur de la commande. Si la commande de l’acheteur ne correspond pas à ces déclencheurs, aucune vente incitative n’est proposée et rien n’apparaît.

Toujours rien ?

Deux états d’échec méritent d’être écartés avant de contacter l’assistance.

• Échecs d’ajout au panier. Un widget peut s’afficher mais échouer lors de l’ajout au panier. Fixed Bundle affiche Error grabbing bundle, et Volume ainsi que Mix & Match affichent Add to cart failed ou An error occurred lorsque Shopify rejette la requête. Réessayez, puis vérifiez que chaque produit de l’offre est achetable.

• Flux de code promo. Si vous avez 25 remises automatiques actives, les offres les plus récentes passent au flux de code promo. Cela ne change rien à la boutique : l’offre est toujours ajoutée automatiquement au panier. Voir Que signifie passer au flux de code promo ?.

Besoin de plus d’aide ?

Si le widget n’apparaît toujours pas après ces vérifications, contactez notre équipe d’assistance à [email protected] ou via notre chat en direct, et incluez un lien vers la page de la boutique ainsi que la manière dont vous avez configuré l’offre.

FAQ