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

Якщо ви перейшли з іншого сервісу або щойно створили обліковий запис в eSputnik, а у вас накопичилася історія:

• offline-замовлень,
• активності контакту,
• підписок на послуги,
• або інших подій, за якими ви бажаєте здійснювати гнучку сегментацію бази для розсилок,

існує можливість передати наявні дані з вашої CRM або іншого сховища даних до системи. Для цього можна скористатися API-ресурсом Generate past events.

Щоб дані щодо подій поєдналися з контактами, заздалегідь здійсніть імпорт контактів до бази акаунта eSputnik.

Після цього ви можете передати ресурсом Generate past events усі необхідні події до бази акаунта для сегментації. Ресурс дозволяє вказати для кожної події час, коли вона сталася.

Обробка запитів асинхронна, і порядок обробки подій не гарантується. Тому для історичних подій орієнтиром є не порядок надсилання, а час, переданий у самій події в полі occurred. Опубліковані ліміти частоти запитів — 100 запитів за секунду для ресурсу Generate past events і 350 запитів за секунду для ресурсу Generate event. Повний перелік лімітів наведено в статті Rate Limits.

Припустимо, у вас є певна кількість таких замовлень за минулий рік, і ви хотіли б виділити сегмент клієнтів, які цікавляться певним типом товарів чи послуг, отримати вибірку щодо середньої вартості замовлення або навіть сегментувати контакти за певними геоданими (якщо така інформація у вас є).

Для цього треба конвертувати дані замовлення в JSON-формат, придатний для передачі по API, відповідно до специфікації та передати нам. У межах одного запиту можна передати масив до 500 таких подій/замовлень. Для кожного елемента необхідно вказати тимчасову мітку в полі occurred. Формат для дати: YYYY-MM-DD, формат для дати з часом: YYYY-MM-DDThh:mm:ss±hh:mm.

Прикладом може стати замовлення двох мобільних пристроїв з інтервалом купівлі в декілька років:

{
  "events": [
    {
      "eventTypeKey": "orderCreated",
      "keyValue": "test_v3_event_1",
      "params": {
        "phone": "380501234789",
        "externalOrderId": "12345679102",
        "externalCustomerId": "AA1100",
        "totalCost": "258.0",
        "status": "INITIALIZED",
        "date": "2025-01-05T13:00:00+02:00",
        "currency": "UAH",
        "items": [
          {
            "externalItemId": "200600",
            "name": "Super Device",
            "category": "devices",
            "quantity": 2,
            "cost": 999,
            "url": "http://example.com/item/200600",
            "imageUrl": "http://example.com/item/200600/image.png",
            "description": "High quality"
          }
        ]
      },
      "occurred": "2025-02-04T12:00"
    },
    {
      "eventTypeKey": "orderCreated",
      "keyValue": "test_v3_event_1",
      "params": {
        "phone": "380500000001",
        "externalOrderId": "12345679103",
        "externalCustomerId": "AA1111",
        "totalCost": "258.0",
        "status": "INITIALIZED",
        "date": "2025-01-07T13:00:00+03:00",
        "currency": "UAH",
        "items": [
          {
            "externalItemId": "200600",
            "name": "Super Device",
            "category": "devices",
            "quantity": 2,
            "cost": 999,
            "url": "http://example.com/item/200600",
            "imageUrl": "http://example.com/item/200600/image.png",
            "description": "High quality"
          }
        ]
      },
      "occurred": "2025-02-07T16:00"
    }
  ]
}

Окрім базових полів із назвою, ціною та посиланням на товар, можна переносити різноманітні супутні дані, які будуть доступними для побудови сегмента.

Раніше ми зазначали, що можна будувати сегменти за геоданими; для цього достатньо передати країну й місто покупця.

{
  "city": "Los Angeles",
  "country": "USA"
}

За наявними наборами даних за допомогою умовних груп ви матимете змогу будувати сегменти:

Також є можливість видалити застарілі події або такі, що втратили актуальність. Для цього можна відправити запит до цього ж ресурсу Remove events, але методом DELETE. При цьому в тілі запиту треба вказати часовий діапазон для видалення:

{
  "from": "2019-06-04",
  "to": "2020-01-04"
}

За замовчуванням метод DELETE вимкнено, для активації слід звернутися до служби технічної підтримки: [email protected].