​​​​​​​Передача даних про поведінку відвідувачів сайту через REST API

Ви можете передавати до eSputnik події, щоб:

  • точніше вибирати товари для покинутих кошиків і переглядів,
  • пропонувати рекомендації на сторінках оформлення замовлення,
  • управляти аудиторіями користувачів та ін.

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

  1. Через браузер, викликаючи функцію eS.JS.
  2. З бекенда, використовуючи REST API.

У цій інструкції ми детально розглянемо другий варіант.

📘

Важливо

При налаштуванні трекінгу через REST API функціонал рекомендацій на сайті буде недоступний; у цьому випадку треба використовувати варіант виклику функцій eS.JS

Заголовки запиту

  • POST / HTTP/1.1
  • Host: https://tracker.esputnik.com/api/v2
  • Content-type: application/json

Код відповіді 200. Авторизація не потрібна.

ProductPage

Опис

Для якісного ранжування товарів/категорій або для відправлення тригерів за покинутими переглядами необхідно надіслати запит, у якому буде вказано:

  • яку картку товару на поточний момент переглядає користувач,
  • ціну та наявність товару.

Приклад

{
  "GeneralInfo": {
    "eventName": "ProductPage",
    "siteId": "8A412DC",
    "datetime":1579622183208,
    "externalCustomerId": "1234509876",
    "user_phone": "1-541-754-3010",
    "user_email": "[email protected]",
    "user_name": "Gregori Boczynski",
    "user_es_contact_id": "255830499",
    "cookies": {
      "sc": "CDA68358-94FB-4D83-9655-3FEB3C4114A3"
    }
  },
  "ProductPage": {
    "Product": {
      "productKey": "72354",
      "price": "754 USD",
      "isInStock": "1",
      "tag_something": [
        "abc",
        "bca"
      ]
    },
    "Tags": {
      "some_tags": [
        "some_tag1",
        "some_tag2"
      ]
    }
  }
}

Параметри

НазваПрикладОпис
GeneralInfoОбов'язковий
Тип: Object
Загальна інформація
eventNameProductPage
Обов'язковий
Тип: String
Назва події, що відправляється
siteId8A412DC
Обов'язковий
Тип: String
• Ідентифікатор вашого магазину, можна отримати в підтримці eSputnik • Статичний параметр
externalCustomerId1234509876
Необов'язковий
Тип: String
Зовнішній ідентифікатор контакту
user_phone1-541-754-3010
Необов'язковий
Тип: String
Номер телефону в міжнародному форматі
user_email[email protected]
Необов'язковий
Тип: String
Email користувача
user_nameGregori Boczynski
Необов'язковий
Тип: String
Ім'я та прізвище користувача
user_es_contact_id255830499
Необов'язковий
Тип: String
ID клієнта в базі eSputnik
cookiesCDA68358-94FB-4D83-9655-3FEB3C4114A3
Обов'язковий
Тип: Object String
Cookie sc – це cookie, згенерована нашим скриптом, якщо він встановлений на вашому сайті. Кожна cookie має бути унікальною для кожного користувача. Ви можете створювати cookie власноруч. Приклад виклику цієї cookie із javascript document.cookie, потрібна нам cookie має ім'я "sc"
datetime1579622183208Timestamp (millisecond)
ProductPageОбов'язковий
Тип: Object
Опис події
productKey72354
Обов'язковий
Тип: String
• Ідентифікатор товару • Має збігатися з productKey на сторінці StatusCart та PurchasedItems
price754 USD
Необов'язковий
Тип: String
• Ціна за одиницю товару. Може передаватися із позначенням грошової валюти • Якщо ціна на сайті змінилася, а у фіді ще ні, то до бази запишеться значення з сайту
isInStock1
Необов'язковий
Тип: Int
• Відповідає за наявність товару • Параметр може набувати двох значень: 0 - товару немає в наявності, 1 - товар є в наявності • Якщо наявність товару на сайті змінилася, а у фіді ще ні, то до бази запишеться значення з сайту
tag_[something]["abc","bca"]
Необов'язковий
Тип: Array of Strings
• Усі додаткові поля можуть передаватися в цьому параметрі, обов'язковим є префікс tag_, після якого можна написати будь-яку назву • Таких параметрів може бути кілька • Значення цього параметра передається у вигляді масиву даних, який можна записувати через кому
TagsНеобов'язковий
Тип: Object
Додаткові поля

StatusCart

