> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pourquoi mon upsell au checkout ne s'affiche-t-il pas ?

> Une analyse complète de toutes les raisons pour lesquelles votre upsell au checkout peut ne pas s'afficher, y compris les problèmes de configuration, de placement, de déclencheurs et de produit/offre.

Les upsells au checkout peuvent ne pas s'afficher pour plusieurs raisons différentes. Suivez les étapes ci-dessous dans l'ordre pour identifier la cause.

<Note>
  Les upsells au checkout ne sont disponibles que pour les marchands Shopify Plus, car l'API Checkout Extensibility de Shopify est réservée aux comptes Plus. Si vous n'êtes pas sur Shopify Plus, les upsells au checkout n'apparaîtront pas, quelle que soit votre configuration. Consultez [Pourquoi ne puis-je pas voir l'onglet checkout ?](/fr/aftersell/why_cant_i_see_the_checkout_tab)
</Note>

<Tip>
  Si un upsell ne s'affiche pas, l'expérience de checkout du client n'est pas affectée — rien ne se casse du côté du client.
</Tip>

***

<div id="where-to-start">
  ## Par où commencer
</div>

La plupart des problèmes d'affichage se résument à l'une de ces quatre causes : le widget n'est pas activé, le bloc d'application n'est pas ajouté/enregistré dans Shopify, le placement ne correspond pas, ou les conditions de déclenchement ne sont pas remplies. Confirmez d'abord les bases :

