First steps
User Data
- Email Builder Review
- Designing your email
- Creating a Synchronized Module
- Setting Responsivity
- Building Smart Containers
- Creating a Gmail Promotions Annotation
- Adding a Rollover Effect
- Adding a Background to an Email
- Adding Anchor Links
- Adding a Video to an Email
- Adding a Table to an Email
- Adding a Custom Font
- Adding Social Media Buttons
- Editing HTML and CSS
- Working with “Images” block
Omnichannel
- SDK for Mobile Apps
- Managing mobile SDK access keys
- Connecting Mobile App
- Creating a Google Project for Mobile Push Notifications
- Creating Mobile Push Messages
- Setting Up Delivery and Clicks Analytics
- Deep Links and Universal Links
- Scheduled Mobile Push Message
- Sending Test Messages from the Event Debug View
- Setting Up Widgets for Your Site
- Widget Calling
- Storing data from widgets to contact fields
- Using Annoyance Safeguard
- Actions After Form Submission
- Yespo Extension for Google Chrome
- Creating Pop-ups via Google Tag Manager or WordPress
- Sending Yespo Widget Events to Google Analytics
- Replacing Double Opt-In System Workflow
- Setting Up Locations for the Widget Calling Rules
Automation
Personalization
Analytics
- Email Campaign Report
- Web Push Campaign Report
- Viber Campaign Report
- Mobile Push Campaign Report
- App Inbox Campaign 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
Multilanguage Campaigns
Events and Behaviour Tracking
Recommendations
API
Security and Compliance
Integration
Identification of Contacts
Our platform uses scripts for the identification of contacts. Correct identification is essential for better mapping of contacts in tracking and in web push notifications.
The script collects data from the following sources, as described below.
Cookies
When a person visits your site for the first time, the only information about that visitor is the ID from the cookie file stored on the customer’s computer.
The script writes this ID into the customer’s browser. This ID is used for tracing and storing historical data about the customer.
UTM Tags
UTM tags are small snippets of code that you can add to the end of links that you insert in your messages. In our system, UTM tags are turned on by default.
The script takes the contact ID* from the UTM tag and uses it in the tracking events. Also, this contact ID is used for linking a web push token to the existing contact.
* The contact ID is the identifier of a customer, whose data you store in the system.
Important!
For the script to work properly, do not change the default values of the following tags:
- utm_source
- utm_content
Web Push
When your customer subscribes to web push notifications, a new contact is created in your contact’s base together with a web push token.
If the same contact follows a link in your message (for example, an email or a Viber message), the UTM tag in the link contains the contact ID, if it exists in your base.
In this case, we connect the contact ID of the existing contact and the web push token of the contact created later. The contact becomes more complete.
NOTE
You have to enable the Enable UTM tags for all language versions option when configuring your web push notifications. Read this information to learn more.
Subscription Form
A contact can enter the email address or a phone number in a subscription form that you show on your site. The script installed on your site identifies the contact ID connected to that address and saves it in the browser. This contact ID is substituted afterwards in tracking events or for checking the subscription status in subscription forms.
If there is no contact having such an email address or a phone number, a new contact ID is created.
NOTE
The contact ID received after a subscription using the subscription form has higher priority than that received after a subscription using a web-push notification.
Sending Events Using JavaScript Requests
You can send to our system the information that you collected about contacts on your website. This works if you have installed and activated the web tracking script on your site.
There are two ways to transfer the contact information:
- Using the Customer data event.
- Passing the information in the General Info object inserted into any event. See the example below.
eS('sendEvent', 'PageView', {
'PageView': {
"GeneralInfo": {
"externalCustomerId": "1234509876",
"user_email": "example@email.com",
"user_phone": "380501234567",
"user_es_contact_id": 100500
},
}
});
Read Transferring website behavior data via JavaScript requests for more details.
The transferred information is saved in our script. All the events passed to our system will contain this data.