Génération d'un fichier CSV pour les notifications push multilingues generating-csv-multilingual-push
Le téléchargement d’un fichier CSV pour générer du contenu à diffuser est une fonctionnalité utilisée pour prendre en charge les notifications push multilingues. Le format du fichier CSV doit respecter certaines instructions pour que le téléchargement du fichier puisse être effectué et, par conséquent, pour la création d’une diffusion. Les sections suivantes décrivent le format de fichier et les points à prendre en compte.
Format du fichier file-format
14 colonnes sont requises dans le fichier CSV pour une notification push multilingue :
- title
- messageBody
- sound
- adge
- deeplinkURI
- category
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customFields
- locale
- language
- silentPush
Consultez l’exemple de fichier CSV en cliquant sur Télécharger un fichier d’exemple dans la fenêtre Gérer les variantes de contenu. Voir à ce propos cette section.
- title, messageBody, sound, badge, deeplinkURI, catégorie, iosMediaAttachmentURL, androidMediaAttachmentURL : contenu de payload push normal. Vous devez fournir ces informations de la même manière que lors de la création de diffusions push.
- Champs personnalisés : utilisez le format JSON pour les champs personnalisés, par exemple
{"key1":"value1","key2":"value2"}. Pour obtenir un exemple de champs personnalisés, reportez-vous au fichier d’exemple ci-dessus. - isContentAvailable : drapeau pour la vérification de Contenu disponible, la valeur 1 impliquant true, la valeur 0 impliquant false. La valeur par défaut est 0. Si vous laissez cette colonne vide, la valeur est considérée comme étant 0.
- isMutableContent : drapeau pour le Contenu mutable, la valeur 1 impliquant true, la valeur 0 impliquant false. La valeur par défaut est 0. Si vous laissez cette colonne vide, la valeur est considérée comme étant 0.
- locale : le paramètre régional est le champ des variantes de langue, par ex. « en_us » pour l’anglais américain et « fr_fr » pour le français de France.
- language : nom de la langue associée au paramètre régional. Par exemple, si le paramètre régional est « en_us », le nom de la langue doit être « Anglais - États-Unis ».
- silentPush : drapeau pour le type de notification push. S’il s’agit d’une notification push classique, la valeur doit être 0. S’il s’agit d’une notification push silencieuse, la valeur doit être 1. La valeur par défaut est 0. Si vous laissez cette colonne vide, la valeur est considérée comme étant 0.
Contraintes et instructions relatives à la création d’un fichier CSV constraints-guideline-csv
Le nom de chaque colonne est fixe.
Vous devez inclure le nom de chaque colonne dans le fichier CSV. Si vous n’utilisez aucune colonne pour le contenu, laissez-la vide.
Les colonnes « locale » et « language » sont obligatoires et la valeur est unique pour chaque ligne.
Une valeur vide pour cette colonne entraînera un échec de téléchargement de fichier.
L’ordre des colonnes est important. L’ordre des colonnes dans le fichier téléchargé doit respecter le même format que le fichier d’exemple.
Contenu des colonnes entre guillemets. Puisqu’il s’agit d’un fichier CSV (valeurs séparées par des virgules), tout contenu de colonne incluant une virgule (,) doit être mis entre guillemets. Par exemple, "Bonjour, Tom !"
L’encodage UTF-8 est nécessaire pour les caractères internationaux.
Si vous générez le fichier en texte brut, séparez chaque colonne par une « , ».
Discordance de variantes. Si vous utilisez un bloc de contenu et des audiences ciblées avec des langues spécifiques, vous devez répertorier toutes les langues ciblées dans votre fichier CSV, sinon vous obtiendrez une erreur lors de l’envoi de la diffusion.
Insertion d’un champ de personnalisation dans le fichier csv personalization-field-csv
Si vous souhaitez utiliser des champs de personnalisation, vous devez inclure la balise dans le fichier.
Pour insérer le champ de personnalisation « firstName » dans messageBody, le message doit être :
"Hello <span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>, this is message".
Le champ « firstName » est représenté par :
<span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>
Dans le conteneur span, il existe deux attributs obligatoires :
-
L’un est la classe qui est statique. Quel que soit le champ de personnalisation que vous prévoyez d’utiliser, il sera toujours class="nl-dce-field nl-dce-done".
-
Un autre est data-nl-expr, qui est le chemin du champ de personnalisation. Par exemple, si vous insérez le champ de personnalisation « firstName » depuis l’interface utilisateur, le chemin de navigation sera Contexte (context) > Profil (profile) > Prénom (firstName) (comme illustré dans l’image ci-dessous). Dans ce cas, le chemin sera
code language-none /context/profile/firstName. data-nl-expr="/context/profile/firstName".
Paramètre régional et noms de langue locale-language-names
Les langues prises en charge sont les suivantes :