Contenu dynamique avec CSV

• Utilisez un CSV pour personnaliser à grande échelle – Un message, des expériences personnalisées pour tous
• Support multilingue – Changement de langue automatique par utilisateur
• Personnalisation dynamique – Le contenu s’adapte aux propriétés de l’utilisateur (langue, région, ID de campagne)
• Collaboration en équipe – Les utilisateurs non techniques modifient le contenu dans les fichiers CSV
• Injection HTML (e-mail) – Incluez du balisage HTML dans les cellules CSV pour créer dynamiquement du contenu d’e-mail enrichi
• Compatibilité multicanal – Réutilisez la logique CSV entre les canaux

• Intégration ou marketing multilingue
• Promotions spécifiques par région
• Annonces d’événements par lieu
• Personnalisation basée sur les campagnes

​

Étapes de configuration du contenu dynamique avec CSV

1. Créez un fichier CSV avec vos variations de contenu.
2. Mappez les données CSV au message en utilisant la propriété dynamic_content dans la syntaxe Liquid.
3. Créez un nouveau message ou modèle depuis le tableau de bord OneSignal.
4. Sélectionnez le bouton Contenu dynamique ou Personnalisation.
5. Téléchargez le fichier CSV et envoyez le message.

​

Exigences et configuration CSV

• Taille du fichier : Moins de 200 Ko
• En-têtes de colonne :
  • Réservez le premier en-tête de colonne pour la clé de balise ou laissez vide pour référencer des sections
  • Caractères alphanumériques et underscores uniquement
  • Utilisez des underscores (_) au lieu d’espaces
• Encodage : UTF-8

• Multilingue – Localisez le contenu par langue
• Personnalisation du contenu – Personnalisez le contenu par balises de données

​

Exemples de CSV

• Exemple de modèle multilingue
• Exemple de modèle de personnalisation de contenu

• Mappez les en-têtes de colonne à vos codes de langue pris en charge.
• Ajoutez vos traductions à chaque ligne pour chaque code de langue.
• Si vous avez plusieurs sections (comme dans un e-mail), désignez la première colonne comme le nom de la section.

Cet exemple comprend :

• 3 langues : anglais, espagnol et français.
• 2 sections : « section_1 » et « section_2 ».

• Mappez le premier en-tête de colonne à la clé de balise et les lignes sous-jacentes aux valeurs que vous souhaitez référencer. Voir Balises pour plus d’informations sur l’ajout de balises aux utilisateurs.
• Mappez les en-têtes de colonne restants aux sections ou composants que vous souhaitez personnaliser.

Dans cet exemple :

• La clé de balise est campaign_id avec des valeurs possibles de A et B.
• Il y a 3 composants : « title », « message » et « url ».

Important : Supprimez les espaces et les caractères non alphanumériques des en-têtes CSV ou utilisez la notation hash dans Liquid.

​

Mapper les données CSV au contenu du message

<!-- Option 1 : accéder par composant en premier -->
{{dynamic_content.file_name.message_component[user_property]}}

<!-- Option 2 : accéder par propriété utilisateur en premier -->
{{dynamic_content.file_name[user_property].message_component}}

• dynamic_content – Le nom de la propriété utilisé pour référencer les données CSV
• file_name – Nom du fichier CSV (sans extension .csv)
• message_component – Le composant de message spécifique que vous souhaitez personnaliser. C’est le texte statique dans l’en-tête de colonne CSV ou la première ligne.
• user_property – La propriété utilisateur que vous souhaitez référencer.

{{ dynamic_content.my_template.header[user.language] | default: "Bienvenue dans notre dernière mise à jour" }}

• Le contenu dynamique est utilisé lorsqu’il est disponible
• Un message codé en dur apparaît si le contenu dynamique échoue
• Les utilisateurs ne reçoivent jamais de contenu vide

• Exemple de message multilingue
• Exemple de message de personnalisation de contenu

translations.csv

,en,es,fr
section_1,Hello,Hola,Bonjour
section_2,Thanks for shopping with us...,Gracias por comprar con nosotros...,Merci pour votre achat avec nous...

• Le file_name est translations.csv.
• Le message_component est dans les lignes de la première colonne section_1 et section_2.
• Le user_property est l’en-tête de colonne correspondant au code de langue. Nous pouvons le référencer sur l’utilisateur avec la propriété user.language.

Syntaxe Liquid de base pour le message multilingue

{{dynamic_content.translations.section_1[user.language]}}
{{dynamic_content.translations.section_2[user.language]}}

(Recommandé) Syntaxe Liquid avec secours par défaut pour le message multilingue

{% assign supported_langs = "en,es,fr,de" | split: "," %}
{% assign lang = user.language | default: "en" %}

{% unless supported_langs contains lang %}
  {% assign lang = "en" %}
{% endunless %}

{{ dynamic_content.translations.section_1[lang] | default: "Hello" }}
{{ dynamic_content.translations.section_2[lang] | default: "Thanks for shopping with us..." }}

content_personalization_template.csv

campaign_id,title,message,url
campaign_123,Flash deal for you,Tap to claim,https://example.com/flash
campaign_456,Weekend picks are here,See what's trending,https://example.com/weekend
default,Our latest offers,See what's new,https://example.com

• Le file_name est content_personalization_template.csv.
• Le user_property correspond à la clé de balise : campaign_id.
• Le message_component est l’en-tête de colonne mappé à la section du message que vous souhaitez personnaliser (title, message ou url).

Syntaxe Liquid pour le message de personnalisation de contenu

{{ dynamic_content.content_personalization_template[campaign_id].title }}
{{ dynamic_content.content_personalization_template[campaign_id].message }}
{{ dynamic_content.content_personalization_template[campaign_id].url }}

(Recommandé) Syntaxe Liquid avec secours par défaut pour le message de personnalisation de contenu

{% assign cid = campaign_id | default: "default" %}

{% unless dynamic_content.content_personalization_template[cid] %}
  {% assign cid = "default" %}
{% endunless %}

{{ dynamic_content.content_personalization_template[cid].title | default: "Nos dernières offres" }}
{{ dynamic_content.content_personalization_template[cid].message | default: "Voir les nouveautés" }}
{{ dynamic_content.content_personalization_template[cid].url | default: "https://example.com" }}

​

Utiliser du HTML dans les cellules CSV (e-mail uniquement)

campaign_id,banner_html
spring_sale,<div style="background:#4CAF50;padding:16px;text-align:center;"><a href="https://example.com/spring" style="color:#fff;font-size:18px;">Shop the Spring Sale</a></div>
default,<div style="background:#333;padding:16px;text-align:center;"><a href="https://example.com" style="color:#fff;font-size:18px;">See What's New</a></div>

{{ dynamic_content.promo_banners[campaign_id].banner_html | default: "<p>Check out our latest offers</p>" }}

​

Référence

​

Mise à jour des modèles

​

Caractères spéciaux dans les clés

{{ dynamic_content.file_name["!the_row!"]["&the_column&"] }}

{{ dynamic_content.file_name.the_row.the_column }}

​

FAQ

​

Comment puis-je tester le contenu dynamique avec CSV ?

• Utilisez l’adressage + dans les e-mails pour tester plusieurs variations : username+test@example.com.
• Définissez les balises en suivant les exemples multilingues et de personnalisation de contenu ci-dessus.
• Voir Importer pour plus d’informations sur le téléchargement de plusieurs utilisateurs et balises de données.

​

Quand utiliser le contenu dynamique avec CSV vs. d’autres options de personnalisation ?

​

Pages connexes