Vue d'ensemble
Les variables dynamiques vous permettent de personnaliser les emails pour chaque contact en exploitant les données d'Apollo et, dans le cas des variables dynamiques personnalisées, vos propres recherches de données. Les variables dynamiques avancées sont légèrement différentes des variables dynamiques de base en ce qu'elles permettent une logique conditionnelle limitée.
Cela signifie que les variables dynamiques avancées peuvent fournir une valeur de secours s'il n'existe aucune donnée pour un champ spécifique d'un contact. Vous pouvez utiliser une logique conditionnelle dans les Prompts de recherche IA ou dans des emails avec variables pour favoriser leur envoi.
Consultez les sections suivantes pour en savoir plus sur les variables dynamiques avancées.
Types de variables dynamiques avancées
Les variables dynamiques avancées existent en plusieurs types :
- Valeur de secours vide
- Valeur de secours dynamique
- Opérateurs de casse et de pluralisation
- Opérateurs de date/heure actuelles
- Opérateurs de date personnalisée
Chacun de ces types de variables dynamiques avancées vous permet de personnaliser davantage les modèles d'email pour vos clients.
Valeur de secours vide
Utilisez la variable dynamique avancée de valeur de secours vide pour envoyer des emails sans craindre qu'ils ne partent pas parce qu'une variable dynamique de base ne contient pas de données. Avec une valeur de secours vide, votre email est envoyé avec un espace vide à la place de la variable si Apollo ne dispose pas de données pour un contact.
Imaginez que vous souhaitiez envoyer un email qui salue chaque destinataire par son prénom. Vous pouvez utiliser la variable dynamique{{first_name}} de base pour écrire :
Greetings {{first_name}},
Cependant, si Apollo n'a pas de prénom pour un contact dans votre séquence, la variable dynamique échoue et Apollo déplace votre email dans le dossier Non envoyé.
Pour éviter cette situation, utilisez la variable dynamique avancée {{#if first_name}}{{#endif}} pour créer une valeur de secours générique :
Greetings {{#if first_name}}{{#endif}},
Si Apollo dispose des données pour un destinataire d'email, la variable dynamique s'affiche dans l'email :
Greetings John,
Si Apollo ne dispose pas des données, l'email est tout de même envoyé avec un espace vide à la place de la variable dynamique :
Greetings ,
Valeur de secours dynamique
Les variables dynamiques avancées avec une valeur de secours dynamique vont encore plus loin que celles avec une valeur de secours vide. Ces variables dynamiques insèrent le texte que vous définissez lorsqu'il n'existe pas de données pertinentes pour un contact.
Imaginez que vous souhaitiez utiliser un texte générique si le prénom d'un destinataire n'est pas disponible. Pour cela, utilisez la variable dynamique avancée suivante pour créer une valeur de secours dynamique :
Hi {{#if first_name}}{{first_name}}{{#else}}there{{#endif}},
Si Apollo dispose des données pour un destinataire d'email, le prénom s'affiche dans l'email :
Hi John,
Si Apollo ne dispose pas des données nécessaires, l'email s'affiche avec there à la place de la variable :
Hi there,
Il est important de comprendre le rôle de chaque partie de la variable dynamique. La première partie, {{#if firstname}}{{firstname}}, marque le début de la logique conditionnelle. Cela indique à Apollo « S'il existe une valeur pour le prénom, affichez d'abord ce prénom dans l'Email ouvert ». Cela est similaire à la variable dynamique de base {{first name}}, avec l'ajout d'une instruction {{#if}}.
La partie suivante, {{#else}}there, indique à Apollo « Si aucune valeur de prénom n'est disponible pour ce contact, utilisez le texte there à la place ».
La dernière partie, {{#endif}}, indique à Apollo qu'il s'agit de la fin de la logique conditionnelle pour cette variable dynamique.
Opérateurs de casse et de pluriel
Les variables dynamiques avancées avec des opérateurs de casse et de pluriel prennent la valeur d'un champ et en modifient la casse ou le pluriel.
Ces types avancés de variables dynamiques fonctionnent uniquement avec les champs de type string . Ils ne fonctionnent pas avec les autres types de champ.
Les exemples suivants montrent comment utiliser les opérateurs de casse et de pluriel :
| Variables dynamiques | Description | Exemple |
|---|---|---|
{{title->lowercase}} |
Prend la valeur de l'intitulé du poste d'un contact et convertit toutes ses lettres en minuscules. |
Engineering Manager devient engineering manager
|
{{title->capitalize_each_word}} |
Prend la valeur de l'intitulé du poste d'un contact et met en majuscule la première lettre de chaque mot. |
engineering manager devient Engineering Manager
|
{{title->plural}} |
Prend la valeur de l'intitulé du poste d'un contact et la convertit au pluriel. |
Engineering Manager devient Engineering Managers
|
Ajoutez un -> dans la variable pour combiner plusieurs opérateurs de casse et de pluriel. Par exemple, pour convertir l'intitulé du poste d'un contact en majuscules et au pluriel, combinez les opérateurs dans la même variable :
{{title->capitalize_each_word->plural}}
Cette variable dynamique affiche l'intitulé du poste engineering manager sous la forme Engineering Managers.
Opérateurs now-date/time
Les variables dynamiques avancées avec les opérateurs {{nowmonth}}, {{nowday}}, et {{now_time}} prennent la date actuelle et la manipulent de différentes manières.
Ces types avancés de variables dynamiques fonctionnent uniquement avec les champs de type date . Ils ne fonctionnent pas avec les autres types de champ.
Les exemples suivants montrent comment les opérateurs de date et d’heure du moment présent peuvent être utilisés :
| Variables dynamiques | Description | Exemple |
|---|---|---|
{{now_day->plus_X}} |
Prend le jour actuel et l’avance du nombre spécifié de jours ouvrés. Si le nombre de jours ouvrés dépasse le nombre de jours du mois en cours, Apollo prend en compte la transition et poursuit le décompte à partir du premier jour du mois suivant. Vous pouvez utiliser n’importe quel nombre entier (integer) ici. |
Si nous sommes le 15 du mois et un mercredi, la variable dynamique {{now_day->plus_5}} s’affiche comme 22 dans l’Email ouvert. |
{{now_day->minus_X}} |
Prend le jour actuel et le recule du nombre spécifié de jours ouvrés. Si le nombre de jours ouvrés dépasse le nombre de jours du mois en cours, Apollo prend en compte la transition et poursuit le décompte à partir du dernier jour du mois précédent. Vous pouvez utiliser n’importe quel nombre entier (integer) ici. |
Si nous sommes le 15 du mois et un mercredi, la variable dynamique {{now_day->minus_5}} s’affiche comme 8 dans l’Email ouvert. |
{{now_month->plus_X}} |
Prend le mois en cours et l’avance du nombre spécifié de mois. Vous pouvez utiliser n’importe quel nombre entier (integer) entre 1 et 11. |
Si le mois en cours est avril, la variable dynamique {{now_month->plus_1}} s’affiche comme May dans l’Email ouvert. |
{{now_month->minus_X}} |
Prend le mois en cours et le recule du nombre spécifié de mois. Vous pouvez utiliser n’importe quel nombre entier (integer) entre 1 et 11. |
Si le mois en cours est avril, la variable dynamique {{now_month->minus_2}} s’affiche comme February dans l’Email ouvert. |
{{now_year->plus_X}} |
Prend l’année en cours et l’avance du nombre spécifié d’années. Vous pouvez utiliser n’importe quel nombre entier (integer) ici. |
Si l’année en cours est 2024, la variable dynamique {{now_year->plus_2}} s’affichera comme 2026 dans l’Email ouvert. |
{{now_year->minus_X}} |
Prend l’année en cours et la recule du nombre spécifié d’années. Vous pouvez utiliser n’importe quel nombre entier (integer) ici. |
Si l’année en cours est 2024, la variable dynamique {{now_year->minus_1}} s’affichera comme 2023 dans l’Email ouvert. |
{{now_time_of_day}} |
Affiche le moment actuel de la journée (morning, afternoon, evening). |
S'il est actuellement 9 h 00, la variable dynamique Good {{now_time_of_day}}, s'affiche comme Good morning, dans l'Email ouvert. |
Opérateurs de date personnalisés
Les champs personnalisés et les variables dynamiques qui utilisent des opérateurs de date personnalisés sont uniquement disponibles pour les clients disposant de certains forfaits Apollo. Si vous n'y avez pas accès et souhaitez passer à un forfait supérieur, contactez l'équipe commerciale d'Apollo.
Les variables dynamiques avancées avec opérateurs de date personnalisés utilisent des champs personnalisés configurés pour les dates et les manipulent de différentes façons.
Ces types de variables dynamiques avancées fonctionnent uniquement avec les types de champ date-type. Elles ne fonctionnent pas avec les autres types de champs.
Imaginez que vous créez un champ personnalisé appelé product_announcement pour la date de votre annonce produit annuelle, qui a lieu le 15 octobre 2024. Ce champ personnalisé inclut le mois, le jour et l'année. Vous pouvez donc utiliser des opérateurs de date personnalisés dans une variable dynamique pour extraire des éléments spécifiques.
La variable dynamique {{productannouncement->day}} s'affiche comme 15, la variable dynamique {{productannouncement->month}} s'affiche comme October, et la variable dynamique {{product_announcement->year}} s'affiche comme 2024 dans l'Email ouvert.
De plus, vous pouvez utiliser la variable dynamique {{product_announcement->weekday}} pour extraire le jour de la semaine de votre date personnalisée. Dans ce cas, elle s'affiche comme Tuesday dans l'Email ouvert, car le 15 octobre 2024 tombe un mardi.
Exemple de cas d'usage des variables dynamiques avancées
Dans cet exemple, le texte est mis en forme pour distinguer les variables dynamiques du texte brut, et des sauts de ligne sont insérés entre chaque instruction de logique conditionnelle pour faciliter la lecture. Vous devez écrire les variables dynamiques dans Apollo sur une seule ligne continue.
Pour plus de contexte, consultez un exemple concret d'utilisation des variables dynamiques avancées dans votre modèle d'Email. Dans une Task Email automatique, nous avons créé un modèle d'Email dont le corps utilise plusieurs types différents de variables dynamiques avancées.
Bonjour
{{#if first_name}}{{first_name}}{{#else}}there{{#endif}},Nous savons que de nombreuses entreprises comme
{{#if industry == Marketing}}Company 1 {{#else}}{{#if industry == Big Data}}Company 2 {{#else}}Company 3{{#endif}}{{#endif}}recherchent de nouveaux outils à mettre en place pour
{{now_year->plus_1}}, et nous aimerions vous présenter notre plateforme afin que vous compreniez bien l'ensemble de nos capacités. Est-ce que{{now_weekday->plus_2}}ou{{now_weekday->plus_3}}{{now_time_of_day}}vous convient ?
Explication du cas d'utilisation : variables dynamiques imbriquées pointant vers des valeurs de champ spécifiques
La {{#if firstname}}{{firstname}}{{#else}}there{{#endif}} variable dynamique définit une valeur de secours pour le prénom afin qu'il s'affiche comme there si aucune donnée de prénom n'est disponible pour le destinataire de l'Email.
La partie {{#if industry == Marketing}}Company 1 de la variable dynamique indique à Apollo d'afficher le texte comme Company 1 si le champ Secteur du destinataire de l'Email est Marketing. Si le secteur n'est pas Marketing, Apollo passe à l'élément suivant de la logique conditionnelle.
La partie {{#else}}{{#if industry == Big Data}}Company 2 indique à Apollo d'afficher le texte comme Company 2 si le champ Secteur du destinataire de l'Email est Big Data. Si le champ Secteur n'est pas Marketing ou Big Data, Apollo passe à la partie de secours de la logique conditionnelle.
La variable dynamique {{#else}}Company 3 est la valeur de secours si le champ Secteur du destinataire de l'Email ne correspond pas à Marketing ou Big Data. Dans ce cas, le texte s'affiche comme Company 3 dans l'Email ouvert.
La dernière partie de la variable dynamique, {{#endif}}{{#endif}}, ferme la logique conditionnelle. Deux instructions {{endif}} sont requises car il y a des instructions {{#if}} imbriquées.
{{endif}} ai-je besoin ?En règle générale, pour chaque instruction {{#if}} dans votre variable dynamique, vous avez besoin d'une instruction correspondante {{#endif}} pour fermer la variable dynamique.
Explication du cas d’usage : variables dynamiques en temps réel
La variable dynamique {{now_year->plus_1}} indique à Apollo de prendre l’année en cours 2024 et d’y ajouter 1 an. Lorsque le destinataire ouvre cet email, cette variable s’affiche comme 2025.
La variable dynamique {{now_weekday->plus_2}} indique à Apollo de prendre le jour actuel de la semaine et de l’avancer de 2 jours. Si Apollo envoie l’email un lundi, le texte de l’email s’affiche comme Wednesday. Si Apollo envoie cet email un jeudi, le texte affichera la variable dynamique comme Monday car il s’agit du prochain jour ouvré disponible.
La variable dynamique {{now_weekday->plus_3}} indique à Apollo de prendre le jour actuel de la semaine et de l’avancer de 3 jours. Si Apollo envoie l’email un mardi, le texte de l’email s’affichera comme Friday. Si Apollo envoie l’email un mercredi, le texte s’affiche comme Monday. Apollo affiche la variable dynamique comme le prochain jour ouvré disponible si le jour de la semaine spécifié par la variable dynamique tombe un week-end.
Enfin, la variable dynamique {{now_time_of_day}} indique à Apollo d’afficher le moment actuel de la journée pour le destinataire en fonction de son heure locale dans son fuseau horaire local (lorsqu’il est disponible) et affiche morning, afternoon, ou evening.