* Vous êtes sur un plan **Shopify Plus**
* Le widget est **activé** dans l'éditeur Checkout d'Aftersell (l'interrupteur **Enable** en haut à droite des paramètres du widget est activé)
* Le bloc d'application a été **ajouté et enregistré** dans l'éditeur de checkout Shopify
* Le placement sélectionné dans Shopify **correspond** au placement défini dans Aftersell

Si tout cela est confirmé et que l'upsell ne s'affiche toujours pas, passez en revue les causes détaillées ci-dessous.

* [Le widget n'est pas activé ou n'a pas été ajouté au checkout](#widget-is-not-enabled-or-not-added-to-checkout)
* [Incohérence de placement entre Aftersell et Shopify](#placement-mismatch-between-aftersell-and-shopify)
* [Les conditions de déclenchement ne sont pas remplies](#trigger-conditions-are-not-being-met)
* [Il y a un problème de produit ou d'offre](#there-is-a-product-or-offer-issue)
* [Les widgets Shop Pay ne s'affichent pas](#shop-pay-widgets-not-showing)
* [Tester dans l'aperçu de Shopify](#testing-in-the-shopify-preview)
* [Aucun des cas ci-dessus ne s'applique](#nothing-above-applies)

***

<div id="widget-is-not-enabled-or-not-added-to-checkout">
  ## Le widget n'est pas activé ou n'a pas été ajouté au checkout
</div>

Pour qu'un upsell au checkout s'affiche, deux conditions doivent être remplies en même temps :

1. Le widget doit être **activé** dans l'éditeur Checkout d'Aftersell
2. Le bloc d'application doit être **ajouté et enregistré** dans l'éditeur de checkout Shopify

Si l'un des deux manque, le widget n'apparaîtra pas.

**Pour activer le widget dans Aftersell :**

1. Allez dans **Apps → Aftersell → Checkout**
2. Ouvrez le widget d'upsell que vous souhaitez afficher
3. Confirmez que l'interrupteur **Enable** en haut à droite est activé

**Pour ajouter le bloc d'application dans Shopify :**

1. Allez dans **Settings → Checkout** dans votre admin Shopify
2. Cliquez sur **Customize** à côté de votre profil de checkout
3. Cliquez sur **Add app block** et sélectionnez le widget d'upsell Aftersell
4. Positionnez-le à l'endroit où vous souhaitez qu'il apparaisse
5. Cliquez sur **Save** — les modifications ne sont appliquées qu'après enregistrement

***

<div id="placement-mismatch-between-aftersell-and-shopify">
  ## Incohérence de placement entre Aftersell et Shopify
</div>

Une incohérence de placement est l'une des raisons les plus courantes pour lesquelles un upsell au checkout ne s'affiche pas.

Aftersell prend en charge plusieurs placements (**Default placement**, **Additional placement 1**, **Additional placement 2**) afin que vous puissiez exécuter plusieurs widgets du même type sur la même page de checkout. Chaque placement dans Aftersell correspond à un **bloc d'application distinct** dans l'éditeur de checkout Shopify. Le placement sélectionné dans Shopify doit correspondre au placement configuré dans Aftersell.

Si les placements ne correspondent pas, le widget n'apparaîtra pas ou peut s'afficher au mauvais endroit.

**Pour corriger une incohérence de placement :**

1. Dans l'éditeur Checkout d'Aftersell, ouvrez le widget d'upsell et notez quel placement est sélectionné (par exemple, **Additional placement 1**)
2. Dans l'éditeur de checkout Shopify, supprimez le bloc d'application existant pour ce widget
3. Cliquez sur **Add app block**, sélectionnez le widget d'upsell Aftersell et choisissez le **même placement** que celui configuré dans Aftersell
4. Enregistrez vos modifications

[En savoir plus sur la correspondance des placements →](/fr/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)

***

<div id="trigger-conditions-are-not-being-met">
  ## Les conditions de déclenchement ne sont pas remplies
</div>

Si votre widget d'upsell comporte des déclencheurs configurés, il ne s'affichera que lorsque ces conditions seront remplies par le panier. Si le panier ne satisfait pas les conditions de déclenchement, le widget n'apparaîtra pas — c'est le comportement attendu.

Les types de déclencheurs disponibles incluent :

* **Produits / collections spécifiques :** un produit, une variante ou une collection choisis est (ou n'est pas) dans le panier
* **Quantité d'un produit spécifique :** par exemple, 2 exemplaires ou plus d'un produit
* **Balise de produit / type de produit / nom de variante :** un article du panier correspond à une balise Shopify, un type de produit ou un titre de variante (insensible à la casse)
* **Metafield de produit / metafield de variante :** un produit ou une variante du panier possède une valeur de metafield correspondante
* **Sous-total du panier :** le sous-total atteint un seuil (voir la note ci-dessous sur le calcul du sous-total)
* **Quantité du panier :** nombre total d'articles dans le panier
* **Abonnement dans le panier :** si un article du panier est un abonnement
* **Attribut de panier :** une clé/valeur d'attribut au niveau du panier correspond (utile pour les données définies par d'autres applications)
* **Remise appliquée / valeur de la remise :** un code de remise spécifique est appliqué, ou la remise totale atteint un seuil
* **Pays de livraison :** le pays de livraison du client (et éventuellement la province) correspond
* **Langue du client :** la langue du checkout correspond (par exemple, afficher du contenu français uniquement pour les checkouts en français)
* **Balises client :** le client connecté possède les balises requises
* **Type d'appareil :** le client utilise l'appareil configuré (ordinateur ou mobile)

<Note>
  Le **sous-total du panier** utilisé pour l'évaluation des déclencheurs exclut tous les articles déjà ajoutés par des upsells acceptés (ceux marqués avec l'attribut de panier `__as_offer_id`). Ainsi, accepter un upsell ne fera pas, à lui seul, dépasser au sous-total un seuil qui conditionne un autre widget.
</Note>

**Combinaison de conditions :** lorsqu'un widget comporte plusieurs conditions, elles sont reliées par **AND** ou **OR** (à votre choix), et les conditions peuvent être imbriquées en groupes pour une logique plus complexe. Avec une jonction **AND**, chaque condition doit être remplie — une seule condition non satisfaite bloque silencieusement le widget. Avec une jonction **OR**, une seule correspondance suffit. Passez en revue chaque condition individuellement par rapport à votre panier de test.

**Pour dépanner les déclencheurs :**

1. Ouvrez le widget dans l'éditeur Checkout d'Aftersell et passez en revue ses conditions de déclenchement
2. Réglez temporairement le déclencheur sur **Show for all customers** pour confirmer que le widget lui-même fonctionne, puis réactivez vos déclencheurs spécifiques
3. Assurez-vous qu'au moins un widget utilise un déclencheur **Show for all customers** à la priorité la plus basse comme filet de sécurité, afin qu'une offre s'affiche toujours même lorsqu'aucun widget ciblé ne correspond

[En savoir plus sur les déclencheurs de checkout →](/fr/aftersell/checkout_triggers)

***

<div id="there-is-a-product-or-offer-issue">
  ## Il y a un problème de produit ou d'offre
</div>

Même lorsque le widget est activé, correctement placé et que ses déclencheurs correspondent, l'offre elle-même peut être filtrée avant de s'afficher.

<AccordionGroup>
  <Accordion title="Le produit d'upsell est en rupture de stock">
    Si l'inventaire du produit est suivi et qu'aucune variante n'est disponible à la vente, l'offre ne s'affichera pas. Assurez-vous qu'au moins une variante du produit d'upsell a du stock disponible, ou utilisez un produit dont l'inventaire n'est pas suivi.
  </Accordion>

  <Accordion title="Le produit d'upsell est en statut Draft ou Archived">
    Le produit d'upsell doit être un produit actif et vendable. Les produits en statut **Draft** ou **Archived** dans Shopify sont filtrés et n'apparaîtront pas comme offres. Ouvrez le produit dans l'admin Shopify et confirmez que son statut est **Active**.
  </Accordion>

  <Accordion title="Le produit d'upsell est déjà dans le panier et « hide if already in cart » est activé">
    Le paramètre **Hide offer if product already in cart** masque l'offre lorsque ce produit se trouve déjà dans le panier du client. Il est activé par défaut pour les offres de produit standard. Si vous souhaitez que l'upsell s'affiche quoi qu'il en soit, désactivez ce paramètre dans la configuration de l'offre.
  </Accordion>

  <Accordion title="Le produit d'upsell est un abonnement mais n'a aucun plan de vente">
    Si l'option d'achat de l'offre est définie sur **Subscription** mais que le produit n'a aucun plan de vente configuré dans Shopify, l'offre est filtrée. Confirmez que le produit a au moins un plan de vente actif, ou changez l'option d'achat en **One-time purchase**.
  </Accordion>

  <Accordion title="Le produit cible de l'upsell de remplacement n'est pas dans le panier">
    Si l'offre est configurée comme un upsell de remplacement, elle ne s'affiche que lorsque le produit qu'elle est censée remplacer est présent dans le panier. Si ce produit cible n'est pas dans le panier, l'offre ne s'affichera pas. Confirmez que le bon produit cible est sélectionné dans la configuration de l'upsell de remplacement.
  </Accordion>

  <Accordion title="Le nombre maximal d'offres acceptées a été atteint">
    Si **Maximum accepted offers** est défini sur le widget, l'upsell cesse de s'afficher une fois que le client a accepté ce nombre d'offres du widget dans le checkout en cours. C'est intentionnel — une fois la limite atteinte, le widget se masque de lui-même.
  </Accordion>

  <Accordion title="L'offre a déjà été ajoutée au panier par ce widget">
    Pour les upsells **single** et **multi-product**, une fois que le client ajoute le produit de l'offre à son panier, l'offre est masquée (le produit est déjà dans le panier). Les upsells **Checkmark** se comportent différemment — ils restent visibles avec la case cochée après avoir été acceptés.
  </Accordion>
</AccordionGroup>

***

<div id="shop-pay-widgets-not-showing">
  ## Les widgets Shop Pay ne s'affichent pas
</div>

Les widgets de checkout ne s'affichent pas dans Shop Pay par défaut. Pour afficher votre upsell dans Shop Pay, vous devez l'activer explicitement :

1. Ouvrez le bloc d'application d'upsell Aftersell dans l'éditeur de checkout Shopify
2. Dans les paramètres du bloc, trouvez la section **Checkout behaviour**
3. Cochez l'option **Include app block in Shop Pay**
4. Enregistrez vos modifications

[En savoir plus sur les widgets Shop Pay →](/fr/aftersell/show_checkout_widgets_in_shop_pay)

***

<div id="testing-in-the-shopify-preview">
  ## Tester dans l'aperçu de Shopify
</div>

L'aperçu de l'éditeur de checkout Shopify n'affiche pas les widgets de manière fiable. Un widget peut être correctement configuré et ne pas apparaître dans l'aperçu de l'éditeur, car l'aperçu ne peut pas simuler le balisage de la page et les conditions de déclenchement. Ne vous fiez pas à l'aperçu de l'éditeur pour confirmer qu'un widget fonctionne.

**Pour tester votre upsell avec précision :**

1. Réglez temporairement le déclencheur du widget sur **Show for all customers**
2. Passez une véritable commande test en utilisant la passerelle de paiement de test de Shopify (ou un code de remise qui rend la commande gratuite)
3. Confirmez que le widget apparaît pendant le flux de checkout réel
4. Réinitialisez vos déclencheurs après le test

***

<div id="nothing-above-applies">
  ## Aucun des cas ci-dessus ne s'applique
</div>

Si vous avez tout vérifié ci-dessus et que l'upsell ne s'affiche toujours pas, confirmez les points suivants :

* Le widget est **activé** dans Aftersell et le bloc d'application est **ajouté et enregistré** dans l'éditeur de checkout Shopify
* Le **placement** dans Aftersell correspond au placement sélectionné dans Shopify
* Les conditions de déclenchement correspondent à votre panier de test — rappelez-vous qu'avec une jonction **AND**, chaque condition doit être remplie
* Il existe au moins un widget avec un déclencheur **Show for all customers** à la priorité la plus basse comme filet de sécurité
* Le produit d'upsell est **Active**, en stock et (pour les offres d'abonnement) possède des plans de vente actifs
* Vous testez avec un **flux de checkout réel**, et non l'aperçu de l'éditeur Shopify
* Essayez de vider le cache de votre navigateur ou de tester en fenêtre de navigation privée — les modifications peuvent mettre quelques minutes à se propager

Toujours pas résolu ? Contactez-nous via le chat ou par e-mail à [support@aftersell.app](mailto:support@aftersell.app) en incluant une description de la configuration de votre widget et les détails de la commande test.
