This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| en:how_to_personalize_emails [2021/01/12 11:57] – [Possible applications] fw | en:how_to_personalize_emails [2025/02/27 15:11] (current) – bk | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== How can elements of an e-mail | + | ====== How can elements of an email be personalized? |
| **Placeholders** are available for commonly used personalization like salutations. They can be easily selected by means of a button. | **Placeholders** are available for commonly used personalization like salutations. They can be easily selected by means of a button. | ||
| - | Personalizations that will only be used once can also be integrated via **XML**. We recommend this option in cases where defining a new placeholder would not be worthwhile, or if you want to replace entire sections of your source code. | + | Personalizations that will only be used once can also be integrated via **XML**. We recommend this option in cases where defining a new placeholder would not be worthwhile or if you want to replace entire sections of your source code. |
| ===== Placeholders ===== | ===== Placeholders ===== | ||
| - | Pre-defined placeholders are available to integrate personalized content | + | Pre-defined placeholders are available to integrate personalized content, such as a salutation or a current date, into an email message. |
| <WRAP round info 60%> | <WRAP round info 60%> | ||
| - | Placeholders always begin with a dollar sign $. A placeholder must be followed by a space or punctuation mark (e.g. comma, full stop, question mark, exclamation point) to be parsed correctly. | + | Placeholders always begin with a dollar sign $. A placeholder must be followed by a space or punctuation mark (e.g., comma, full stop, question mark, exclamation point) to be parsed correctly. |
| </ | </ | ||
| There are three types of placeholders. | There are three types of placeholders. | ||
| Line 19: | Line 19: | ||
| === Functions === | === Functions === | ||
| - | These placeholders are generally defined by complex functions with a fallback. For example, this is the case with all salutation placeholders, | + | These placeholders are generally defined by complex functions with a fallback. For example, this is the case with all salutation placeholders, |
| - | Some examples of globally available | + | Some examples of globally available |
| - | | $current_weekday_en | + | * **$current_weekday_en**: Current weekday, e.g., " |
| - | | $salutation_en_formal | + | * **$salutation_en_formal**: Male: Dear Mr. NAME, Female: Dear Ms. NAME, Fallback: Dear Sir or Madam, |
| - | | $salitation_en_firstname | Dear VORNAME, Fallback: Dear Reader, | + | * **$salutation_en_firstname**: |
| - | | $salutation_en_firstname_name | + | * **$salutation_en_firstname_name**: Dear VORNAME NAME, Fallback: Dear Reader, |
| Line 38: | Line 38: | ||
| - | === Statics | + | === Statistics |
| - | These placeholders are frequently used, predefined blocks of text. With these, you can insert a reference to the online version (// | + | These placeholders are frequently used, predefined blocks of text. With these, you can insert a reference to the online version (// |
| ==== Where can I find the placeholders? | ==== Where can I find the placeholders? | ||
| - | You can select all placeholders via a drop-down menu. Depending on the editor / e-mail | + | You can select all placeholders via a drop-down menu. Depending on the editor/email template you’re using, you can find the placeholders here in your email’s editing view: |
| - | | In an individually defined template or E-Mail-Builder, you can find them when editing single lines of text: | {{: | + | === In an individually defined template or E-Mail Builder, you can find them when editing single lines of text === |
| - | | In an individually defined template or E-Mail-Builder, you can find them when editing sections of text: | {{: | + | {{: |
| - | | In the default editor (HTML/Text multipart or Text): | {{:en:personalisation_multipart2015.png? | + | |
| + | === In an individually defined template or E-Mail Builder, you can find them when editing sections of text === | ||
| + | {{: | ||
| + | |||
| + | === In the default editor (HTML/Text multipart or Text) === | ||
| + | {{:en:delivery_drafts_creatives_placeholder_multi.png? | ||
| ==== Other variables ==== | ==== Other variables ==== | ||
| - | Other variable content that can be used in e-mails: | + | Other variable content that can be used in emails |
| | $from_address | Sender’s address | | | $from_address | Sender’s address | | ||
| | $redirect_domain | Redirect your sender’s domain | | | $redirect_domain | Redirect your sender’s domain | | ||
| Line 61: | Line 66: | ||
| | $campaignId (in links only: $camp_id) | ID of the campaign the message is set up in | | | $campaignId (in links only: $camp_id) | ID of the campaign the message is set up in | | ||
| | $lid | ID of message | | | $lid | ID of message | | ||
| - | | $id (or: $user_id) | ID of recipient | | + | | $id (or: $user_id) | unique |
| ===== XML Syntax ===== | ===== XML Syntax ===== | ||
| - | Using XML syntax, you can integrate personalized elements directly into an e-mail’s source code. In addition to personalized salutations, | + | Using XML syntax, you can integrate personalized elements directly into an email’s source code. In addition to personalized salutations, |
| ==== Short documentation ==== | ==== Short documentation ==== | ||
| Line 82: | Line 87: | ||
| <WRAP round tip 80%> | <WRAP round tip 80%> | ||
| - | You can not nest multiple loops using this code. Instead, a placeholder should be defined for more complex tasks. | + | You cannot |
| </ | </ | ||
| Line 103: | Line 108: | ||
| ===== Possible applications ===== | ===== Possible applications ===== | ||
| - | Placeholders and XML syntax can be used in the following sections of an e-mail: | + | Placeholders and XML syntax can be used in the following sections of an email: |
| * HTML source code | * HTML source code | ||
| * TXT section | * TXT section | ||
| * Template editors [change into source code view when using XML!] | * Template editors [change into source code view when using XML!] | ||
| - | Depending on the placeholder’s type, you can also use personalization in subject lines, sender names and inside links: | + | Depending on the placeholder’s type, you can also use personalization in subject lines, sender names, and inside links: |
| - | | Subject line | Functions, fields, variables, XML (not in network campaigns!) | | + | | Subject line | Functions, fields, variables, |
| | Links | Fields, $newsletterId, | | Links | Fields, $newsletterId, | ||
| - | | Sender name | Functions, fields, variables | | + | | Sender name | Functions, fields, |
| - | Placeholders in links are replaced by the actual content at the moment of clicking. This allows security-relevant data to be " | + | Placeholders in links are replaced by the actual content at the moment of clicking. This allows security-relevant data to be " |
| <WRAP round tip 80%> | <WRAP round tip 80%> | ||
| - | We recommend testing your e-mail’s personalization by sending test e-mails! | + | We recommend testing your email’s personalization by sending test emails! |
| For technical reasons, some variables are not visible in the promio.connect preview. | For technical reasons, some variables are not visible in the promio.connect preview. | ||
| </ | </ | ||
| Line 122: | Line 127: | ||
| - | + | {{tag>emails personalizations placeholders | |
| - | + | ||
| - | {{tag>e-mail personalization placeholder xml-syntax functions statics}} | + | |