Опис

Подія, що відправляється в момент зміни кошика (з новим GUID), наприклад на картці товару або сторінці категорій за кнопкою Купити. Кошик має оновлюватися з усіх сторінок. Якщо кошик порожній, то необхідно відправити порожній кошик (порожній масив без товарів).

Приклад

{
  "GeneralInfo": {
    "eventName": "StatusCart",
    "siteId": "8A412DC",
    "datetime":1579622183208,
    "externalCustomerId": "1234509876",
    "user_phone": "1-541-754-3010",
    "user_email": "[email protected]",
    "user_name": "Gregori Boczynski",
    "user_es_contact_id": "255830499",
    "cookies": {
      "sc": "CDA68358-94FB-4D83-9655-3FEB3C4114A3"
    }
  },
  "StatusCart": {
    "GUID": "6F9619FF-8B86-D011-B42D-00CF4FC964FF",
    "Products": [
      {
        "productKey": "430738",
        "price": "201.95",
        "discount": "180",
        "quantity": 1,
        "price_currency_code": "UAH",
        "tag_something": [
          "aaa",
          "bbb"
        ]
      },
      {
        "productKey": "902339",
        "price": "596",
        "discount": "590",
        "quantity": 1,
        "price_currency_code": "UAH",
        "tag_something": [
          "aaa",
          "bbb"
        ]
      }
    ],
    "Tags": {
      "some_tags": [
        "1",
        "a2"
      ],
      "some_tags1": [
        "4",
        "gg"
      ]
    }
  }
}

Параметри

НазваПрикладОпис
GeneralInfoОбов'язковий
Тип: Object String
Загальна інформація
eventNameStatusCart
Обов'язковий
Тип: String
Назва події, що відправляється
siteId8A412DC
Обов'язковий
Тип: String
• Ідентифікатор вашого магазину можна отримати в підтримці eSputnik • Статичний параметр
externalCustomerId1234509876
Необов'язковий
Тип: String
Зовнішній ідентифікатор контакту
user_phone1-541-754-3010
Необов'язковий
Тип: String
Номер телефону в міжнародному форматі
user_email[email protected]
Необов'язковий
Тип: String
Email користувача
user_nameGregori Boczynski
Необов'язковий
Тип: String
Ім'я/Прізвище користувача
user_es_contact_id255830499
Необов'язковий
Тип: String
ID клієнта в базі eSputnik
datetime1579622183208Timestamp (millisecond)
GUID6F9619FF-8B86-D011-B42D-00CF4FC964FF
Обов'язковий
Тип: String
• Відображає поточний склад кошика • Може бути згенерований із випадкових цифр та латинських літер
StatusCartОбов'язковий
Тип: Object String
• Опис об'єктів події • Є масивом об'єктів, що містить товари, додані до кошика
productKey430738
Обов'язковий
Тип: String
• Ідентифікатор товару • Має збігатися з productKey на сторінці ProductPage
price201.95
Обов'язковий
Тип: String
Ціна за одиницю товару
discount180
Необов'язковий
Тип: String
Знижкова ціна за одиницю товару
quantity1
Обов'язковий
Тип: Int
Кількість товарів
price_currency_codeUAH
Необов'язковий
Тип: String
Позначення грошової валюти
tag_[something]["abc","bca"]
Необов'язковий
Тип: Array of Strings
• Усі додаткові поля можуть передаватися в цьому параметрі, обов'язковий префікс tag_, після якого можна написати будь-яку назву • Таких параметрів може бути кілька • Значення цього параметра передається у вигляді масиву даних, який можна записувати через кому
TagsНеобов'язковий
Тип: Object
Додаткові поля

Wishlist

Опис

Надсилання події AddToWishlist - у момент додавання товару до списку бажаного (вибране).

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

Приклад

{
  "GeneralInfo": {
    "eventName": "AddToWishlist",
    "siteId": "8A412DC",
    "datetime":1579622183208,
    "externalCustomerId": "1234509876",
    "user_phone": "1-541-754-3010",
    "user_email": "[email protected]",
    "user_name": "Gregori Boczynski",
    "user_es_contact_id": "255830499",
    "cookies": {
      "sc": "CDA68358-94FB-4D83-9655-3FEB3C4114A3"
    }
  },
  "AddToWishlist": {
    "Product": {
      "productKey": "72354",
      "price": "754",
      "isInStock": "1",
      "tag_something": [
        "abc",
        "bca"
      ]
    },
    "Tags": {
      "some_tags": [
        "some_tag1",
        "some_tag2"
      ]
    }
  }
}

