Comment ajouter des codes-barres à vos messages

Objectif de cet article

Découvrez comment utiliser le tag {% barcode %} pour générer des codes-barres Code 128 dans vos messages e-mail, MMS, RCS et WhatsApp. La valeur du code-barres peut être une chaîne statique, une propriété de profil, une variable d’événement ou un code de réduction Klaviyo.

Référence rapide

Avant de commencer

Le tag {% barcode %} fonctionne en générant une URL. Lorsque cette URL est chargée (dans un aperçu, une boîte de réception ou un appareil mobile), elle affiche une image PNG du code-barres. Cela signifie que l’image du code-barres n’est pas créée tant que l’URL n’a pas été réellement récupérée.

Le tag {% barcode %} est pris en charge dans :

• E-mail
• MMS
• RCS
• WhatsApp

Utilisation de base

La manière la plus simple d’utiliser le tag code-barres est :

{% barcode 'MyCode' %}

Cela génère une URL qui renvoie une image PNG d’un code-barres. Une fois scanné, le code-barres contient la valeur MyCode.

Vous pouvez personnaliser le code-barres en transmettant des arguments au tag. Par exemple :

{% barcode 'MyCode' width=200 height=100 %}

Consultez la section de référence des arguments ci-dessous pour découvrir toutes les options disponibles.

Utiliser des codes-barres avec différents canaux

E-mail

Pour l’e-mail, vous avez deux options pour le rendu du code-barres :

Option 1 : mode HTML (recommandé pour l’e-mail)

Définissez mode=html afin que le tag génère directement un élément HTML <img>. Il s’agit de l’approche la plus simple pour inclure un code-barres dans un e-mail.

{% barcode 'MyCode' mode=html %}

Placez ce tag dans un bloc de texte ou un bloc HTML dans l’éditeur de modèles d’e-mails.

Option 2 : mode URL

Laissez le mode non défini (ou définissez mode=url) pour obtenir une URL, puis placez cette URL dans le champ d’URL de l’image d’un bloc d’image. Cela vous donne plus de contrôle sur le style de l’image.

{% barcode 'MyCode' %}

MMS

Pour les messages MMS, ajoutez le tag de code-barres dans la section Image dynamique de l’éditeur SMS/MMS, et non dans le corps du texte.

1. Ouvrez votre message MMS dans l’éditeur.
2. Cliquez sur l’icône Ajouter une image dans la zone de message.
3. Accédez à l’onglet Image dynamique.
4. Collez votre tag de code-barres, par exemple :

{% barcode person.LoyaltyId %}

1. Cliquez sur Enregistrer.

Cela suit le même processus que l’ajout de n’importe quelle image dynamique à un MMS. Pour plus de détails, consultez Comment ajouter une image dynamique à un message texte.

RCS

Pour les messages RCS, utilisez mode=rcs pour mettre en forme le code-barres conformément aux exigences d’image RCS. Ce mode définit automatiquement des dimensions qui s’affichent correctement sur Android et iOS.

{% barcode 'MyCode' mode=rcs %}

Ajoutez le tag de code-barres dans la section Image dynamique de l’éditeur de messages RCS, de la même manière que vous le feriez pour MMS.

Paramètres par défaut RCS :

• Largeur : 600px
• Hauteur : 300px
• Avec une marge intérieure jusqu’à : 1440x720px

Ces valeurs par défaut suivent les recommandations de Klaviyo pour le formatage des images RCS. Vous pouvez les remplacer par des valeurs width, height, padded_width et padded_height personnalisées si nécessaire.

WhatsApp

Pour les messages WhatsApp, ajoutez le tag de code-barres dans la section Image dynamique de l’éditeur de messages, de la même manière que vous le feriez pour les MMS.

{% barcode person.MembershipId %}

Aucune configuration spéciale ou mode n’est nécessaire pour WhatsApp. La valeur par défaut mode=url fonctionne correctement.

Référence des arguments de tag de code-barres

Utiliser des codes-barres avec des propriétés de profil et des données d’événement

Vous pouvez utiliser des propriétés de profil ou des variables d’événement comme valeur de code-barres, afin que chaque destinataire reçoive un code-barres unique.

Exemples de propriétés de profil :

{% barcode person.LoyaltyId %}
{% barcode person.email %}
{% barcode person.MembershipNumber %}

Exemples de variables d’événement (pour les flux déclenchés par des indicateurs) :

{% barcode event.Code %}
{% barcode event.OrderId %}

Gestion des valeurs manquantes :

Si un destinataire n’a pas la propriété définie, l’URL du code-barres sera invalide et l’image ne se chargera pas. Deux options s’offrent à vous :

Option 1 : utilisez un filtre default pour définir une valeur de repli pertinente :

{% barcode person.BarcodeCode|default:'STORE-MEMBER' %}

Assurez-vous que la valeur par défaut est une valeur logique si elle est scannée. Un espace réservé générique comme "fallback" produirait un code-barres scannable, mais inutile.

Option 2 : utiliser une instruction conditionnelle pour masquer complètement le code-barres lorsque la valeur est manquante :

{% if person.BarcodeCode %}
  {% barcode person.BarcodeCode mode=html %}
{% endif %}

Exemple combiné pour l’e-mail :

{% barcode person.LoyaltyId width=200 height=75 mode=html %}

Utiliser des codes-barres avec les codes de réduction Klaviyo

