> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://supr-bundles-and-subscriptions.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Paramètres des balises

| Pour accéder à cette page de paramètres, allez dans [**Supr Bundles & Subscriptions > Paramètres > Balises**](https://admin.shopify.com/apps/super-subscriptions/app/settings/tags)

L'application peut ajouter des balises à vos clients et commandes Shopify selon le statut de leur abonnement, par exemple **has active subscription** sur un client ou **recurring order** sur une commande de renouvellement. Utilisez ces balises pour filtrer les clients et les commandes dans Shopify, créer des segments de clientèle et cibler les abonnés dans des outils d'e-mail marketing comme Shopify Email ou Klaviyo.

### Table des matières

* [Comment fonctionnent les balises d'abonnement](#3-comment-fonctionnent-les-balises-dabonnement)
* [Balises client](#3-balises-client)
* [Balises de commande](#3-balises-de-commande)
* [Modifier le texte d'une balise](#3-modifier-le-texte-dune-balise)
* [Variables dans les balises](#3-variables-dans-les-balises)
* [Utiliser les balises pour écrire aux abonnés ou les segmenter](#3-utiliser-les-balises-pour-ecrire-aux-abonnes-ou-les-segmenter)
* [Questions fréquentes](#3-questions-frequentes)
* [Guides associés](#3-guides-associes)

### Comment fonctionnent les balises d'abonnement

**Chaque balise est désactivée tant que vous ne la cochez pas.** Cochez les balises souhaitées, cliquez sur **Enregistrer** dans la barre d'enregistrement et confirmez avec **Mettre à jour les balises**.

Lorsque vous enregistrez, l'application met immédiatement à jour les balises de vos clients et commandes d'abonnement existants : vous n'avez pas besoin d'attendre de nouvelles commandes. Comptez quelques minutes pour que toutes les balises soient mises à jour. Désactiver une balise, ou modifier son texte, retire l'ancienne balise de la même façon.

Ensuite, les balises restent à jour d'elles-mêmes : elles sont ajoutées et retirées à mesure que les abonnements démarrent, se renouvellent, sont suspendus, résiliés ou échouent.

### Balises client

|| Utilisez ces balises pour identifier les clients selon le statut de leur abonnement.

| Paramètre | Balise ajoutée (texte par défaut) | Ajoutée aux clients qui ont |
| --- | --- | --- |
| **A un contrat d'abonnement** | has subscription contract | un abonnement, quel que soit son statut |
| **A un abonnement actif** | has active subscription | au moins 1 abonnement actif |
| **A un abonnement suspendu** | has paused subscription | au moins 1 abonnement suspendu |
| **A un abonnement résilié** | has cancelled subscription | au moins 1 abonnement résilié |
| **A un abonnement terminé** | has completed subscription | au moins 1 abonnement terminé (arrivé à son terme) |
| **A un abonnement en échec** | has failed subscription | au moins 1 abonnement en échec (par exemple quand un paiement échoue) |

Un client peut porter plusieurs de ces balises à la fois, par exemple s'il a un abonnement actif et un abonnement résilié.

### Balises de commande

Balises appliquées aux commandes selon leur rôle dans un abonnement :

| Paramètre | Balise ajoutée (texte par défaut) | Ajoutée à |
| --- | --- | --- |
| **Commande d'abonnement** | subscription order | chaque commande faisant partie d'un abonnement |
| **Numéro de commande de l'abonnement** | subscription order #1, #2, #3... | chaque commande d'abonnement, la première commande comptant comme n° 1 |
| **Commande initiale** | initial subscription order | la première commande d'un abonnement |
| **Commande récurrente** | recurring order | chaque commande de renouvellement |
| **Numéro de renouvellement de l'abonnement** | subscription renewal #1, #2, #3... | les commandes de renouvellement uniquement, le premier renouvellement comptant comme n° 1 (la première commande n'est pas incluse) |

Pour inclure l'ID de l'abonnement, le nom de l'option d'abonnement ou le numéro de commande dans une balise, utilisez une [variable](#3-variables-dans-les-balises).

### Modifier le texte d'une balise

Cliquez sur le bouton crayon sous une balise pour ouvrir **Modifier la balise**, saisissez le nouveau texte et cliquez sur **Modifier**. Les deux balises de numéro doivent conserver leur variable de numéro (`{{ contract_order_number }}` ou `{{ contract_renewal_number }}`), que l'application remplace par le numéro de la commande. Les balises enregistrées avec l'ancienne forme à accolade simple, comme `{ contract_order_number }`, continuent de fonctionner.

|| D'autres guides et vos propres segments peuvent s'appuyer sur le texte par défaut. [Comment proposer une réduction d'abonnement à usage unique](https://supr-bundles-and-subscriptions.crisp.help/fr/article/how-to-offer-a-one-time-use-subscription-discount-7nlb3s/), par exemple, utilise **has subscription contract**. Si vous renommez une balise, mettez à jour les segments qui l'utilisent.

### Variables dans les balises

Les balises de commande et la balise client **A un contrat d'abonnement** peuvent contenir des variables, que l'application remplit pour chaque commande ou abonnement. Cliquez sur une variable sous la balise dans **Modifier la balise** pour l'ajouter, et l'exemple en dessous montre à quoi ressemblera la balise.

| Variable | Remplie avec | Exemple |
| --- | --- | --- |
| `{{ subscription_name }}` | le nom de l'option d'abonnement | Livré tous les mois |
| `{{ subscription_id }}` | l'ID de l'abonnement | 50748162284 |
| `{{ delivery_frequency }}` | la fréquence de livraison | 1 mois |
| `{{ billing_frequency }}` | la fréquence de facturation (plus longue que la fréquence de livraison sur un abonnement prépayé) | 3 mois |
| `{{ product_title }}` | le titre du produit, une balise par produit | Café en grains |
| `{{ variant_title }}` | le titre de la variante, une balise par produit | 1 kg |
| `{{ order_id }}` | l'ID de la commande (balises de commande uniquement) | 6123456789012 |
| `{{ order_name }}` | le nom de la commande (balises de commande uniquement) | #1001 |
| `{{ contract_order_number }}` | le numéro de la commande dans l'abonnement, la première commande étant 1 (balises de commande uniquement) | 3 |
| `{{ contract_renewal_number }}` | le numéro du renouvellement, le premier renouvellement étant 1 (balises de commande uniquement) | 2 |

Par exemple, une balise de commande `plan {{ subscription_name }}` donne **plan Livré tous les mois**, et une balise **A un contrat d'abonnement** `subscriber {{ subscription_id }}` donne au client une balise par abonnement.

* Les balises de statut (**A un abonnement actif**, **A un abonnement suspendu** et les autres) décrivent le client dans son ensemble : elles restent en texte simple et n'acceptent pas de variables.
* Une balise avec `{{ product_title }}` ou `{{ variant_title }}` est écrite une fois pour chaque produit de l'abonnement : un abonnement à du café en grains et à du thé vert reçoit donc deux balises.
* Les balises écrites avant l'existence de `{{ delivery_frequency }}` peuvent utiliser `{{ frequency }}`. Cette variable continue de fonctionner et est remplie avec la fréquence de livraison.
* Shopify autorise jusqu'à 40 caractères par balise. Quand une balise remplie est plus longue, l'application raccourcit d'abord le nom du produit ou de la variante (ou le nom de l'option), pour que vos propres mots et numéros soient conservés. Le texte que vous saisissez vous-même, sans les variables, doit tenir en 40 caractères, sinon **Modifier la balise** le refuse.
* Shopify n'autorise pas les virgules dans une balise : une virgule dans une valeur remplie devient donc une espace.
* Quand vous modifiez une balise qui utilise des variables, l'application remplace les balises écrites par l'ancien texte sur vos clients et commandes existants.

### Utiliser les balises pour écrire aux abonnés ou les segmenter

L'application n'envoie pas elle-même d'e-mails marketing ni d'envois groupés. Ajoutez plutôt des balises à vos abonnés et utilisez-les dans votre outil d'e-mail :

1. Activez les balises client dont vous avez besoin, par exemple **A un abonnement actif** et **A un abonnement suspendu**, puis enregistrez et confirmez avec **Mettre à jour les balises**.
2. Dans votre admin Shopify, accédez à **Clients > Segments** et créez un segment où les balises client contiennent la balise, par exemple `has paused subscription`.
3. Envoyez un e-mail à ce segment depuis Shopify Email, ou utilisez la balise dans votre application marketing. Les applications qui synchronisent les balises client Shopify, comme Klaviyo, peuvent créer des listes ou des segments à partir de celles-ci.

Quelques exemples :

* **Reconquérir les abonnés suspendus ou résiliés** : un segment sur **has paused subscription** ou **has cancelled subscription**.
* **Proposer l'abonnement aux acheteurs ponctuels** : les clients **sans** **has subscription contract** ne se sont jamais abonnés.
* **Distinguer les premières commandes des renouvellements** dans les rapports ou dans les applications qui lisent les balises de commande (par exemple les applications d'affiliation ou de traitement des commandes) : utilisez **Commande initiale**, **Commande récurrente** et les balises de numéro.

Les balises d'abonnement sont distinctes de votre liste de newsletter : un abonné n'a pas forcément accepté de recevoir des e-mails marketing, respectez donc le consentement de chaque client à l'e-mail marketing.

### Questions fréquentes

* **Pourquoi mes commandes de renouvellement n'ont-elles pas de balise d'abonnement ?**
  Les balises de commande sont désactivées tant que vous ne les activez pas ici. Cochez **Commande d'abonnement** ou **Commande récurrente**, cliquez sur **Enregistrer** et confirmez avec **Mettre à jour les balises**. Les commandes d'abonnement existantes reçoivent aussi la balise.
* **Comment écrire uniquement aux clients qui ont un abonnement actif ?**
  Activez **A un abonnement actif**, puis créez un segment sur la balise `has active subscription` dans **Clients > Segments** ou dans votre application d'e-mail.
* **Comment créer un segment d'abonnés suspendus (ou résiliés, ou en échec) ?**
  Activez la balise client correspondante et créez un segment Shopify où les balises client la contiennent. La balise est retirée automatiquement quand le client n'a plus d'abonnement dans ce statut.
* **Mon application d'affiliation ou de parrainage peut-elle distinguer une première commande d'un renouvellement ?**
  Oui, si elle peut lire les balises de commande : activez **Commande initiale**, **Commande récurrente**, **Numéro de commande de l'abonnement** ou **Numéro de renouvellement de l'abonnement**. Les autres applications ne peuvent pas lire l'abonnement lui-même, car Shopify ne le partage qu'avec l'application qui l'a créé. Consultez [Utiliser l'API](https://supr-bundles-and-subscriptions.crisp.help/fr/article/using-the-api-1fbsxks/) pour relier les commandes aux abonnements depuis vos propres systèmes.
* **Les balises s'appliquent-elles aux clients qui se sont abonnés avant leur activation ?**
  Oui. L'enregistrement du réglage met à jour vos clients et commandes d'abonnement existants en quelques minutes.

### Guides associés

* [Comment proposer une réduction d'abonnement à usage unique](https://supr-bundles-and-subscriptions.crisp.help/fr/article/how-to-offer-a-one-time-use-subscription-discount-7nlb3s/), qui utilise la balise **A un contrat d'abonnement** pour créer un segment réservé aux nouveaux abonnés.
* [Analyses des abonnements](https://supr-bundles-and-subscriptions.crisp.help/fr/article/subscription-analytics-1e1we1/)
* [Utiliser Supr Bundles & Subscriptions avec d'autres applications et outils](https://supr-bundles-and-subscriptions.crisp.help/fr/article/using-the-app-with-other-apps-1mzr9hn/)