Snap Bundle : mon offre ou mon widget ne s'affiche pas

Analysez dans l'ordre suivant une offre ou un widget Snap Bundle qui ne s'affiche pas sur votre vitrine : les blocs d'application du thème et l'intégration 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. Un widget manquant ne génère donc presque jamais d'erreur à l'écran.

Vérifier les blocs d'application du thème et l'intégration d'application

Lorsqu'un widget ne s'affiche jamais, il manque généralement un bloc d'application du thème, plutôt qu'il ne soit mal configuré. Chaque type de bundle nécessite l'ajout de son bloc au thème une seule fois ; seuls les types de bundle dont le bloc a été ajouté peuvent être affichés sur votre vitrine.

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

• Offre de volume / sélecteur de quantité → 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

• Page de création de bundle → chargée par l'intégration 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'offres : Ajoutez la table d'offres à votre boutique, accompagné du message « Pour afficher la table d'offres à vos clients, vous devez ajouter notre bloc d'application à votre thème. » Cliquez sur Ajouter un bloc d'application pour ouvrir l'éditeur de thème.

Les blocs Fixed Bundle, Mix & Match, Volume Offer Table et Product Add-on chargent leurs propres scripts et ne dépendent pas de l'intégration d'application globale. Seule la page de création de bundle nécessite cette intégration. Pour confirmer l'intégration, vérifiez État de l'application dans le tableau de bord : il indique Activé ou Désactivé, et affiche « L'intégration d'application est activée. Vos offres sont visibles sur la vitrine. » lorsqu'elle est activée. Ouvrez l'éditeur de thème si elle est désactivée. La configuration est expliquée dans SnapBundle : Guide de démarrage rapide.

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 dépassée, elle n'est pas active ou elle ne cible pas la page, le produit, la variante ou le client concerné. Lorsqu'aucune offre ne correspond, Snap Bundle efface le widget sans afficher de message.

Vérifiez les paramètres suivants pour le type d'offre :

• Statut et calendrier. Une offre est éligible uniquement lorsque l'heure actuelle se situe entre ses dates de début et de fin (les deux limites sont incluses) ou, lorsqu'aucune date de début n'est définie, lorsque son statut est actif. Une offre mise en pause ne s'affiche pas.

• Ciblage des produits et des collections. Une offre sur une page produit doit correspondre à un produit présent sur cette page. Les offres de volume correspondent également au niveau de la variante : une offre SPECIFIC_PRODUCTS exige que le produit actuel et la variante actuelle figurent parmi les variantes configurées. Mix & Match correspond aux ID de produits et aux ID de collections configurés. Lorsqu'aucune offre ne correspond à la page, l'offre active la plus récente est utilisée uniquement si son affichage est configuré pour apparaître sur tous les produits.

• Tags client. Pour une offre de volume limitée par des tags client, l'acheteur doit posséder au moins l'un des tags configurés, sinon la table ne s'affiche pas. Consultez Comment afficher votre offre de volume uniquement à un groupe de clients spécifique/à des clients B2B ?.

• Priorité et ancienneté. Les offres de volume sont examinées par ordre de priorité croissant, tandis que Fixed Bundle et Mix & Match le sont de la plus récente à la plus ancienne. Une offre plus prioritaire ou plus récente peut donc prendre le dessus sur celle que vous vous attendez à 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 les variantes ne sont pas disponibles

Lorsque tous les éléments d'un bundle sont en rupture de stock, Snap Bundle masque ou efface le widget au lieu de l'afficher comme désactivé. Vérifiez si le produit ou la variante actuellement sélectionnée pour la page actuelle n'est pas disponible.

• Fixed Bundle : les options de variantes indisponibles sont désactivées et un produit sans variante disponible affiche Épuisé. Le bouton d'ajout du bundle est désactivé lorsqu'une variante choisie n'est pas disponible et, si aucun produit du bundle ne possède de variante disponible, le widget entier est masqué.

• Mix & Match : un produit actuel ou une variante sélectionnée indisponible efface le widget. L'action principale est désactivée tant qu'un élément sélectionné n'est pas disponible.

• Offre de volume / sélecteur de quantité : une variante actuelle indisponible masque la table. Dans la console du navigateur, le message SnapBundle: Variant not found or not available est enregistré avant le masquage de la table.