Параметри

НазваПрикладОпис
GeneralInfoОбов'язковий
Тип: Object String
Загальна інформація
eventNameAddToWishlist
Обов'язковий
Тип: String
Назва події, що відправляється
siteId8A412DC
Обов'язковий
Тип: String
• Ідентифікатор вашого магазину можна отримати в підтримці eSputnik • Статичний параметр
externalCustomerId1234509876
Необов'язковий
Тип: String
Зовнішній ідентифікатор контакту
user_phone1-541-754-3010
Необов'язковий
Тип: String
Номер телефону в міжнародному форматі
user_email[email protected]
Необов'язковий
Тип: String
Email користувача
user_nameGregori Boczynski
Необов'язковий
Тип: String
Ім'я/Прізвище користувача
user_es_contact_id255830499
Необов'язковий
Тип: String
ID клієнта в базі eSputnik
cookiesC0FB125A-9EC7-E8CB-9B9B-9DF45C165062
Обов'язковий
Тип: Object String
Cookie sc – це cookie, згенерована нашим скриптом, якщо він встановлений на вашому сайті. Кожна cookie має бути унікальною для кожного користувача. Ви можете створювати cookie власноруч. Приклад виклику цієї cookie із javascript document.cookie, потрібна нам cookie має ім'я "sc"
datetime1579622183208Timestamp (millisecond)
AddToWishlistОбов'язковий
Тип: Object String
• Опис об'єктів події • Є масивом об'єктів, що містить товари, додані до обраного
productKey430738
Обов'язковий
Тип: String
• Ідентифікатор товару • Має збігатися з productKey на сторінці ProductPage
price201.95
Обов'язковий
Тип: String
Ціна за одиницю товару
tag_[something]["abc","bca"]
Необов'язковий
Тип: Array of Strings
• Усі додаткові поля можуть передаватися в цьому параметрі, обов'язковий префікс tag_, після якого можна написати будь-яку назву • Таких параметрів може бути кілька • Значення цього параметра передається у вигляді масиву даних, який можна записувати через кому
TagsНеобов'язковий
Тип: Object
Додаткові поля

PurchasedItems

Опис

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

Приклад

{
  "GeneralInfo": {
    "eventName": "PurchasedItems",
    "siteId": "62D2F3D",
    "datetime": 1763468785000,
    "cookies": {
      "sc": "C0FB125A-9EC7-E8CB-9B9B-9DF45C165062"
    },
    "marketId": "Lviv_center_2"
  },
  "TrackedOrderId": "884dc874-938d-4b10-adbd-ced4a512646e",
  "PurchasedItems": {
    "Products": [
      {
        "product_id": "34187",
        "unit_price": "632",
        "quantity": 1
      },
      {
        "product_id": "34194",
        "unit_price": "760",
        "quantity": 1
      },
      {
        "product_id": "2444",
        "unit_price": "464",
        "quantity": 3
      }
    ],
    "OrderNumber": "48929",
    "Tags": {
      "some_tags1": [
        "4",
        "gg"
      ]
    }
  }
}

Параметри

НазваПрикладОпис
GeneralInfoОбов'язковий
Тип: Object String
Загальна інформація
eventNamePurchasedItems
Обов'язковий
Тип: String
Назва події, що відправляється
siteId62D2F3D
Обов'язковий
Тип: String
• Ідентифікатор вашого магазину, можна отримати у підтримці eSputnik • Статичний параметр
externalCustomerId1234509876
Необов'язковий
Тип: String
Зовнішній ідентифікатор контакту
user_phone1-541-754-3010
Необов'язковий
Тип: String
Номер телефону в міжнародному форматі
user_email[email protected]
Необов'язковий
Тип: String
Email користувача
user_es_contact_id255830499
Необов'язковий
Тип: String
ID клієнта в базі eSputnik
user_nameGregori Boczynski
Необов'язковий
Тип: String
Ім'я/Прізвище користувача
datetime1763468785000Timestamp (millisecond)
cookiesC0FB125A-9EC7-E8CB-9B9B-9DF45C165062
Обов'язковий
Тип: Object String
Cookie sc – це cookie, згенерована нашим скриптом, якщо він встановлений на вашому сайті. Кожна cookie має бути унікальною для кожного користувача. Ви можете створювати cookie власноруч. Приклад виклику цієї cookie із javascript document.cookie, потрібна нам cookie має ім'я "sc"
marketIdLviv_center_2
Необов'язковий
Тип: String
Якщо передається, оновлює поле Market ID у картці контакту
TrackedOrderId884dc874-938d-4b10-adbd-ced4a512646e
Обов'язковий
Тип: Object String
Рандомно згенероване число, унікальне для кожної події
OrderNumber48929
Обов'язковий
Тип: String
• Номер замовлення • Є підтвердженням здійснення купівлі
PurchasedItemsТип: Array of StringsПерелік товарів
product_id34187
Обов'язковий
Тип: String
• Ідентифікатор товару • Має збігатися з productKey на сторінці ProductPage
unit_price632
Обов'язковий
Тип: String
Ціна за одиницю товару
quantity1
Обов'язковий
Тип: Integer
Кількість товарів
TagsНеобов'язковий
Тип: Object
Додаткові поля

