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

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

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

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

Чтобы данные по событиям совместились с контактами, предварительно сделайте импорт контактов в базу аккаунта 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.