Первые шаги

есть возможность передать имеющиеся данные из вашей CRM или другого хранилища данных в систему. Для этого можно воспользоваться API-ресурсом Generate past events.

Чтобы данные по событиям совместились с контактами, предварительно сделайте импорт контактов в базу аккаунта eSputnik.

Далее ресурсом Generate past events вы можете передать все необходимые события в базу аккаунта для сегментации. Ресурс позволяет для каждого события указать время, когда оно произошло.

Рассмотрим типичное событие о покупке, которое при помощи Generate event передается в аккаунт, чтобы уведомить клиента, что его заказ принят, или сообщить, что заказ обработан и передан для доставки почтовой службе. Словом, совершить отправку транзакционного уведомления любым из доступных медиаканалов (или тем, который клиент считает предпочтительным).

{

  "eventTypeKey": "orderCreated",

  "keyValue": "buyer.contact@email.com",

  "params": [{

  "name": "email",

  "value": "buyer.contact@email.com"

 },{

  "name": "product_name",

  "value": "Apple iPhone 11 256Gb Black"

 },{

  "name": "image_url",

  "value": "https://example.com/iphone11.png"

 },{

  "name": "product_url",

  "value": "https://example.com/iphone11"

 },{

  "name": "cost",

  "value": "34 999"

 }]

}

Допустим, у вас есть некоторое количество таких заказов за прошлый год и вам бы хотелось выделить сегмент клиентов, интересующихся определенным видом товаров или услуг, получить выборку по среднему чеку или даже сегментировать контакты по некоторым геоданным (если такая информация у вас есть).

Для этого нужно преобразовать данные заказы в JSON-формат, пригодный для передачи по API, согласно спецификации и передать нам. В рамках одного запроса можно передать массив до 500 таких событий/заказов. Для каждого элемента необходимо указать временную метку в поле occurred. Формат для даты: YYYY-MM-DD, формат для даты со временем: YYYY-MM-DDTHH:mm.

Примером может послужить заказ двух мобильных устройств с интервалом покупки в год:

{

 "events": [

 {

  "eventTypeKey": "orderCreated",

  "keyValue": "buyer.contact@email.com",

  "params": [{

  "name": "email",

  "value": "buyer.contact@email.com"

 },{

  "name": "product_name",

  "value": "Apple iPhone 11 256Gb Black"

 },{

  "name": "image_url",

  "value": "https://example.com/iphone11.png"

 },{

  "name": "product_url",

  "value": "https://example.com/iphone11"

 },{

  "name": "cost",

  "value": "34 999"

 }],

  "occurred": "2020-06-04T13:43"

 },{

  "eventTypeKey": "orderCreated",

  "keyValue": "buyer.contact@email.com",

  "params": [{

  "name": "email",

  "value": "buyer.contact@email.com"

 },{

  "name": "product_name",

  "value": "Apple iPhone Xs Max 256Gb Space Gray"

 },{

  "name": "image_url",

  "value": "https://example.com/iphoneXs.png"

 },{

  "name": "product_url",

  "value": "https://example.com/iphoneXs"

 },{

  "name": "cost",

  "value": "27 999"

 }],

  "occurred": "2019-05-04T14:17"

 }]

}

Помимо базовых полей с названием, ценой и ссылкой на товар, можно передать любые сопутствующие данные, которые будут доступны для построения сегмента.

Ранее мы упоминали, что можно строить сегменты по геоданным, для этого достаточно передать страну и город покупателя.

{

 "name": "city",

 "value": "Los Angeles"

},{

 "name": "country",

 "value": "USA"

}

По имеющимся наборам данных при помощи условных групп вы сможете строить сегменты:

Построение сегментов

Также есть возможность удалить устаревшие или утратившие актуальность события. Для этого можно отправить запрос к этому же ресурсу Remove events, но методом DELETE. При этом в теле запроса нужно указать временной диапазон для удаления:

{

 "from" : "2019-06-04",

 "to" : "2020-01-04"

}

По умолчанию метод DELETE выключен, для активации необходимо обратиться в службу технической поддержки: support@esputnik.com.