ProductImpressions

Опис

ProductImpressions — подія, відправлення якої дозволяє відстежувати покази блоків. За замовчуванням відправляється скриптом, по JS API. Додатково передавати не потрібно. Якщо скрипт не встановлено, передавати згідно формату.

Приклад

{
  "GeneralInfo": {
    "eventName": "ProductImpressions",
    "siteId": "8A412DC",
    "datetime":1579622183208,
    "externalCustomerId": "1234509876",
    "user_phone": "1-541-754-3010",
    "user_email": "[email protected]",
    "user_name": "Gregori Boczynski",
    "user_es_contact_id": "255830499",
    "cookies": {
      "sc": "CDA68358-94FB-4D83-9655-3FEB3C4114A3"
    }
  },
  "ProductImpression": {
    "Products": [
      {
        "product_id": "430968",
        "container_type": "1253"
      },
      {
        "product_id": "430738",
        "container_type": "1254"
      },
      {
        "product_id": "429983",
        "container_type": "1255"
      }
    ],
    "Tags": {
      "some_tags": [
        "1",
        "a2"
      ],
      "some_tags1": [
        "4",
        "gg"
      ]
    }
  }
}

Параметри

НазваПрикладОпис
GeneralInfoОбов'язковий
Тип: Array of Objects
Загальна інформація
eventNameProductImpressions
Обов'язковий
Тип: String
Назва події, що відправляється
siteId8A412DC
Обов'язковий
Тип: String
• Ідентифікатор вашого магазину, можна отримати в підтримці eSputnik • Статичний параметр
externalCustomerId1234509876
Необов'язковий
Тип: String
Зовнішній ідентифікатор контакту
user_phone1-541-754-3010
Необов'язковий
Тип: String
Номер телефону в міжнародному форматі
user_email[email protected]
Необов'язковий
Тип: String
Email користувача
user_es_contact_id255830499
Необов'язковий
Тип: String
ID клієнта в базі eSputnik
user_nameGregori Boczynski
Необов'язковий
Тип: String
Імя/Прізвище користувача
datetime1579622183208Timestamp (millisecond)
cookiesCDA68358-94FB-4D83-9655-3FEB3C4114A3
Обов'язковий
Тип: Object String
Cookie sc – це cookie, згенерована нашим скриптом, якщо він встановлений на вашому сайті. Кожна cookie має бути унікальною для кожного користувача. Ви можете створювати cookie власноруч. Приклад виклику цієї cookie із javascript document.cookie, потрібна нам cookie має ім'я "sc"
ProductImpressionОбов'язковий
Тип: Array of Objects
• Опис об'єктів події • Є масивом об'єктів
product_id430968
Обов'язковий
Тип: String
Ідентифікатор товару чи категорії, який є у фіді
container_type1253
Обов'язковий
Тип: String
Номер блоку рекомендацій. Отримати container_type можна у відповідь на запит рекомендацій.
TagsНеобов'язковий
Тип: Object
Додаткові поля

CategoryPage

Опис

Можливе використання:

  • для тригерів,
  • перегляду сайту з відвідуванням категорії, без відвідування картки товарів,
  • перегляду сайту без будь-якого відвідування категорії/товару.

Необхідно надіслати запит, у якому буде вказано, на якій категорії знаходиться користувач.

Приклад

