Menu de la documentation

Génération de codes de réduction natifs à la boutique

MailInApp prend en charge la génération dynamique de codes de réduction natifs à la boutique pour les boutiques Shopify et WooCommerce connectées.

Vidéo en anglais

Plutôt que de forcer les acheteurs à passer par un paiement tiers ou des coupons publics génériques, MailInApp génère automatiquement des codes de réduction à usage unique, restreints au client, directement sur votre boutique au moment de l'envoi — via l'un ou l'autre de deux mécanismes indépendants, qu'un même projet peut utiliser ensemble, séparément, ou pas du tout :

  • Offre de réduction au niveau du projet — un paramètre de la page d'envoi qui génère un code par destinataire correspondant, portant sur toute votre boutique ou sur un seul produit choisi dans une liste déroulante, conçu pour s'associer à un segment d'audience Historique d'achat. Voir Offre de réduction.
  • Réduction par produit du bloc Produit — un commutateur sur le bloc Produit du Studio lui-même, portant exactement sur l'article que ce bloc a importé depuis votre catalogue, sans nécessiter aucun filtre d'audience ni configuration sur la page d'envoi. Détaillé de bout en bout dans Codes de réduction produit Shopify et Codes de réduction produit WooCommerce.

Les deux génèrent via la même connexion de boutique sous-jacente et partagent la mécanique décrite ci-dessous ; une réduction par produit se contente en plus de restreindre le code à un seul article et conserve son propre marqueur de délai de repos, distinct de celui de l'offre au niveau du projet et de celui de chaque autre bloc Produit.


Comment ça fonctionne

Lorsqu'une campagne ou un parcours inclut une offre de réduction :

  1. Résolution dynamique du client :
    • Shopify : résout l'identifiant GraphQL client (gid://shopify/Customer/...) du destinataire via Admin GraphQL avant de générer le nœud de réduction.
    • WooCommerce : restreint le coupon généré à l'adresse email exacte du destinataire via l'API REST de WooCommerce.
  2. Usage unique et sécurisé :
    • Les codes portent des suffixes cryptographiques aléatoires (par ex. MIA-7F3A91B2).
    • Chaque code est restreint à un usage unique (usage_limit: 1) et lié exclusivement à l'adresse email du destinataire, ce qui empêche toute fuite de coupon vers des sites de bons plans. Seule exception : un code WooCommerce pour un seul produit qui ouvre un lien de paiement reste à usage unique, limité à ce produit et de courte durée, mais n'est pas lié à l'adresse email, car WooCommerce retire d'un lien de paiement un coupon lié à un email tant que l'acheteur n'a pas saisi le sien.
  3. Portée produit facultative :
    • Un code généré à l'échelle de la boutique s'applique à tout achat. Un code limité à un produit — via le sélecteur de portée propre à l'offre au niveau du projet, ou la réduction par produit d'un bloc Produit — est restreint à ce seul article : Shopify via customerGets.items.products.productsToAdd sur un véritable GID de produit, WooCommerce via le champ product_ids du coupon.
  4. Pré-application au paiement de la boutique :
    • Le lien d'un code portant sur toute la boutique ou sur le projet ouvre votre boutique avec le code : Shopify l'applique (/discount/MIA-... redirigeant vers /) ; WooCommerce n'a aucun lien qui applique un code à un panier vide, donc son lien (/cart/?coupon=MIA-...) ouvre le panier et l'acheteur saisit au paiement le code que l'e-mail affiche.
    • La réduction par produit propre à un bloc Produit mène en revanche l'acheteur sur ce produit précis, avec le code déjà appliqué. Sur Shopify, c'est la page du produit (/discount/MIA-...?redirect=<product path>). Sur WooCommerce 10 ou plus récent, c'est un lien de paiement (/checkout-link/?products=<id>:1&coupon=MIA-...) qui met le produit, ou la variante choisie par l'acheteur, dans le panier et ouvre le paiement avec le code appliqué. Une boutique WooCommerce plus ancienne reçoit la page du produit avec ?coupon=MIA-..., et l'acheteur saisit le code au paiement.
  5. Visible avant même que l'acheteur ne clique :
    • Le canevas du Studio affiche le même badge de réduction et le prix barré que l'email envoyé et l'Aperçu en direct dès que vous activez la réduction par produit d'un bloc Produit — inutile d'ouvrir l'Aperçu en direct pour vérifier.
    • Pour les boutiques Shopify, un badge de réduction facultatif affiche ce même badge directement sur la page produit en direct pour un acheteur ayant cliqué depuis l'email, avant le paiement — voir Afficher la réduction sur votre page produit (Shopify) ci-dessous pour la configuration. Il n'existe aucun équivalent WooCommerce — les coupons WooCommerce n'ont aucun mécanisme permettant de modifier ce qu'affiche la page produit elle-même.

