Импорт событий по прошлым заказам | Поддержка eSputnik

Email

Омниканальность

Автоматизация

Отправка исторических событий

Если вы перешли из другого сервиса или только создали аккаунт в eSputnik, а у вас накоплена история

  • offline-заказов,
  • активности контакта,
  • подписки на услуги,
  • либо другие события, по которым вы хотите осуществлять гибкую сегментацию базы для рассылок,

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

Важно

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

Если сегментация по событиям не входит в ваш тарифный план, пожалуйста, оставьте заявку по адресу sales@esputnik.com.

Как подключить сегментацию по событиям

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

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

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

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

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

{
	"events": [{
			"eventTypeKey": "orderCreated",
			"keyValue": "John@yourcompany.com",
			"params": [{
				"name": "email",
				"value": "John@yourcompany.com"
			}, {
				"name": "externalOrderId",
				"value": "9239234234234"
			}, {
				"name": "externalCustomerId",
				"value": "d8b6a037-4b6d-11eb-a2f0-0050569b2dc99902"
			}, {
				"name": "totalCost",
				"value": "258.0"
			}, {
				"name": "status",
				"value": "INITIALIZED"
			}, {
				"name": "date",
				"value": "2020-05-14T10:11:00"
			}, {
				"name": "currency",
				"value": "UAH"
			}, {
				"name": "items",
				"value": [{
					"externalItemId": "200600",
					"name": "Super Device",
					"category": "devices",
					"quantity": 1,
					"cost": 990,
					"url": "http://example.com/item/200600",
					"imageUrl": "http://example.com/item/200600/image.png",
					"description": "High quality"
				}]
			}],
			"occurred": "2023-03-22T14:30"
		},

		{
			"eventTypeKey": "orderCreated",
			"keyValue": "Hanna@yourcompany.com",
			"params": [{
				"name": "email",
				"value": "Hanna@yourcompany.com"
			}, {
				"name": "externalOrderId",
				"value": "9239234235555"
			}, {
				"name": "externalCustomerId",
				"value": "d8b6a578-4b6d-11eb-a2f0-0050569b2dc99902"
			}, {
				"name": "totalCost",
				"value": "546.0"
			}, {
				"name": "status",
				"value": "INITIALIZED"
			}, {
				"name": "date",
				"value": "2020-05-14T11:11:00"
			}, {
				"name": "currency",
				"value": "UAH"
			}, {
				"name": "items",
				"value": [{
					"externalItemId": "200601",
					"name": "New Device",
					"category": "devices",
					"quantity": 1,
					"cost": 990,
					"url": "http://example.com/item/200601",
					"imageUrl": "http://example.com/item/200601/image.png",
					"description": "High quality"
				}]
			}],
			"occurred": "2023-03-22T15:30"
		}
	]
}

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

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

{
	"name": "city",
	"value": "Los Angeles"
}, {
	"name": "country",
	"value": "USA"
}

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

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

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

{
 "from" : "2019-06-04",
 "to" : "2020-01-04"
}

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

Остались вопросы?
Специалисты обязательно ответят и помогут решить вашу проблему!
Обратный звонок
Оставьте заявку – и наш специалист свяжется с вами в рабочее время.
Отправить заявку
Консультация в чате
Готовы к вашим вопросам!
Написать в чат
Электронная почта
Напишите в службу поддержки eSputnik.
Отправить email