Как загрузить события по прошлым заказам в eSputnik
Если вы перешли из другого сервиса или только создали аккаунт в eSputnik, а у вас накоплена история
-
offline-заказов,
-
активности контакта,
-
подписки на услуги,
-
либо другие события, по которым вы хотите осуществлять гибкую сегментацию базы для рассылок,
есть возможность передать имеющиеся данные из вашей CRM или другого хранилища данных в систему. Для этого можно воспользоваться API-ресурсом v1/past_events.
Чтобы данные по событиям совместились с контактами, предварительно сделайте импорт контактов в базу аккаунта eSputnik.
Далее ресурсом v1/past_events вы можете передать все необходимые события в базу аккаунта для сегментации. Ресурс позволяет для каждого события указать время, когда оно произошло.
Рассмотрим типичное событие о покупке, которое при помощи v1/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"
}
По имеющимся наборам данных при помощи условных групп вы сможете строить сегменты:
Также есть возможность удалить устаревшие или утратившие актуальность события. Для этого можно отправить запрос к этому же ресурсу v1/past_events, но методом DELETE. При этом в теле запроса нужно указать временной диапазон для удаления:
{
"from" : "2019-06-04T10:47",
"to" : "2020-01-04T13:33"
}
По умолчанию метод DELETE выключен, для активации необходимо обратиться в службу технической поддержки: support@esputnik.com.