Afficher la réduction sur votre page produit (Shopify)

Le canevas du Studio affiche déjà le badge de réduction et le prix barré dès que vous activez la réduction par produit d'un bloc Produit — aucune configuration nécessaire. Placer ce même badge sur votre boutique Shopify en direct est une étape manuelle unique par boutique, puisque MailInApp ne modifie jamais votre thème automatiquement. Vous collez un court extrait de code dans votre page produit ; il n'y a rien à installer :

  1. Dans MailInApp, allez dans Paramètres → Intégrations. Sur la carte de votre boutique Shopify, ouvrez Afficher la remise sur vos pages produit et cliquez sur Copier le code.
  2. Dans l'Admin Shopify, allez dans Online Store → Themes et cliquez sur Customize sur votre thème en direct (ou un brouillon).
  3. Passez le sélecteur de page en haut sur une page Product.
  4. Dans la section Product information, cliquez sur Add block (pas « Add section ») et choisissez Custom Liquid.
  5. Collez le code dans la zone Liquid code du bloc, faites glisser le bloc sous le prix, puis Save.

Le code charge le badge depuis mailinapp.com et lit les prix du produit dans votre thème : il affiche donc le prix de la taille ou de la couleur choisie par l'acheteur, et suit son choix quand il en change. Nécessite un thème Online Store 2.0 (Dawn et ses dérivés ont un bloc Custom Liquid dans leur section produit).

Le badge reste invisible lors d'une visite normale de la boutique, par conception — il ne s'affiche que lorsque la page produit se charge avec le lien signé qu'un véritable email de réduction par produit génère. Donc visiter la page vous-même ne l'affichera pas, et Envoyer un test non plus (cela rend l'email directement et saute l'étape de génération de la réduction qui signe le lien du badge). Pour le voir réellement, effectuez un envoi réel à un destinataire — même à vous-même — et cliquez sur Acheter maintenant depuis l'email reçu. C'est un aperçu d'affichage uniquement, calculé à partir du prix propre de la variante choisie ; la réduction réelle ne s'applique de toute façon jamais qu'au paiement, via le code à usage unique.

Vidéo en anglais

Récompenses différentes par variante

Une expérience peut donner à chacune de ses variantes sa propre offre de boutique, pour tester quelle récompense vend le plus. Les codes sont créés par la même connexion de boutique : un code à usage unique par destinataire, lié à son adresse, sur la boutique connectée à la liste de contacts de l'expérience. Vous les réglez à l'étape Récompense et attribution de l'expérience :

  • Pourcentage de remise, Montant fixe de remise ou Livraison gratuite pour chaque variante. Soit toutes les variantes ont une récompense, soit aucune, et les codes de chaque variante restent valables le même nombre de jours, pour qu'aucune offre n'ait plus de temps pour agir.
  • La Livraison gratuite n'est proposée qu'aux variantes d'une expérience. Sur Shopify, c'est un code de livraison gratuite réservé au destinataire. Sur WooCommerce, c'est un coupon qui offre la livraison, et il ne fonctionne que si la boutique a un mode de livraison Free Shipping réglé pour exiger un coupon de livraison gratuite valide. L'étape vous avertit si votre boutique n'en a pas.
  • Pas de délai de repos. Les codes d'une variante ignorent les marqueurs de délai de repos ci-dessus : chaque destinataire d'une variante reçoit la même offre.
  • Affichés par des balises de fusion. Placez {{discount_code}} ou {{discount_url}} dans un bloc, par exemple dans le lot et le lien d'une carte à gratter. Le verrouillage attend qu'un bloc affiche la récompense. Le lien porte aussi l'expérience et la variante dans sa balise utm_content, pour l'attribution ci-dessous.
  • Un code que la boutique ne peut pas créer ne bloque pas l'envoi. L'e-mail de ce destinataire part sans l'offre, et la carte Codes de récompense de la page de résultats les compte par variante.