Si vous utilisez des codes de réduction gérés par Klaviyo et souhaitez les afficher sous forme de codes-barres, définissez coupon=True. Cela indique au système d’attribuer un code de réduction au destinataire et d’utiliser ce code comme valeur du code-barres.

{% barcode 'ShopifyCoupon' coupon=True %}

Cela fonctionne sur tous les canaux. Par exemple, pour envoyer un code-barres de code de réduction via RCS :

{% barcode 'ShopifyCoupon' coupon=True mode=rcs %}

{% barcode person.CouponCode %}

Mise à l’échelle et dimensionnement

Par défaut, la largeur et la hauteur du code-barres sont mises à l’échelle avec un facteur de 3x. Cela signifie que :

• Un width sur 100 s’affiche avec une largeur réelle de 300px
• Une height de 50 s’affiche à une hauteur réelle de 150px

Exception: Lorsque mode=rcs, le facteur d’échelle est de 1x. Cela permet un contrôle plus précis des dimensions du code-barres afin de répondre aux exigences de mise en forme des images RCS.

Les valeurs de marge intérieure ne sont pas mises à l’échelle. Les arguments padded_width et padded_height représentent toujours des valeurs réelles en pixels. Étant donné que le code-barres intérieur est mis à l’échelle par 3×, vos valeurs de marge intérieure doivent être supérieures à 3 fois la largeur et la hauteur. Par exemple :

{% barcode 'Code' width=200 height=100 padded_width=700 padded_height=400 %}

Ici, le code-barres s’affiche en 600x300px (200×3, 100×3) dans un canevas avec marge intérieure de 700x400px.

Taille maximale de l’image : le service de code-barres ne génèrera pas d’images de plus de 4096x4096 pixels. Cette limite s’applique à la taille rendue après mise à l’échelle. Pour les codes-barres non RCS (mise à l’échelle 3x), cela signifie que l’argument width maximal est d’environ 1365 (1365 × 3 = 4095px). Pour les codes-barres RCS (mise à l’échelle 1x), le maximum est de 4096.

Recommandations de largeur pour les numéros longs :

• Pour les codes-barres non RCS : si votre code dépasse 15 caractères, augmentez la largeur au-delà de la valeur par défaut de 100 (ce qui s’affiche en 300 px).
• Pour les codes-barres RCS : si votre code dépasse 30 caractères, augmentez la largeur au-delà de la valeur par défaut de 600px.

Si la largeur est trop faible pour encoder les données, l’image du code-barres ne pourra pas être générée.

Résolution de problèmes

Prévisualisez toujours avant l’envoi

Comme le tag {% barcode %} produit une URL au moment du rendu et que l’image n’est pas générée tant que cette URL n’est pas récupérée, les échecs peuvent ne pas être visibles avant que vous ne prévisualisiez ou n’envoyiez le message. Suivez ces étapes pour détecter les problèmes au plus tôt :

1. Prévisualiser le message. Si le code-barres ne se charge pas dans la prévisualisation, il ne se chargera pas lors de l’envoi.
2. Scannez le code-barres. Utilisez un outil de lecture de codes-barres (tel que imagetotext.info/barcode-scanner) pour vérifier que le code-barres encode la valeur attendue.
3. Envoyez-vous un message de test avant d’envoyer à votre audience.

Problèmes courants

L’image du code-barres ne se charge pas

La cause la plus fréquente est une valeur de code-barres vide. Cela se produit lorsque le tag fait référence à une propriété de profil ou à une variable d’événement dont le destinataire ne dispose pas. Par exemple :

{% barcode person.BarcodeCode %}

Si le destinataire n’a pas de valeur BarcodeCode, l’URL générée n’inclura pas le code et l’image ne s’affichera pas. Pour corriger cela, ajoutez un filtre default :

{% barcode person.BarcodeCode|default:'defaultCode' %}

L’image du code-barres ne parvient pas à se générer, mais l’URL semble correcte

La largeur du code-barres est probablement trop étroite pour encoder toutes les données de votre code. Essayez d’augmenter la valeur width. En règle générale :

• Les codes de plus de 15 caractères nécessitent une largeur supérieure à la valeur par défaut de 100 (300 px au rendu).
• Les codes RCS de plus de 30 caractères nécessitent une largeur supérieure à la valeur par défaut de 600px.

Le code-barres n’apparaît pas dans un bloc de texte (e-mail)

Vérifiez si une logique d’affichage/masquage est appliquée au bloc de texte. Si une condition masque le bloc, le code-barres ne s’affichera pas même si le tag est correct. Ouvrez les paramètres du bloc pour vérifier.

Ressources supplémentaires

• Démarrer avec les codes de réduction dans Klaviyo — Découvrez comment créer et gérer des codes de réduction, y compris comment utiliser l’ancien tag {% barcode_code %} pour les codes-barres de codes de réduction dans les e-mails.
• Comment ajouter une image dynamique à un message texte — Découvrez comment ajouter des images dynamiques aux messages MMS, notamment où trouver la section Image dynamique dans l’éditeur.
• Référence sur la personnalisation des messages — Référence pour tous les tag de personnalisation disponibles dans Klaviyo, y compris les propriétés de profil, les variables d’événement et les filtres.
• Comprendre les bonnes pratiques concernant les images et les GIF en MMS — Bonnes pratiques concernant la taille et le format des images dans les messages MMS.