{"id":27239,"date":"2024-12-17T06:25:05","date_gmt":"2024-12-17T06:25:05","guid":{"rendered":"https:\/\/doc.probance.com\/?post_type=tutoriels&#038;p=27239"},"modified":"2025-11-11T06:45:04","modified_gmt":"2025-11-11T06:45:04","slug":"personalizing-your-emails-with-customer-profile-information","status":"publish","type":"tutoriels","link":"https:\/\/doc.probance.com\/en\/knowledge-base\/personalizing-your-emails-with-customer-profile-information\/","title":{"rendered":"Personalizing your emails with customer profile information"},"content":{"rendered":"\n<p><em>You can individualize your communication by including your clients profile information \u2013 such as their first and last name, or their birthday \u2013 in the emails addressed to them.<\/em><\/p>\n\n\n\n<p><em>This tutorial will explain how to add and format profile information in your newsletter and automated campaigns templates.<\/em><\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-style-info is-style-note is-layout-flow wp-block-quote-is-layout-flow\">\n<p>The following steps are illustrated with a Fastbuilder use case. The process is the same with the HTML and Easy Builder editors.<\/p>\n<\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"ancre1\">1. Introduction<\/h2>\n\n\n\n<p><strong>Personalization fields<\/strong>&nbsp;are tags corresponding to profile fields that you can include in your templates, and that will be replaced with the information of each recipient and their received emails. You can use them to address each contact with their civility, first and last name, include their registration date or birthday, \u2026<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1236\" height=\"861\" src=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-5.png\" alt=\"\" class=\"wp-image-27243\" style=\"width:700px\" srcset=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-5.png 1236w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-5-300x209.png 300w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-5-1024x713.png 1024w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-5-768x535.png 768w\" sizes=\"auto, (max-width: 1236px) 100vw, 1236px\" \/><\/figure>\n\n\n\n<h6 class=\"wp-block-heading\"><strong>Example of a template personalized with the recipient first name and registration date<\/strong><\/h6>\n\n\n\n<p>You can also define the format of those fields in the received emails with<strong>&nbsp;formatters<\/strong>. Formatters are expressions applied to personalization fields, to transform the data according to rules that you specify. You can, for example, capitalize the first and last name, or format the registration date field to display the date in full letters in the received message.<\/p>\n\n\n\n<p>The Fast Builder, East builder and HTML editors all contain an&nbsp;<strong>expression building tool<\/strong>&nbsp;that allows you to define the formatters to apply to the personalization fields included in your templates.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"ancre2\">2. Adding a personalization field<\/h2>\n\n\n\n<p>To add a personalization field in your template, place the cursor where you want to insert the information in your text and click on<strong>&nbsp;Perso field (1)<\/strong>&nbsp;in the toolbar to unroll the list of available fields.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"900\" height=\"446\" src=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/tutoriel_personnaliser_email_2_en.png\" alt=\"\" class=\"wp-image-27224\" style=\"width:700px\" srcset=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/tutoriel_personnaliser_email_2_en.png 900w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/tutoriel_personnaliser_email_2_en-300x149.png 300w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/tutoriel_personnaliser_email_2_en-768x381.png 768w\" sizes=\"auto, (max-width: 900px) 100vw, 900px\" \/><figcaption class=\"wp-element-caption\">Insertion of a personalization field in a template<\/figcaption><\/figure>\n\n\n\n<p>Select the field you want to use : the corresponding tag will be automatically added to the text.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"ancre3\">3. Formatting a personalization field<\/h2>\n\n\n\n<p>Place your cursor somewhere in the personalization tag you want to format and click on&nbsp;<strong>Format field (1)<\/strong>&nbsp;to open the expression building tool.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"495\" src=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-6-1024x495.png\" alt=\"\" class=\"wp-image-27246\" style=\"width:713px\" srcset=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-6-1024x495.png 1024w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-6-300x145.png 300w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-6-768x371.png 768w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-6.png 1236w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Opening the expression building tool<\/figcaption><\/figure>\n\n\n\n<p>The<strong>&nbsp;Formatter (1)<\/strong>&nbsp;dropdown list contains all the formatters available, grouped by data type on which they can be applied : string, number, integer, date and datetime. By default, the category corresponding to the type of the selected field is listed first.<\/p>\n\n\n\n<p>Select a formatter in the list to display its description and its parameters. To add the formatter to your expression, click on&nbsp;<strong>Add (2)<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1889\" height=\"932\" src=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-7.png\" alt=\"\" class=\"wp-image-27249\" srcset=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-7.png 1889w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-7-300x148.png 300w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-7-1024x505.png 1024w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-7-768x379.png 768w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-7-1536x758.png 1536w\" sizes=\"auto, (max-width: 1889px) 100vw, 1889px\" \/><figcaption class=\"wp-element-caption\">In this example, the registration date is transformed to be displayed in text format<\/figcaption><\/figure>\n\n\n\n<p>When your expression contains several formatters, they are applied in the order they are listed in the interface : formatter 1 is applied to the original data, formatter 2 is applied on the output of formatter 1, etc.<\/p>\n\n\n\n<p>You can modify the formatters order within your expression using the arrows.<\/p>\n\n\n\n<p>The simulator on the right of the interface allows you to test your expression. To launch a simulation, input the data to transform<strong>&nbsp;(1)<\/strong>&nbsp;and click on<strong>&nbsp;Execute (2)<\/strong>&nbsp;: you will be able to check the result of every formatter. The field<strong>&nbsp;Output of the simulation (3)<\/strong>&nbsp;returns the result of the full expression, which is how the data would appear in the received emails.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1889\" height=\"932\" src=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-8.png\" alt=\"\" class=\"wp-image-27252\" srcset=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-8.png 1889w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-8-300x148.png 300w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-8-1024x505.png 1024w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-8-768x379.png 768w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-8-1536x758.png 1536w\" sizes=\"auto, (max-width: 1889px) 100vw, 1889px\" \/><\/figure>\n\n\n\n<p>To confirm the expression and apply it to the selected personalization field in your message, click on&nbsp;<strong>Add and close<\/strong>. The expression will be automatically added to the tag in the editor.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"640\" height=\"368\" src=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-4.png\" alt=\"\" class=\"wp-image-27240\" srcset=\"https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-4.png 640w, https:\/\/doc.probance.com\/wp-content\/uploads\/2024\/12\/image-4-300x173.png 300w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"title4\">4. Include a personalization field in the email object<\/h2>\n\n\n\n<p>Message personalization is not limited to the email body : you can also include personalization fields in the object.<\/p>\n\n\n\n<p>The email object is configured in the <strong>Subject<\/strong> section of the campaign page, in the field <strong>Subject (with possible personalization)<\/strong>.<br><br>You can select a personalization field to add to your subject line by clicking on <strong>Personalization Field +<\/strong>, or simply copy and paste the generated expressions into the template editor. The formatters work here in the same way as they do in templates.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-style-info is-style-note is-layout-flow wp-block-quote-is-layout-flow\">\n<p>The substitution subject is the email subject line sent to recipients whose personalization fields are empty. It must always be provided and cannot contain any personalization fields.<\/p>\n<\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"ancre4\">5. Main formatters<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"ancreH241\">5.1. Text-typed fields<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Capitalize<\/strong><\/li>\n<\/ul>\n\n\n\n<p>The capitalize formatter converts the first letter of every word to uppercase.<\/p>\n\n\n\n<p><em>Example :\u2019jane doe\u2019 will be displayed as \u2018<strong>Jane Doe<\/strong>\u2018<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Upper_case<\/strong><\/li>\n<\/ul>\n\n\n\n<p>The&nbsp;<strong>upper_case<\/strong>&nbsp;formatter converts a string to uppercase.<\/p>\n\n\n\n<p><em>Example :\u2019Paris\u2019 will be displayed as \u2018<strong>PARIS<\/strong>\u2018<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Truncate<\/strong><\/li>\n<\/ul>\n\n\n\n<p>The&nbsp;<strong>truncate<\/strong>&nbsp;formatter truncates a text when its length is greater than a defined max value.<\/p>\n\n\n\n<p>There are 2 parameters to define :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>max : maximum number of characters to display<\/em><\/li>\n\n\n\n<li><em>suffix : text displayed to indicate that the text has been truncated<\/em><\/li>\n<\/ul>\n\n\n\n<p><em>Example : with the parameters max = 40 and suffix = \u2018\u2026\u2019, \u2018Bring the outdoors in to your interior spaces with this stunning dry grass sented candle\u2019 will be displayed as \u2018<strong>Bring the outdoors to your interior s\u2026<\/strong><\/em>\u2018<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Pretty_truncate<\/strong><\/li>\n<\/ul>\n\n\n\n<p>The&nbsp;<strong>pretty_truncate<\/strong>&nbsp;formatter truncates a text when its length is greater than a defined max value, without cropping any word : the cut is applied after a dot, a comma or a space.<\/p>\n\n\n\n<p>There are 3 parameters to define<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>max : maximum number of characters to display<\/em><\/li>\n\n\n\n<li><em>min : minimum number of characters to display after truncation<\/em><\/li>\n\n\n\n<li><em>suffix : text displayed to indicate that the text has been truncated<\/em><\/li>\n<\/ul>\n\n\n\n<p><em>Example :with the parameters max = 40, min = 35 and suffix = \u2018\u2026\u2019, \u2018Bring the outdoors in to your interior spaces with this stunning dry grass sented candle\u2019 will be displayed as \u2018<strong>Bring the outdoors to your interior (\u2026)<\/strong>\u2018<\/em><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"ancreH242\">5.2. Number-typed fields<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Price<\/strong><\/li>\n<\/ul>\n\n\n\n<p>The price formatter displays a number in a price format : thousands are separated with a comma and 2 numbers are displayed after the decimal point. If the original value contains only 1 decimal figure, the formatter will add a \u20180\u2019 behind it.<\/p>\n\n\n\n<p><em>Example : 1234.5 will be displayed as&nbsp;<strong>1,234.50<\/strong><\/em><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"ancreH243\">5.3. Date\/datetime-typed fields<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Date<\/strong><\/li>\n<\/ul>\n\n\n\n<p>The<strong>&nbsp;date&nbsp;<\/strong>formatter displays a date in MM\/DD\/YYYY format.<\/p>\n\n\n\n<p><em>Example : 2020-12-01 will be displayed as&nbsp;<strong>12\/01\/2020<\/strong><\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Dayname \/ Monthname<\/strong><\/li>\n<\/ul>\n\n\n\n<p>The&nbsp;<strong>dayname<\/strong>&nbsp;and&nbsp;<strong>monthname<\/strong>&nbsp;formatters allows you to extract the weekday and month (in full letters) of the date.<\/p>\n\n\n\n<p>Examples :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>2020-12-01 will be displayed as \u2018<strong>tuesday<\/strong>\u2018<\/em><\/li>\n\n\n\n<li><em>2020-12-01 will be displayed as \u2018<strong>december<\/strong>\u2018<\/em><\/li>\n<\/ul>\n<div id=\"wpmem_restricted_msg\"><p>This content is restricted to site members.  If you are an existing user, please log in.  New users may register below.<\/p><\/div><div id=\"wpmem_login\"><a id=\"login\"><\/a><form action=\"https:\/\/doc.probance.com\/en\/knowledge-base\/personalizing-your-emails-with-customer-profile-information\/\" method=\"POST\" id=\"wpmem_login_form\" class=\"form\"><input type=\"hidden\" id=\"_wpmem_login_nonce\" name=\"_wpmem_login_nonce\" value=\"f834b2436e\" \/><input type=\"hidden\" name=\"_wp_http_referer\" value=\"\/en\/wp-json\/wp\/v2\/tutoriels\/27239\" \/><fieldset><legend>Existing Users Log In<\/legend><label for=\"log\">Username or Email<\/label><div class=\"div_text\"><input name=\"log\" type=\"text\" id=\"log\" value=\"\" class=\"username\" required  \/><\/div><label for=\"pwd\">Password<\/label><div class=\"div_text\"><input name=\"pwd\" type=\"password\" id=\"pwd\" class=\"password\" required  \/><\/div><input name=\"a\" type=\"hidden\" value=\"login\" \/><input name=\"redirect_to\" type=\"hidden\" value=\"https:\/\/doc.probance.com\/en\/knowledge-base\/personalizing-your-emails-with-customer-profile-information\/\" \/><div class=\"button_div\"><input name=\"rememberme\" type=\"checkbox\" id=\"rememberme\" value=\"forever\" \/>&nbsp;<label for=\"rememberme\">Remember Me<\/label>&nbsp;&nbsp;<input type=\"submit\" name=\"Submit\" value=\"Log In\" class=\"buttons\" \/><\/div><\/fieldset><\/form><\/div><div id=\"wpmem_reg\"><a id=\"register\"><\/a><form name=\"form\" method=\"post\" action=\"https:\/\/doc.probance.com\/en\/knowledge-base\/personalizing-your-emails-with-customer-profile-information\/\" id=\"wpmem_register_form\" class=\"form\"><input type=\"hidden\" id=\"_wpmem_register_nonce\" name=\"_wpmem_register_nonce\" value=\"6cc3867c56\" \/><input type=\"hidden\" name=\"_wp_http_referer\" value=\"\/en\/wp-json\/wp\/v2\/tutoriels\/27239\" \/><fieldset><legend>New User Registration<\/legend><label for=\"username\" class=\"text\">Choose a Username<span class=\"req\">*<\/span><\/label><div class=\"div_text\"><input name=\"username\" type=\"text\" id=\"username\" value=\"\" class=\"textbox\" required  \/><\/div><label for=\"first_name\" class=\"text\">First Name<span class=\"req\">*<\/span><\/label><div class=\"div_text\"><input name=\"first_name\" type=\"text\" id=\"first_name\" value=\"\" class=\"textbox\" required  \/><\/div><label for=\"last_name\" class=\"text\">Last Name<span class=\"req\">*<\/span><\/label><div class=\"div_text\"><input name=\"last_name\" type=\"text\" id=\"last_name\" value=\"\" class=\"textbox\" required  \/><\/div><label for=\"user_email\" class=\"text\">Email<span class=\"req\">*<\/span><\/label><div class=\"div_text\"><input name=\"user_email\" type=\"email\" id=\"user_email\" value=\"\" class=\"textbox\" required  \/><\/div><input name=\"a\" type=\"hidden\" value=\"register\" \/><input name=\"wpmem_reg_page\" type=\"hidden\" value=\"https:\/\/doc.probance.com\/en\/knowledge-base\/personalizing-your-emails-with-customer-profile-information\/\" \/><div class=\"button_div\"><input name=\"submit\" type=\"submit\" value=\"Register\" class=\"buttons\" \/><\/div><div class=\"req-text\"><span class=\"req\">*<\/span>Required field<\/div><\/fieldset><\/form><\/div>","protected":false},"excerpt":{"rendered":"<p>You can individualize your communication by including your clients profile information \u2013 such as their first and last name, or their birthday \u2013 in the emails addressed to them. This tutorial will explain how to add and format profile information in your newsletter and automated campaigns templates. The following steps are illustrated with a Fastbuilder [&hellip;]<\/p>\n","protected":false},"author":6,"featured_media":0,"template":"","sujets":[635],"class_list":["post-27239","tutoriels","type-tutoriels","status-publish","hentry","sujets-email-channel"],"_links":{"self":[{"href":"https:\/\/doc.probance.com\/en\/wp-json\/wp\/v2\/tutoriels\/27239","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/doc.probance.com\/en\/wp-json\/wp\/v2\/tutoriels"}],"about":[{"href":"https:\/\/doc.probance.com\/en\/wp-json\/wp\/v2\/types\/tutoriels"}],"author":[{"embeddable":true,"href":"https:\/\/doc.probance.com\/en\/wp-json\/wp\/v2\/users\/6"}],"wp:attachment":[{"href":"https:\/\/doc.probance.com\/en\/wp-json\/wp\/v2\/media?parent=27239"}],"wp:term":[{"taxonomy":"sujets","embeddable":true,"href":"https:\/\/doc.probance.com\/en\/wp-json\/wp\/v2\/sujets?post=27239"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}