Надсилання історичних подій

Якщо ви перейшли з іншого сервісу або щойно створили обліковий запис в 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.