Dynamiques

Dynamiques

La zone « Dynamiques » vous permet de connecter des sources de données à vos modèles d'email, vous permettant d'utiliser ces données comme contenu dynamique. En générant, par exemple, un fichier CSV à partir de données produits stockées dans une base de données, puis en important ce fichier ici, la source devient disponible comme flux de données à partir duquel des éléments individuels peuvent être sélectionnés pour être utilisés dans divers éléments de modèle. Les données externes peuvent également provenir de flux RSS.

L'Email Builder synchronise (recharge) les sources de données quotidiennement et met automatiquement à jour les éléments de modèle d'email qui référencent les éléments de données de la source correspondante. Cela élimine le besoin d'ajuster les éléments manuellement et réduit le risque d'erreurs lors de la saisie manuelle de ce type de contenu.

Importer des données externes

Pour importer des données externes, cliquez sur « Nouveau flux », puis spécifiez le nom du nouveau flux de données et son URL source (et éventuellement une description). Cliquer sur « Créer » importe les données. Ensuite, cliquez sur « Éditer » dans le menu « Plus » du flux de données pour configurer quels éléments inclus dans la source de données doivent être rendus disponibles pour la sélection dans le Designer.

Premièrement, sélectionnez la variable qui référence de manière unique les enregistrements de données. Il s'agira de id, guid, ou quelque chose de similaire dans la plupart des cas. Ensuite, cochez les variables que vous avez l'intention d'utiliser dans les modèles d'email de votre projet. Enfin, cliquez sur « Enregistrer les modifications » en haut.

En conséquence, les enregistrements deviennent sélectionnables dans le Designer via leur ID, et vous pouvez alors choisir la variable souhaitée pour que son contenu soit ajouté à l'élément de modèle en cours de modification.

Pour plus de détails, consultez la documentation Email Builder correspondante.

Structure du fichier CSV

Considérez une source de données comme un tableau composé de lignes et de colonnes. La première ligne spécifie les noms de colonnes (en-têtes), et les lignes suivantes sont les « enregistrements » contenant les données réelles. Les éléments de la première colonne rendent chaque ligne unique au moyen d'un identifiant. Voici un exemple :

id;artist;title;subject;year;period
1;Leonardo da Vinci;Mona Lisa;Lisa del Giocondo;1503;Renaissance
2;Michelangelo;The Creation of Adam;Sistine Chapel;1512;Renaissance

Pour que vos données soient correctement importées à partir d'un fichier CSV, les conditions suivantes doivent être remplies :

  • Le fichier ne doit pas être vide et doit être encodé en UTF-8. (ASCII est un sous-ensemble d'UTF-8.)
  • Le fichier doit inclure au moins deux colonnes et peut en inclure jusqu'à 100.
  • Toutes les lignes doivent être composées du même nombre d'éléments.
  • Les éléments peuvent être entourés de guillemets doubles.
  • Les éléments doivent être séparés par une virgule (,), un point-virgule (;), ou un symbole pipe (|).
  • Les noms de colonnes doivent être uniques.
  • Les identifiants d'« enregistrement » (ligne) (par exemple, les éléments nommés id) doivent également être uniques.
  • Les guillemets doubles à l'intérieur d'un élément doivent être doublés (par exemple, écran 24"").
  • La structure et l'encodage du fichier ne doivent pas être modifiés après l'importation.

Pour des performances optimales, nous recommandons d'inclure uniquement les données que vous souhaitez réellement utiliser dans vos modèles d'email dans vos fichiers CSV.

Une fois que vous avez ajouté un flux de données CSV pour l'Email Builder, sa structure et son encodage doivent rester identiques. Sinon, les données du flux utilisées dans vos modèles Email Builder ne peuvent pas être mises à jour, et les données les plus récemment importées, structurées de manière cohérente, seront réutilisées. 

Si vous devez apporter de tels changements à votre flux, supprimez le flux initial et réimportez le flux avec la nouvelle structure. Puis reconfigurez les éléments de modèle utilisant les données du flux.

Structure du flux RSS

En ce qui concerne l'Email Builder, le principe de fonctionnement des flux RSS est le même qu'avec les fichiers CSV : tous deux servent de source de données structurées qui sont rendues disponibles pour utilisation dans les modèles d'email. Cependant, RSS est un dialecte de XML, ce qui signifie que le contenu des fichiers de flux RSS est structuré de manière hiérarchique.

Les flux RSS à utiliser comme flux de données pour les modèles Email Builder doivent suivre la spécification RSS 2.0

Afficher l'exemple de flux RSS
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
  <channel>
  <title>Peintures</title>
  <link>http://example.org/</link>
  <description>Artistes de la Renaissance</description>
    <item>
      <artist>Leonardo da Vinci</artist>
      <title>Mona Lisa</title>
      <subject>Lisa del Giocondo</subject>
      <year>1503</year>
      <period>Renaissance</period>
      <id>1</id>
    </item>
    <item>
      <artist>Michelangelo</artist>
      <title>The Creation of Adam</title>
      <subject>Sistine Chapel</subject>
      <year>1512</year>
      <period>Renaissance</period>
      <id>2</id>
    </item>
  </channel>
</rss>