Contenu dynamique avec CSV

​

Vue d’ensemble

• Utilisez un CSV pour personnaliser à grande échelle – Un message, des expériences personnalisées pour tous
• Support multilingue – Changement de langue automatique par utilisateur
• Segmentation 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
• 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.

Dans cet exemple :

• Nous avons 3 langues : anglais, espagnol et français.
• Nous avons 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 :

• Nous avons une clé de balise : campaign_id avec des valeurs possibles de A et B.
• Nous avons 2 sections ou 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

{{dynamic_content.file_name.message_component[user_property]}}
ou
{{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

Copier

Demander à l'IA

,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

Copier

Demander à l'IA

{{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

Copier

Demander à l'IA

{% 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

Copier

Demander à l'IA

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

Copier

Demander à l'IA

{{ 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

Copier

Demander à l'IA

{% 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" }}

​

Considérations d’utilisation

​

Comment puis-je tester le contenu dynamique avec CSV ?

• Vous pouvez utiliser 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 Import 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

• Utilisez le contenu dynamique avec CSV si vous envoyez des messages depuis le tableau de bord et avez accès aux données utilisateur avec un fichier CSV.
• Pour d’autres options d’ajout de contenu dynamique aux messages, consultez Personnalisation des messages ou les options de messagerie multilingue.

​

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 }}

​

Articles connexes

• Personnalisation des messages - Aperçu de toutes les options de personnalisation
• Utilisation de la syntaxe Liquid - Référence complète de la syntaxe Liquid
• Import - Télécharger les données utilisateur et les segments
• Modèles - Créer des modèles de messages réutilisables