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}} | + |