Як завантажити події за попередніми замовленнями в 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.