{
  "GeneralInfo": {
    "eventName": "CategoryPage",
    "siteId": "8A412DC",
    "datetime":1579622183208,
    "externalCustomerId": "1234509876",
    "user_phone": "1-541-754-3010",
    "user_email": "[email protected]",
    "user_name": "Gregori Boczynski",
    "user_es_contact_id": "255830499",
    "cookies": {
      "sc": "CDA68358-94FB-4D83-9655-3FEB3C4114A3"
    }
  },
  "CategoryPage": {
    "Category": {
      "categoryKey": "509876"
    },
    "Tags": {
      "some_tags": [
        "1",
        "a2"
      ],
      "some_tags1": [
        "4",
        "gg"
      ]
    }
  }
}

Параметри

НазваПрикладОпис
GeneralInfoОбов'язковий
Тип: Array of Objects
Загальна інформація
eventNameCategoryPage
Обов'язковий
Тип: String
Назва події, що відправляється
siteId8A412DC
Обов'язковий
Тип: String
• Ідентифікатор вашого магазину, можна отримати в підтримці eSputnik • Статичний параметр
externalCustomerId1234509876
Необов'язковий
Тип: String
Зовнішній ідентифікатор контакту
user_phone1-541-754-3010
Необов'язковий
Тип: String
Номер телефону в міжнародному форматі
user_email[email protected]
Необов'язковий
Тип: String
Email користувача
user_es_contact_id255830499
Необов'язковий
Тип: String
ID клієнта в базі eSputnik
user_nameGregori Boczynski
Необов'язковий
Тип: String
Імя/Прізвище користувача
cookiesCDA68358-94FB-4D83-9655-3FEB3C4114A3
Обов'язковий
Тип: Object String
Cookie sc – це cookie, згенерована нашим скриптом, якщо він встановлений на вашому сайті. Кожна cookie має бути унікальною для кожного користувача. Ви можете створювати cookie власноруч. Приклад виклику цієї cookie із javascript document.cookie, потрібна нам cookie має ім'я "sc"
datetime1579622183208Timestamp (millisecond)
CategoryPageОбов'язковий
Тип: Object
Опис події
categoryKey509876
Обов'язковий
Тип: String
Назва або ID категорії згідно фіду товарних даних
TagsНеобов'язковий
Тип: Object
Додаткові поля

CustomerData

Опис

Для відправлення тригерів за покинутими кошиками та покинутими переглядами необхідно надіслати запит, у якому буде вказана інформація про користувача.

Email має відправлятися як мінімум у персональному кабінеті, на сторінці Дякуємо за замовлення та під час реєстрації.

Приклад

{
  "GeneralInfo": {
    "eventName": "CustomerData",
    "siteId": "8D3869C",
    "datetime": 1579622183208,
    "externalCustomerId": "1234509876",
    "user_phone": "3801111111111",
    "user_email": "[email protected]",
    "user_es_contact_id": "255830499",
    "user_name": "Johny",
    "cookies": {
      "sc": "CDA68358-94FB-4D83-9655-3FEB3CGGG1"
    }
  }
}

Параметри

НазваПрикладОпис
GeneralInfoОбов'язковий
Тип: Array of Objects
Загальна інформація
eventNameCustomerData
Обов'язковий
Тип: String
Назва події, що відправляється
siteId8D3869C
Обов'язковий
Тип: String
• Ідентифікатор вашого магазину, можна отримати в підтримці eSputnik • Статичний параметр
externalCustomerId1234509876
Необов'язковий
Тип: String
Зовнішній ідентифікатор контакту
user_phone3801111111111
Необов'язковий
Тип: String
Номер телефону в міжнародному форматі
user_email[email protected]
Необов'язковий
Тип: String
Email користувача
user_es_contact_id255830499
Необов'язковий
Тип: String
ID клієнта в базі eSputnik
user_nameJohny
Необов'язковий
Тип: String
Імя/Прізвище користувача
cookiesCDA68358-94FB-4D83-9655-3FEB3CGGG1
Обов'язковий
Тип: Object String
Cookie sc – це cookie, згенерована нашим скриптом, якщо він встановлений на вашому сайті. Кожна cookie має бути унікальною для кожного користувача. Ви можете створювати cookie власноруч. Приклад виклику цієї cookie із javascript document.cookie, потрібна нам cookie має ім'я "sc"
datetime1579622183208Timestamp (millisecond)

SearchRequest

Опис

Для збору статистики за пошуковими запитами необхідно надіслати значення зі строки пошуку.

