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

Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email