Автоматизация работы с заказами

Автоматизация заказов позволяет обрабатывать продажи, отправлять триггерные транзакционные серии сообщений и персонализированные уведомления.

Передача заказов API-ресурсом  Add orders

Для передачи заказов необходимо настроить вызов специального API-ресурса Add orders. В запросе можно передать  до 1000 заказов.

Каждый раз когда вы передаете заказ API-ресурсом, в системе создается событие, которое может запускать сценарий. Создаются события нескольких типов. Для каждого статуса заказа тип события будет свой, что позволяет настроить отдельные триггеры для каждого изменения статуса заказа. 

Названия событий состоят из двух частей: слова order и  дописанного к нему статуса заказа, например: orderINITIALIZED, orderIN_PROGRESS, orderDELIVERED, orderCANCELLED, orderABANDONED_SHOPPING_CART.

Чтобы посмотреть созданные события, перейдите в раздел “Триггеры” →  “История событий”:

Каждое событие содержит обязательные параметры и может содержать дополнительные параметры:

• ${eventKey}  — ключ уникальности события, передаётся в поле externalOrderId. Используется как идентификатор заказа;

• ${orderId}  — ID события в системе; параметр нужен для работы сценария;

• ${contactId}  — ID контакта в системе;

• ${EmailAddress}  — адрес электронной почты контакта, если он передаётся в событии;

• ${SMS}  — номер телефона контакта, если он передается в событии.

Чтобы подставить значения параметров в сообщения, передавайте поля с параметрами события в виде массива.

• Обязательные поля в массиве orders: externalOrderId, externalCustomerId, totalCost, status, date, email или phone. 

• Обязательные поля в массиве items: (externalItemId, name, quantity, cost, url, imageUrl).

Массив с товарами items можно не передавать, если в письмах данные о товарах не нужны, или вы передаете заказы только для RFM-анализа.

См. полный список полей заказа с описаниями >

Пример тела запроса:

{
    "orders": [{
        "externalOrderId": "100500",
        "externalCustomerId": "12345",
        "totalCost": 1000,
        "status": "INITIALIZED",
        "date": "2017-03-08T09:30:00+02:00",
        "email": "mail@example.com",
        "phone": "380942583691",
        "firstName": "John",
        "lastName": "Smith",
        "currency": "USD",
        "shipping": 10,
        "discount": 0,
        "deliveryMethod": "express",
        "paymentMethod": "cash",
        "deliveryAddress": "First str. 1",
        "items": [{
            "externalItemId": "200600",
            "name": "Super Device",
            "category": "devices",
            "quantity": 1,
            "cost": 990,
            "url": "http://example.com/item/200600",
            "imageUrl": "http://example.com/item/200600/image.png",
            "description": "High quality"
        }]
    }]
}

Успешный ответ на запрос будет содержать статус 200.

По заказам со статусом DELIVERED можно настроить сегментацию с такими условиями: средний чек, количество продаж и дата последней продажи.

ABANDONED_SHOPPING_CART  — статус для брошенных корзин. Используйте этот статус, если вы сами занимаетесь определением брошенных корзин.  При использовании веб-трекинга  настраивать API для брошенных корзин не нужно.

Для обновления статуса или других данных заказа передавайте обновленный заказ с тем же externalOrderId. По этому параметру в системе определяется уникальность заказов.

Чтобы проверить корректность передачи заказа, перейдите в раздел:

 “Триггеры” → “Заказы” вашего аккаунта eSputnik. Кликните на ID заказа и просмотрите все поля в формате JSON.

Чтобы просмотреть информацию о контакте, нажмите значок “Предварительный просмотр контакта”

Создание сценариев

Каждый раз когда вы передаете заказ по API, в системе создается событие, которое может запускать сценарий. События создаются нескольких типов. Для каждого статуса заказа тип события будет свой, что позволяет вам настроить отдельные триггеры для каждого изменения статуса заказа. Названия событий состоят из слова order и дописанного к нему статуса заказа. То есть возможны такие события: orderINITIALIZED, orderIN_PROGRESS, odrerDELIVERED, orderCANCELLED и orderABANDONED_SHOPPING_CART. Создаваемые события вы можете увидеть в Истории событий:

В качестве ключей событий используются ваши идентификаторы заказов (те, которые вы передаете в параметре "externalOrderId"). События по заказам содержат такие параметры:

• ${eventKey} - ключ уникальности заказа содержит значение поля "externalOrderId";
• ${orderId} - id заказа в базе eSputnik. Параметр нужен для работы сценария;
• ${contactId} - id контакта в eSputnik;
• ${EmailAddress} - email-адрес покупателя (если передан в заказе);
• ${SMS} - номер телефона покупателя (если передан в заказе).

Для создания сценария выбираем Триггеры → Сценарии → Добавить сценарий

Указываете название сценария (Заказ доставлен, Заказ в процессе и т.д). Сценарий будет выглядеть следующим образом:

В сценарии нужны такие блоки:

• блок Задача - Получить заказ. С помощью данного блока система вытянет все данные о заказе и передаст в письмо
• блок Email (или SMS). Выбираете письмо (сообщение), которое вы предварительно создали для данного сценария (уведомление о заказе, оставьте отзыв и т.д)

Сохраняем сценарий. Конечно, сценарий может быть более сложный. Можно вместо одного сообщения сделать серию. Письмо с отзывом обычно настраивают в сценарии для доставленного заказа. Перед отправкой письма ставится таймер на 1-2 недели.

Запуск сценария

После создания сценария необходимо его запустить. Для этого нажимаем Установите условие запуска, а после выбора условия кликаем на кнопку запуска сценария.

В открывшемся окне выберите событие, которое запустит сценарий.

В итоге активный и работающий сценарий будет выглядеть следующим образом: