First steps
User Data
- Responsive Email Editor Review
- Designing your email
- Creating Synchronized Modules
- Setting Up Responsive Email Design
- Setting Up Smart Containers
- Creating a Gmail Promotions Annotation
- Adding The Rollover Effect
- Adding Anchor Links
- Module Library
- Adding a Table to an Email
- Adding Custom Fonts
- Creating CTA Button
- Working with Images
- Creating Timer
- Using AI in the Email Editor
- Messenger Protocol Support in Email Clients and Platforms
Omnichannel
- Setting Up Widgets for Your Site
- Widgets Gamification
- Widget Calling
- Setting Up Locations for the Widget Calling Rules
- Storing data from widgets to contact fields
- Using Annoyance Safeguard
- Actions After Subscription
- Replacing Double Opt-In System Workflow
- Creating Pop-ups via Google Tag Manager or WordPress
- Sending Yespo Widget Events to Google Analytics
- Using A/B Tests for Widgets
- Collecting Contact Information Using Request Forms
Automation
- Building and Editing Workflows
- Configuring Workflow Start/Stop Conditions
- Start Block
- Popular Blocks
- Message Blocks
- Using One from Many Message Block
- Contact Blocks
- Conditions Blocks
- Other Blocks
- Message to Segment Blocks
- Time Blocks
- Advanced Workflow Block Parameters
- Setting Up Allowed Send Time
- Using Workflow Launch History
- Webhook Workflows
- Workflow Troubleshooting
- Double Opt-In
- Welcome Сampaign
- Welcome Series Segmented by Category
- Launching a Workflow After a Contact Import
- Regular Workflow for a Segment
- Birthday Campaign
- Linking Workflow to the Button
- Using Variables from Order in Workflow
- Collecting Order Feedback
- Customer Reactivation
- Using A/B Tests In Workflows
- Sending Extra Campaigns
- Sending Reminders at the Time Specified by the User
- Sending Campaign to Those Who Did Not Open the Previous One
Personalization
Analytics
- Email Campaign Report
- Web Push Campaign Report
- Viber Campaign Report
- Mobile Push Campaign Report
- App Inbox Campaign Report
- Telegram Campaign Report
- In-App Report
- Widget Report
- Triggered Campaign Report
- AMP Campaign Report
- SMS Campaign Report
- Multilingual Campaign Report
- Setting up UTM Tags
- Revenue from Campaigns
- Tracking Campaign Performance in Google Analytics 4
- Message Analytics
Multilanguage Campaigns
Events and Behaviour Tracking
Recommendations
API
Security and Compliance
Merge Tags Cheat Sheet
Merge tags are a powerful tool for personalizing your communications in Yespo. They allow you to use dynamic content for personalized interactions with the contacts, making each touchpoint more relevant and engaging.
Merge Tags in Messages
In messages, you can use 2 types of merge tags:
- Standard: Default merge tags.
- Custom: Additional fields you can create in the system.
These tags substitute the contact information from the contact card you add manually or using API.
Read this article to learn how to personalize your messages using merge tags.
Standard Merge Tags
| Name | Merge tag | How it works |
|---|---|---|
| First name | %FIRSTNAME|% | Inserts the contact's first name. |
| Last name | %LASTNAME|% | Inserts the contact's last name. |
| Full name | %FIRSTNAME|% %LASTNAME|% | Inserts the contact's full name. |
| %EMAIL|% | Inserts the contact's email address. | |
| SMS | %SMS|% | Inserts the contact's phone number. |
|
External customer ID |
%EXTERNAL_CUSTOMER_ID|% | Inserts the contact’s unique identifier generated in your system. |
| Town | %TOWN|% | Inserts the city or town name. |
| Address | %ADDRESS|% | Inserts the contact’s address. |
| Region | %COUNTY|% | Inserts the name of the administrative division within a country. |
| Postcode | %POSTCODE|% | Inserts the postal code. |
| Group name | %GROUP.NAME|% | Inserts the name of the segment. |
| Message name | %MESSAGENAME|% | Inserts the name of the message. |
The symbol % denotes the start and end of merge tags in messages. This indicates that the text between these symbols should be replaced with dynamic content.
You can use the vertical bar (|) before the closing % symbol and add alternative text between them that will be shown to the contact if the contact field corresponding to the merge tag is empty.
Example:
If the first name exists in the contact card, it will be shown in the message.
If there is no first name, the alternative text will be shown.
Custom Tags
You can add your custom tags following these instructions.
Using Merge Tags with Velocity Commands
You can pull dynamic content using the $!data.get(‘’) command. Use only the tag name without the % and |% symbols.
Example:
$!data.get(‘FIRSTNAME’)
Read this article to learn more.
Adding Combined Merge Tags
You can combine several merge tags in a message by adding the corresponding statement in the message code.
- Click the Code editor icon, and click anywhere outside the stripes to view the entire code.
- Add the statement in the following format before the first opening <tr> tag:
where substitute MERGETAG1 and MERGETAG2 with your merge tag names.<!--#set($var='%MERGETAG1|% %MERGETAG2|%')-->
You can add other characters and spaces between the tags.
Example:<!--#set($var='%EVENT.NY_SALE|%: %EVENT.NY_BONUS|%%')--> -
Add the following statement after the last </tr> closing tag in the message:
<!--#*end--> - Type $var in the message where you want to show your combined tags.
When you send your message, the variable is substituted with the corresponding values of the merge tags, as in the following picture.
Using Merge Tags in Links
Merge tags can be used in links to personalize the content for each recipient.
Example:
- https://example.com?name=%FIRSTNAME%&email=%EMAIL%
In this example, %FIRSTNAME% and %EMAIL% will be replaced with the corresponding values for each recipient.
When the email is sent out, the link will look something like this for the recipient:
- https://example.com/?name=Randy&email=hallraw@example.com
