# Coupons

> Donnez à chaque destinataire d’e-mail son propre code de réduction à usage unique, ou un même code pour tous, et voyez quels codes ont été attribués et utilisés. Alpha : réservé à l’équipe Emailit.

Un coupon insère un code de réduction dans vos e-mails avec `{{coupon "key"}}`. Un coupon de type **Unique codes** donne à chaque destinataire son propre code, tiré d’une réserve : les codes ne peuvent donc pas être partagés. Un coupon de type **One code for everyone** insère le même code pour tous. Emailit distribue les codes ; votre boutique les vérifie lors du paiement : créez donc les mêmes codes dans votre boutique.

> **Commerce est en alpha:** Commerce est réservé à l’équipe Emailit pendant que nous le testons. Consultez [Qui peut utiliser Commerce](/fr/docs/commerce/#who-can-use-commerce).

## Créer un coupon

1. **Ouvrez les coupons.** Dans **Email Marketing → Commerce**, ouvrez l’onglet **Coupons** et sélectionnez **Create coupon**.

2. **Remplissez le coupon.**

   | Champ | Remarques |
   | --- | --- |
   | **Name** | Pour vous, par exemple `Welcome 10%`. |
   | **Key** | Ce que vous écrivez dans le contenu : `{{coupon "welcome10"}}`. Lettres minuscules, chiffres, `-` et `_`, 64 caractères au maximum. Un contenu qui utilise une ancienne clé n’affiche rien : ne la changez donc plus une fois le coupon utilisé. |
   | **Type** | **Unique codes** ou **One code for everyone**. |
   | **Code** | Pour un code identique pour tous, le code. |
   | **Fallback code** | Pour les codes uniques, facultatif : envoyé quand les codes sont épuisés ou que le coupon a expiré. Sans code de secours, la balise n’affiche rien dans ces cas-là. |
   | **Discount** | Un libellé comme `10% off`, affiché dans le tableau de bord. |
   | **Expires** | Facultatif. Après cette date, les coupons à codes uniques n’envoient plus que le code de secours. |

3. **Ajoutez des codes** à un coupon à codes uniques. Ouvrez-le et sélectionnez **Add codes**, puis :
   - **Upload codes** depuis votre boutique : un code par ligne, ou un CSV avec les codes dans la première colonne, jusqu’à 10 000 à la fois. Les codes déjà présents dans la réserve sont ignorés.
   - **Generate codes** : Emailit crée des codes aléatoires sans caractères qui se ressemblent (ni 0, ni O, ni 1, ni I), avec un préfixe facultatif. Sélectionnez ensuite **Export CSV** et créez les mêmes codes dans votre boutique.

4. **Utilisez-le dans le contenu.** Placez `{{coupon "welcome10"}}` dans un e-mail de campagne ou d’automatisation. Consultez [Produits, coupons et panier](/fr/docs/campaigns/products-and-coupons/#coupon-codes).

## Distribution des codes

- Chaque destinataire reçoit un code par campagne ou par automatisation. Si le même e-mail est de nouveau rendu pour lui, par exemple la version web, il reçoit le même code.
- Les codes sont attribués à la création de l’e-mail : une grande campagne consomme donc autant de codes qu’elle a de destinataires. Gardez une réserve plus grande que votre liste.
- Les aperçus et les envois de test affichent un code d’exemple comme `WELCOME10-PREVIEW` et ne consomment pas de codes.

## Suivre les utilisations

Quand une [commande](/fr/docs/api-reference/orders/create/) indique un code dans `coupon_codes`, Emailit le marque comme **Redeemed** avec la commande. Un code utilisé dans votre boutique avant qu’Emailit ne l’ait distribué n’est jamais envoyé. La page du coupon indique combien de codes sont **Available**, **Assigned** et **Redeemed**, et liste les codes avec leurs destinataires et la date d’attribution. **Export CSV** télécharge la liste.

Les segments peuvent trouver les contacts qui ont utilisé un coupon avec la règle `used_coupon`. Consultez [Règles d’activité](/fr/docs/api-reference/segments/create/#activity-rules).

## Utiliser l’API

| Endpoint | Utilisation |
| --- | --- |
| [Créer un coupon](/fr/docs/api-reference/coupons/create/) | Créer un coupon à codes uniques ou à code fixe. |
| [Ajouter des codes à un coupon](/fr/docs/api-reference/coupons/add-codes/) | Importer des codes, ou les générer avec un nombre, un préfixe et une longueur. |
| [Lister les codes d’un coupon](/fr/docs/api-reference/coupons/list-codes/) | Consulter la réserve, filtrée par codes disponibles, attribués ou utilisés. |
| [Lister](/fr/docs/api-reference/coupons/list/), [récupérer](/fr/docs/api-reference/coupons/get/), [mettre à jour](/fr/docs/api-reference/coupons/update/) et [supprimer](/fr/docs/api-reference/coupons/delete/) | Gérer les coupons. |

## Voir aussi

  - [Produits, coupons et panier](/fr/docs/campaigns/products-and-coupons/): Toutes les balises Commerce pour le contenu des e-mails.
  - [Commerce](/fr/docs/commerce/): Connectez votre boutique et mesurez le chiffre d’affaires généré par vos e-mails.

---
Source: https://emailit.com/fr/docs/commerce/coupons/