Customer data sources

This post is also available in: Czech

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:

  1. Product feed
  2. Customer feed
  3. Order feed
  4. 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 popupthe 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


.

This post is also available in: Czech

Updated on January 15, 2025

Was this article helpful?

Related Articles