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

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

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

есть возможность передать имеющиеся данные из вашей 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.