• Upsell post-achat : l'offre post-achat n'est pas filtrée selon le stock avant son affichage. Si un acheteur choisit un article que Shopify ne peut pas traiter, la caisse renvoie l'erreur visible par le client Rupture de stock, et l'acheteur doit choisir une autre option ou supprimer l'article.

Les sélecteurs de position personnalisée et de masquage ne fonctionnent pas

Snap Bundle positionne un widget ou masque un élément du thème en recherchant 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, sans qu'aucune erreur Snap Bundle ne s'affiche à l'écran.

Pour la Volume Offer Table, ouvrez Paramètres de la 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 à l'endroit où la table doit apparaître. Un sélecteur valide qui ne correspond à aucun élément ignore silencieusement le repositionnement ; la table reste donc à son emplacement par défaut. La même vérification s'applique aux paramètres du bouton Ajouter au panier du thème lorsque l'option de masquage est activée : un sélecteur qui ne correspond à aucun élément laisse le bouton du thème visible. Examinez à nouveau l'élément et copiez le sélecteur le plus spécifique possible. Consultez Comment masquer le bouton Ajouter au panier de votre thème pour éviter les doublons avec Snap Bundle, qui explique également comment restaurer un élément masqué.

Pour un Fixed Bundle, l'échec de la position personnalisée est enregistré dans la console du navigateur sous la forme SnapBundle: Error: Custom position not found lorsque le sélecteur ne correspond à aucun élément. Le widget continue de s'afficher dans sa racine d'origine. S'il apparaît au mauvais endroit, corrigez ou effacez le champ Position CSS.

Bundle at Checkout ne s'affiche pas

Bundle at Checkout est une extension de caisse Shopify, et non un bloc de thème. L'intégration d'application ne le contrôle donc pas. Cette fonctionnalité est disponible uniquement dans les boutiques Shopify Plus et doit être activée dans Snap Bundle, puis placée dans l'éditeur de caisse.

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

L'affichage dans la caisse dépend également de conditions. Par défaut, le bundle apparaît sans condition ; si vous le configurez sur Afficher selon des conditions, toutes les conditions doivent être remplies pour Toutes les conditions remplies, et au moins une pour Une condition remplie. Les conditions prises en charge vérifient le fournisseur du produit, le tag du produit, la collection du produit, le total du panier, le sous-total du panier, la quantité du panier, la connexion du client, le pays d'expédition, la devise et la langue. Si le bundle apparaît pour les mauvais acheteurs, réévaluez les règles de condition.

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

L'upsell post-achat ne s'affiche pas

Votre upsell post-achat reste invisible tant que Snap Bundle n'est pas sélectionné comme application post-achat dans les paramètres de caisse Shopify. Corrigez d'abord cette sélection, puis vérifiez à nouveau les conditions de déclenchement de l'offre.

Lorsque Snap Bundle n'est pas l'application post-achat sélectionnée, l'éditeur d'offres affiche : Snap Bundle n'est pas l'application sélectionnée sur la page post-achat de la caisse, accompagné du message « Votre offre post-achat ne sera pas visible. Pour l'afficher, sélectionnez l'application Snap Bundle dans les paramètres de caisse de votre boutique. » Cliquez sur Ouvrir les paramètres de caisse pour accéder au paramètre de la page post-achat, sélectionnez-y Snap Bundle, puis revenez à l'éditeur d'offres. Cette procédure est également expliquée dans Configurer l'upsell post-achat.

L'offre elle-même doit également 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 de 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, aucun upsell n'est proposé et rien ne s'affiche.

Toujours rien ?

Deux situations d'échec méritent d'être écartées 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 Erreur lors de la récupération du bundle, tandis que Volume et Mix & Match affichent Échec de l'ajout au panier ou Une erreur s'est produite lorsque Shopify rejette la demande. Réessayez, puis vérifiez que chaque produit de l'offre peut être acheté.

• Flux de code de réduction. Si vous avez 25 réductions automatiques actives, les offres plus récentes passent au flux de code de réduction. Cela ne change rien sur la vitrine : l'offre est toujours ajoutée automatiquement au panier. Consultez Que signifie le passage au flux de code de réduction ?.

Besoin d'aide supplémentaire ?

Si le widget ne s'affiche toujours pas après ces vérifications, contactez notre équipe d'assistance à l'adresse [email protected] ou via notre chat en direct, en joignant un lien vers la page de la vitrine et une description de la configuration de l'offre.