Pour la livraison gratuite, saisissez aussi le Coût moyen de livraison par commande. Il est compté comme coût promotionnel pour chaque commande en livraison gratuite. Tester quelle récompense vend le plus avec un test A/B de carte à gratter déroule un exemple complet.

Comment les commandes sont rattachées aux variantes

Chaque commande payée de la boutique est comparée aux règles d'Attribution des commandes de l'expérience, dans un ordre fixe. La première règle qui correspond désigne la variante, et les suivantes ne sont pas vérifiées.

Commande avec le code de la variante

  1. 1Code de réductionLa commande a utilisé le code de la variante. La correspondance la plus forte, même des jours plus tard.Correspond
  2. 2Lien suiviL'acheteur est arrivé par le lien balisé de l'e-mail.Non vérifiée
  3. 3Paiement dans l'e-mailAchat effectué via le paiement d'un bloc produit.Non vérifiée
  4. 4Adresse e-mail (probable)L'adresse de l'acheteur correspond à un destinataire ayant cliqué pendant la fenêtre. Signalé comme probable.Non vérifiée
Vérifications d'attribution d'une commande avec le code de la variante
ÉtapeRègleRésultat
1Code de réductionCorrespond
2Lien suiviNon vérifiée
3Paiement dans l'e-mailNon vérifiée
4Adresse e-mail (probable)Non vérifiée
Vérifications d'attribution d'une commande sans code
ÉtapeRègleRésultat
1Code de réductionNe correspond pas
2Lien suiviNe correspond pas
3Paiement dans l'e-mailNe correspond pas
4Adresse e-mail (probable)Correspond
Chaque commande passe les vérifications dans cet ordre et s'arrête à la première correspondance. Seules les règles choisies avant le verrouillage sont vérifiées, et seules les commandes passées pendant la fenêtre d'observation comptent.
  1. Code de réduction : la commande a utilisé un code envoyé à l'un des destinataires de l'expérience.
  2. Lien suivi : le utm_content de la commande désigne l'expérience et la variante, et l'adresse de l'acheteur fait partie de cette expérience.
  3. Paiement dans l'e-mail : l'acheteur a payé par le paiement propre à un bloc produit de l'e-mail. Une commande de la boutique ne correspond jamais à cette règle.
  4. Adresse e-mail (probable) : l'adresse de l'acheteur est celle d'un destinataire qui a cliqué vers la boutique pendant la fenêtre, avant de commander. Ces commandes sont signalées comme probables.

Les règles sont choisies avant le verrouillage, et seules les règles choisies sont vérifiées. Les trois premières sont activées par défaut. Adresse e-mail (probable) reste désactivée tant que vous ne la choisissez pas. Un groupe exclu, qui ne reçoit aucun e-mail, ne peut être rattaché que par adresse e-mail : choisissez cette règle si vous en avez un. Seules les commandes passées pendant la fenêtre d'observation comptent.

Chiffre d'affaires et coût promotionnel

Les commandes rattachées alimentent la carte Chiffre d'affaires et promotions de la page de résultats, par variante et par devise :

  • Le Chiffre d'affaires est la marchandise de la commande après remises, hors taxes et livraison, moins les remboursements effectués pendant la fenêtre.
  • Le Coût promotionnel correspond aux remises des commandes, plus le coût moyen de livraison saisi pour chaque commande en livraison gratuite.
  • L'Utilisation des codes est le nombre de codes utilisés sur une commande rattachée, divisé par le nombre de codes émis pour les destinataires de la variante.

