Skip to content

Заказы с маркетплейсов ​

Покупатель часто изучает товар на сайте или в мобильном приложении магазина, а покупает его у этого же продавца на маркетплейсе: там удобнее рассрочка, доставка или привычная корзина. Такие продажи не видны в онлайн-статистике, хотя их подготовил ваш сайт.

Если маркетплейс передает продавцу контакты покупателя (например, Kaspi.kz передает телефон), загрузите эти заказы в CDP. Тогда отчет «Инсайты → Заказы → ROPO по маркетплейсам» покажет, какие покупки на маркетплейсах были сделаны после просмотра этого же товара на сайте или в приложении за 30 дней до покупки, и какую долю выручки маркетплейсов они составляют.

Как загружать ​

Заказы с маркетплейсов загружаются тем же методом, что и остальные заказы, — синхронизацией заказов. Отличия:

  1. Укажите в заказе поле marketplace — код маркетплейса.
  2. Передайте идентификатор покупателя: phone, email или другой из списка. Без него заказ нельзя связать с просмотрами на сайте, такие заказы не загружаются.
  3. Не указывайте offline: true. Если в заказе есть и marketplace, и offline, флаг offline не учитывается: заказ попадает только в отчет по маркетплейсам, а не в ROPO по рознице.

Заказы с маркетплейсов не считаются онлайн-заказами. В отчетах «Заказы по каналам» и «Продажи товаров» они выводятся отдельно, в отчет «Эффективность платформы» не попадают, а в сегментах условие «Купил товар онлайн» их не учитывает. В остальном это обычные заказы: они попадают в профиль клиента и запускают триггеры по заказам.

Как и для оффлайн-заказов, отправляйте заказы партиями до 5000 штук, а не по одному.

Как снять маркетплейс с заказа ​

Если заказ ошибочно загружен с marketplace, отправьте его повторно с "marketplace": null (или пустой строкой). Если поле marketplace не передать совсем, сохраненное значение не изменится.

Код маркетплейса ​

Поле marketplace — строка из латинских букв, цифр, _ и -, до 64 символов. Регистр не важен: Kaspi будет сохранен как kaspi. Используйте один и тот же код для всех заказов маркетплейса: по нему строятся фильтр и разбивка в отчете.

Рекомендуемые коды:

МаркетплейсКод
Kaspi.kzkaspi
Halyk Markethalyk_market
Wildberrieswildberries
Ozonozon
Яндекс Маркетyandex_market
Мегамаркетmegamarket
Lamodalamoda
Uzum Marketuzum
Flip.kzflip

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

Товары в заказе ​

Отчет сопоставляет товар заказа с товаром, который клиент смотрел на сайте, по артикулу из товарного фида. Поэтому в items[].id передавайте артикул из вашего товарного фида, а не SKU маркетплейса.

Если артикула из фида у вас нет, передайте штрих-код товара в items[].barcode. Для заказов с marketplace CDP найдет товар фида с этим штрих-кодом и подставит его артикул. В этом случае items[].id можно не указывать или передать SKU маркетплейса.

Что будет, если товар не найден:

  • если передан SKU маркетплейса, а товар с таким штрих-кодом в фиде не найден, заказ загрузится с SKU маркетплейса, но эта позиция не попадет в отчет ROPO: она не совпадет с просмотрами на сайте. Когда штрих-код появится в фиде, следующие заказы с этим SKU сопоставятся автоматически;
  • если items[].id не передан и товар по штрих-коду не найден, заказ не загрузится целиком, ошибка придет в уведомлении об импорте;
  • если несколько позиций заказа сопоставились с одним товаром фида или один артикул повторяется в заказе (в том числе с разными line_id), заказ не загрузится: объедините такие позиции в одну.

Штрих-код

По штрих-коду товар ищется среди первых штрих-кодов товаров фида. Если у товара в фиде несколько штрих-кодов, а в заказе передан не первый, товар не найдется. Надежнее передавать артикул из фида.

Пример ​

json
{
  "shop_id": "DvLWN2ZTMZ",
  "shop_secret": "EIxTuot8sj",
  "orders": [
    {
      "id": "KASPI-512345678",
      "status": "Delivered",
      "channel": "marketplace",
      "marketplace": "kaspi",
      "date": 1793884800,
      "phone": "+77011234567",
      "value": {
        "total": 164980
      },
      "items": [
        {
          "id": "ITEM-ID-1",
          "price": 159990,
          "quantity": 1
        },
        {
          "barcode": "4600000000017",
          "price": 4990,
          "quantity": 1
        }
      ]
    }
  ]
}
shell
curl -i -X POST -H "Content-Type: application/json" --data-binary "@data.json" https://api.rees46.ru/sync/orders