Customer data format

Required columns:

  • uniq_id: Customer ID. For example, the customer ID in the CRM. An arbitrary string.

Optional columns:

You can change any data.

  • name: Customer name. An arbitrary string.
  • create_date_time: Date and time of contact creation in the tag's time zone. Learn more
  • update_date_time: Date and time of contact update in the tag's time zone. Learn more
  • client_ids: List of ClientIDs.
  • emails: List of the customer's email addresses. A string in Latin characters including the @ sign and a domain name. Don't use uppercase letters. Example: mail@yandex.ru.
  • phones: List of the customer's phone numbers. A numeric string containing a mobile phone number with a country code. You can't use spaces or extra characters. For example: 79995551111.
  • emails_md5: List of the customer's email addresses that are MD5 hashed.
  • phones_md5: List of the customer's phone numbers that are MD5 hashed.
Tip. To work with data from your CRM, pass complete customer information: ClientID, email address, and phone number. You need to pass at least one of the customer characteristics.
You can also pass additional information about customers, such as their type (individual or business). To do this:
  1. Create an attribute that will match your additional parameter using the POST /cdp/api/v1/counter/{counterId}/schema/attributes method.
  2. Pass this attribute along with other customer data using the POST /cdp/api/v1/counter/{counterId}/data/contacts method (CSV or JSON). In JSON format, you can use the attribute_values array for convenience.