This post is also available in:
Samba.ai is a modern platform designed for marketing automation that helps e-shops and other businesses personalize communication with customers based on available data. For effective operation, the platform requires access to relevant information about customers and products.
Data feeds
Samba.ai uses data feeds as a key source of information about customers, orders, and products. These feeds enable the import of data into Samba’s internal database, forming the foundation for analysis and personalization.
The platform supports four types of data feeds:
- Product feed
- Customer feed
- Order feed
- Category feed (optional)
More details about each feed can be found in our article Data feeds.
Customer Data Structure
Customer Feed
Customers imported through the customer feed include, among other things, the following information:
- ID: A unique identifier assigned during website registration based on the CUSTOMER_ID attribute.
- Registration Date: The creation date of the customer account based on the REGISTRATION attribute.
- Email Subscription Status: Subscription status (Every day / Special occasions / Never) based on the NEWSLETTER_FREQUENCY attribute.
Order feed
For customers created solely based on their presence in the order feed, the basic attributes are assigned as follows:
- ID: The customer’s email address.
- Registration Date: January 1, 1970.
- Email Subscription Status: Depends on the “Subscribe unregistered customers” setting; see more details in this article.
Contact Management in Samba
Samba.ai allows full control over the customer database through Contact Management. You can:
- Add New Customers and Subscribe them
- ID: imported- the customer’s email address
- Registration Date: The date the customer was added.
- Email Subscription Status: “Every day”
- Remove from Message Distribution
- Email Subscription Status: “Never”.
- Add to Message Distribution (Subscribe)
- Email Subscription Status: “Every day”.
- Delete Customers
- The customer is permanently removed from your database.
Adding Email Contacts
Emails can be added to the database individually or in bulk using a .CSV file. This file must contain only email addresses, each on a separate line:
test1@eshop.com
test2@eshop.com
test3@eshop.com
test4@eshop.com
After uploading, changes will be applied during the next database update. For immediate synchronization, click the “Refresh” button in the Integration section.
Deleting Contacts
When a contact is deleted using the “Delete Customers” feature, the record is permanently erased and cannot be re-imported, either manually or through data feeds. Detailed instructions are available in the article How to Reduce Contact Numbers.
Welcome Campaigns and the submitPopupEmail Method
When an email is added through a pop-up form in Welcome Campaigns or through the successful completion of the submitPopupEmail method, Samba automatically creates a customer with the following attributes:
- ID: Format popup–the customer’s email address.
- Registration Date: The date of addition to the feed.
- Email Subscription Status: Every day.
Overview of Customer Data by Source
Customer Data Source |
ID |
Registration day |
Default Email Subscription Status |
Customer feed |
ID assigned by the client in the feed |
Registration date |
Every day/Special occasions/Never |
Order feed |
Customer’s email |
January 1, 1970 |
Every day/Never |
Welcome Pop-up or submitPopupEmail Method |
popup-email |
Date of addition to the feed |
Every day |
Contact Management |
imported-email |
Date of import |
Every day |
.