Chiffre d'affaires

  • Variante A · 10 % de remise5 616 $US
  • Variante B · Livraison gratuite7 056 $US

Coût promotionnel

  • Variante A · 10 % de remise624 $US
  • Variante B · Livraison gratuite539 $US
Pas un calcul de margeHors taxes et livraison. Remises déjà déduites.
Chiffre d'affaires et coût promotionnel par variante, en dollars américains
MesureVariante A · 10 % de remiseVariante B · Livraison gratuite
Chiffre d'affaires5 616 $US7 056 $US
Coût promotionnel624 $US539 $US
Le chiffre d'affaires exclut les taxes et la livraison, et les remises sont déjà déduites. Le coût promotionnel correspond aux remises des commandes, plus le coût de livraison estimé de chaque commande en livraison gratuite. Ce n'est pas un calcul de marge.

Aucun de ces deux chiffres n'est un bénéfice : le coût des produits vendus n'y figure pas. Les commandes dans des devises différentes sont affichées séparément et jamais additionnées.

Les remboursements viennent des notifications de remboursement de Shopify et des mises à jour de commande de WooCommerce. Une boutique Shopify connectée avant l'arrivée des récompenses d'expérience ne reçoit les notifications de remboursement qu'après avoir été reconnectée. Métriques de revenu explique comment la page de résultats lit ces chiffres.


Types d'offres prises en charge

  • Réduction en pourcentage : par ex. 15 % ou 20 % de réduction sur toute la boutique, une collection, ou un seul produit.
  • Réduction en montant fixe : par ex. 10 $ ou 25 $ de réduction sur la valeur totale du panier, ou sur un seul produit.
  • Livraison gratuite : pour les variantes d'une expérience uniquement. Voir Récompenses différentes par variante.
  • Fenêtres d'expiration : les codes portent une date d'expiration calculée automatiquement (par ex. 7 ou 14 jours après l'envoi), ce qui impose une urgence sur la boutique du marchand.
  • Délais de repos par compte : des marqueurs de délai de repos intégrés empêchent de suroffrir des coupons au même contact sur plusieurs programmations ou projets — un marqueur pour l'offre au niveau du projet, et un autre distinct par bloc Produit, de sorte que réduire un produit ne bloque jamais le délai de repos d'un autre produit ni celui de l'offre au niveau du projet.

Quota mensuel

Chaque forfait inclut un nombre de codes de réduction boutique par mois, visible dans Paramètres → Forfait et utilisation sous Codes de réduction boutique. Chaque code que MailInApp crée sur votre boutique pour un contact compte une fois, qu'il vienne de l'offre de réduction d'un projet, de la réduction par produit d'un bloc Produit, de la récompense d'une variante d'expérience ou du prix boutique d'un jeu.

FreeStarterLiteProBusinessEnterprise
2005002 50015 00075 000Illimité
  • Un contact qui reçoit de nouveau l'offre d'un bloc pendant son délai de repos reçoit le même code, compté une seule fois.
  • MailInApp vous écrit quand vous avez utilisé 80 % des codes du mois, puis quand ils sont tous utilisés.
  • Une fois les codes du mois utilisés, les emails partent toujours à l'heure prévue avec le lien de votre boutique à la place du code, et un jeu tombe sur l'un de ses autres prix. Un nouveau quota commence le 1er de chaque mois.
  • Tout votre catalogue produits se synchronise sur chaque forfait, pour que chaque produit soit prêt à importer.

Configuration et intégration API

  • Shopify : nécessite des identifiants de boutique connectée avec le scope write_discounts (l'un des scopes avec lesquels votre application Shopify est créée, voir Connectez votre boutique).
  • WooCommerce : nécessite une clé consommateur et un secret d'API REST de boutique connectée avec permissions de lecture/écriture.

La réduction par produit d'un bloc Produit nécessite en outre que ce bloc ait un véritable produit importé via son sélecteur Importer depuis la boutique (et non une URL externe saisie manuellement) — la génération a besoin de l'identifiant numérique propre à votre boutique pour restreindre le code à ce produit.