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
Omnichannel
- Setting Up Widgets for Your Site
- Widget Calling
- Setting Up Locations for the Widget Calling Rules
- Storing data from widgets to contact fields
- Using Annoyance Safeguard
- Actions After Form Submission
- 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
- Sending Extra Campaigns
- Sending Reminders at the Time Specified by the User
- Sending Campaign to Those Who Did Not Open the Previous One
- Using A/B Tests In Workflows
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
External ID for Creating and Updating Contacts
The external ID is a unique contact identifier generated in your system. We recommend using an external ID as the main identifier in the API request field externalCustomerId (or user_id in Mobile SDK). It will help you avoid duplicating contact profiles, collect all available data into a single contact profile, and get complete information about their interaction with your company.
Identifier Types
There are 2 types of contact identifiers — conditionally permanent and changeable:
- conditionally permanent — email, phone number, and other contact data received during contact’s registration.
- changeable — web cookies, mobile, telegram and web tokens.
As a rule, changeable IDs enter the system first, but the external ID is only linked to conditionally permanent IDs.
Important
The external ID must be created in your system at the time you first receive any conditionally permanent ID
To better understand how contact data enters the system and how to optimize contact identification, consider 2 basic use cases: creating contacts from mobile applications and websites.
Use Case 1. Creating and Updating Contact from the Mobile App
- Contact installs the application on a mobile device with Android OS.
- The application transfers the contact's mobile token to Yespo (Add/update a contact API method).
- Yespo creates a contact profile with this token as an ID.
- Contact registers in the application.
- Conditionally permanent identifiers such as email, phone number, or name enter your system.
- Your system assigns this contact a unique ID and passes it to Yespo along with other identifiers, including a mobile token (Add/update a contact API method).
- Yespo finds user profile with this mobile token and updates its profile by writing new identifiers to it.
Use Case 2. Creating and Updating Contact for the Website
- Non-logged-in contact visits your site.
- Appropriate cookies are transmitted and recorded in Yespo. The contact profile is not created (the web tracking script is used).
- Contact registers on the site or subscribes to the newsletter.
- Conditionally permanent identifiers such as email, phone number, or name enter your system.
- Your system assigns this contact a unique ID and passes it along with other IDs to Yespo (Add/update a contact or Subscribe contact).
- Yespo saves the contact with all transferred identifiers and adds their previous history of interaction with your site (cookies).
After a contact profile has been created in Yespo with the External ID field, we recommend making each profile’s update by this field — for example, at login (Add/update a contact) or creating order (Add orders or Generate event). In this way, you will be able to constantly maintain the relevance of all contact data since external ID is unique and immutable, while other identifiers, even conditionally constant ones, can change.
Note
If your system does not assign IDs to contacts, you can use Yespo's system ID (contactId) and save it on your side as a contact ID. However, using the external ID is a better option because this identification 100% prevents the creation of duplicates.
External ID in Single Contact API Methods
Updated logic of single API methods:
Add/update a contact
The system searches for a contact by external ID when getting a request:
- if the contact profile with this external ID is found, it is updated with the data from the request;
- if the contact profile with this external ID has been removed, it will be restored;
- if the contact profile is not found, it will be created in the system;
- if there is no external ID in the request, the creation logic remains unchanged.
Update contact
The contactId is specified in the request URL, and the external ID is passed in the body:
- if this external ID already belongs to the contact with another contactId, an error will occur;
- if the external ID does not belong to another contact, the contact will be updated and given that ID;
- if there is no external ID in the request, the creation logic remains unchanged.
Get contact
The external ID is added to contact data returned by request.
Subscribe contact
The external ID has the highest priority in the contact search logic; if the contact profile with this identifier is not found, the system searches for it by email address; if the email is not found — by phone number.
External ID in Bulk Contact API Methods
Updated logic of bulk API methods:
Search contacts
You can set the uniqueness of the contact search by the externalCustomerId field. In this case, you cannot set other search parameters.
Add/update contacts
When importing contacts to Yespo, you can use any field to define their uniqueness. For example, import contacts with uniqueness by email and, at the same time, add or update their external ID.
Export External ID to BigQuery and PostgreSQL
Export external IDs to BigQuery and PostgreSQL — they will appear in the corresponding column in the contacts table. By default, this option is available for all new exports. If you need to create one for existing exports, please contact our support team.
Finding Empty External IDs in Yespo Account
Create the dynamic segment to find all your contacts with empty external IDs.
- Go to Contacts → Segments → Add Segment and create the dynamic segment.
- Add condition: Fields → External ID → is empty and click Done.
The system will find all contacts without external IDs and place them into this segment. As the segment is dynamic, all new contacts without external IDs will be also automatically placed in it.