Référence de configuration des montées en gamme d'abonnement

Cette page rassemble les règles détaillées derrière l’assistant de configuration des Subscription Upgrades : comment les prix sont calculés, comment se comportent les options de timing et de remise, le déclencheur d’éligibilité, et pourquoi le produit de l’offre est un produit de substitution. Pour le guide pas à pas, consultez Configurer les montées en gamme d’abonnement. À l’Étape 1, Test API key valide votre token auprès de votre fournisseur, en vérifiant qu’il s’authentifie correctement, qu’il détient tous les scopes requis et qu’il appartient à votre boutique. Le résultat affiche l’un des deux états suivants :

• Coche verte, « API key verified ». Le token s’est authentifié, tous les scopes requis sont présents et le token appartient à votre boutique. Continue est activé.
• Icône d’annulation rouge. La vérification n’a pas abouti correctement. Le message à côté de l’icône indique laquelle des deux situations s’est produite : votre fournisseur a rejeté le token (révoqué, ou scopes requis manquants, et le message nomme le problème précis), ou Aftersell n’a pas pu terminer la vérification (« Could not verify the API key. Please try again. »), ce qui correspond à un appel échoué plutôt qu’à un mauvais token. Corrigez le token s’il a été rejeté ; sinon, testez simplement à nouveau.

Il n’existe pas de troisième état plus nuancé, et un résultat « impossible de vérifier » ressemble exactement à un rejet ; lisez donc le message plutôt que l’icône. Continue reste désactivé tant que la vérification n’est pas verte. Modifier le fournisseur ou le token efface le résultat précédent, retestez donc après chaque modification. Ce contrôle existe pour éviter des échecs de montée en gamme d’abonnement qui, sinon, n’apparaîtraient qu’après que le client a été débité. L’assistant configure automatiquement un déclencheur unique pour vous ; vous n’avez pas besoin de le configurer manuellement : Tous les déclencheurs activés utilisent une logique ET : chaque condition doit être remplie pour que le funnel s’affiche. Vous pouvez ajouter d’autres déclencheurs facultatifs dans l’étape Triggers de l’éditeur de funnel (regroupés dans une section repliable Additional triggers qui affiche un compteur et s’ouvre automatiquement lorsque des déclencheurs facultatifs sont définis). Le Recurring subtotal de l’offre indique au client le coût de son prochain renouvellement. Le produit dont ce prix est tiré dépend du type de montée en gamme : C’est la source de confusion la plus fréquente. Une montée en gamme portant uniquement sur la fréquence conserve le même produit par conception ; son recurring subtotal ne peut donc afficher que le prix du produit déclencheur, quelle que soit la fréquence définie. Si vous vous attendiez à y voir le prix d’un autre produit, vous souhaitez très probablement utiliser plutôt Both, change frequency and replace subscription product. La quantité utilisée provient de Override subscription quantity, qui n’apparaît que sur les types de remplacement. Pour une montée en gamme portant uniquement sur la fréquence, elle est toujours de 1. Par défaut, une montée en gamme prend effet à partir du prochain cycle de facturation du client, en conservant sa date de renouvellement existante. Si l’option de timing est activée pour votre boutique, une case à cocher apparaît sous les champs de fréquence :

My fulfillment provider ships the upgraded item on the current order

En la cochant, le nouvel intervalle de facturation démarre immédiatement plutôt qu’au prochain renouvellement, et cela débloque le champ One-time upgrade price à l’Étape 4. Une incitation facultative appliquée à chaque renouvellement futur de l’abonnement amélioré (pas seulement au premier cycle). Non disponible pour le type d’ajout d’article. L’affichage du champ dépend de la présence de politiques de tarification par paliers sur le selling plan sélectionné :

• Lorsqu’un selling plan avec des paliers de remise est sélectionné (par exemple, un plan Loop qui applique $20 de réduction sur le premier prélèvement et $10 de réduction à partir du deuxième), le champ de saisie libre est remplacé par une liste de boutons radio, un par palier. Chaque option affiche le montant de la remise et la plage de prélèvements à laquelle elle s’applique (par exemple, « Charge 1 » ou « Charge 2 onward »). Sélectionnez le palier à appliquer à chaque renouvellement futur.
• Lorsqu’aucun selling plan n’est sélectionné, ou que le plan sélectionné n’a pas de paliers de remise, le champ de saisie libre standard apparaît. Saisissez le montant et choisissez Percentage ou Fixed amount.

Le One-time upgrade price est ce que le client paie sur cette commande Shopify lorsqu’il accepte.

• Sur les types Change delivery or billing frequency et Both, il est verrouillé à 0 par défaut, car votre fournisseur d’abonnement facture à la fin du cycle de facturation en cours et le produit de substitution apparaît sur la commande Shopify à $0.00. Il ne devient modifiable que lorsque la case de timing de montée en gamme de l’Étape 3 est cochée.
• Sur Replace with a different subscription product et Add another subscribable item to subscription, la case de timing ne s’applique pas, le champ de prix est donc toujours modifiable.

Ce qu’il faut y saisir dépend du type de montée en gamme :

• Fréquence, remplacement, ou les deux : la différence de prix entre l’abonnement d’origine et l’abonnement amélioré. Le client conserve son abonnement et ce prélèvement couvre l’écart.
• Ajout d’un autre article abonnable : le prix de l’article ajouté sur cette commande. Rien n’est échangé, il n’y a donc pas de différence à calculer : c’est simplement ce que le client paie maintenant pour le nouvel article, qui se renouvelle ensuite avec son abonnement. Consultez Ajouter un article à un abonnement existant.

First-order discount. Une remise facultative appliquée uniquement à cet achat de montée en gamme, saisie en pourcentage (%) ou en montant fixe. Elle se trouve à côté de One-time upgrade price et apparaît chaque fois que ce champ est modifiable, sur les onglets Create new comme Pick existing. Sur le type d’ajout d’article, le champ apparaît toujours mais est systématiquement enregistré à 0 ; les offres d’ajout d’article ne comportent jamais de remise, définissez donc plutôt le prix souhaité sur le produit de l’offre. Le produit de l’offre est uniquement un produit de substitution visuel, et non un véritable produit acheté par le client. Shopify ne permet pas d’afficher un produit d’abonnement comme upsell post-achat après une commande contenant déjà un abonnement ; Aftersell capture donc le prix entre les montées en gamme à l’aide d’un SKU de substitution sans abonnement.

• L’image, le titre et le prix que vous définissez apparaissent dans la carte de l’offre.
• Lors de l’acceptation, le prix affiché est facturé sur la commande Shopify, et Recharge, Skio ou Loop applique la véritable montée en gamme à l’abonnement lors de son prochain cycle.
• Si vous choisissez Pick existing au lieu d’en créer un, le produit doit prendre en charge l’achat ponctuel ; les produits disponibles uniquement en abonnement sont filtrés du sélecteur.