Ця подія використовується для тригерів. Її потрібно надсилати лише у випадку, коли пошук не дав результатів. У тригері такі контакти отримуватимуть персональні рекомендації (на даний момент, видача рекомендацій не залежить від значення, введеного в пошуку, підтримка цієї функції передбачається в майбутньому).

Приклад

{
  "GeneralInfo": {
    "eventName": "SearchRequest",
    "siteId": "CE460EC",
    "datetime": 1668792552000,
    "externalCustomerId": "1234509876",
    "user_phone": "1-541-754-3010",
    "user_email": "[email protected]",
    "user_name": "Gregori Boczynski",
    "user_es_contact_id": "",
    "cookies": {
      "sc": "CDA68358-94FB-4D83-9655-3FEB3C4114A3"
    }
  },
  "SearchRequest": {
    "search": "input_value",
    "isFound": 1
  }
}

Параметри

НазваПрикладОпис
searchCoffe
Обов'язковий
Тип: String
Значення зі строки пошуку. Те, що шукаємо на сайті.
isFound1/0
Необовʼязковий
Тип: Int
Якщо список пустий, повертається 0, якщо є дані - 1.

ProductUpdate

Опис

ProductUpdate — опціональна подія, яка в режимі реального часу актуалізує дані про товари в eSputnik незалежно від планового оновлення фіду. Передавайте в події ті властивості товарів, які потребують постійного оновлення, — ціна, знижка, наявність тощо.

Приклад

{
  "GeneralInfo": {
    "eventName": "ProductUpdate",
    "siteId": "site_id"
  },
  "ProductUpdate": [
    {
      "brand": "Apple",
      "name": "iPhone 7",
      "description": "Some description",
      "product_id": "430738",
      "imgurl": "https://domain.com/apple/product_large.png",
      "url": "https://domain.com/apple/product_page_example.html",
      "unit_price": "201.95",
      "isInStock": "1",
      "tag_discount": ["10"],
      "tag_oldprice": ["224.38"],
      "price_currency_code": "UAH",
      "category_id": ["3"],
      "tag_something": [
        "aaa",
        "bbb"
      ]
    },
    {
      "brand": "Apple",
      "name": "iPhone 7",
      "description": "Some description",
      "product_id": "430738",
      "imgurl": "https://domain.com/apple/product_large.png",
      "unit_price": "201.95",
      "isInStock": "1",
      "tag_discount": ["10"],
      "tag_oldprice": ["224.38"],
      "price_currency_code": "UAH",
      "category": "level1 > level2 > level3",
      "category_id": ["1", "2", "3"],
      "tag_something": [
        "aaa",
        "bbb"
      ]
    }
  ]
}

Параметри

НазваПрикладОпис
ProductUpdateТип: Object
Обов'язковий
Масив оновлених товарів та їх параметрів
siteIdsite_id
Обов'язковий
Тип: String
Ідентифікатор товару
isInStock1
Обов'язковий
Тип: Int
• Відповідає за наявність товару • Параметр може набувати двох значень: 0 - товару немає в наявності, 1 - товар є в наявності • Якщо наявність товару на сайті змінилася, а у фіді ще ні, то до бази запишеться значення з сайту
unit_price201.95
Необовʼязковий
Тип: Int
Ціна за одиницю
descriptionSome description
Необовʼязковий
Тип: String
Опис товару
nameiPhone 7
Необовʼязковий
Тип: String
Назва товару
imgurlhttps://domain.com/apple/product_large.png
Необовʼязковий
Тип: String
URL зображення товару
urlhttps://domain.com/apple/product_page_example.html
Необовʼязковий
Тип: String
URL сторінки товару
brandApple
Необовʼязковий
Тип: String
Назва бренду
tag_discount10
Необовʼязковий, має бути відносною цифрою (%)
Відсоток знижки
price_currency_codeUAH
Необовʼязковий
Тип: String
Код валюти ціни
tag_oldprice224.38
Необовʼязковий
Тип: Int
Стара ціна

Якщо на товар діє знижка, інформація про нього може передаватися в такий спосіб:

{
  "product_id": "1111",
  "unit_price": "270",
  "isInStock": 1,
  "price_currency_code": "UAH",
  "tag_oldprice": [
    "300"
  ],
  "tag_discount": [
    "10"
  ]
}

А якщо на товар немає знижки, то:

{
  "product_id": "1111",
  "unit_price": "270",
  "isInStock": 1,
  "price_currency_code": "UAH"
}