Appearance
Заказы с маркетплейсов
Покупатель часто изучает товар на сайте или в мобильном приложении магазина, а покупает его у этого же продавца на маркетплейсе: там удобнее рассрочка, доставка или привычная корзина. Такие продажи не видны в онлайн-статистике, хотя их подготовил ваш сайт.
Если маркетплейс передает продавцу контакты покупателя (например, Kaspi.kz передает телефон), загрузите эти заказы в CDP. Тогда отчет «Инсайты → Заказы → ROPO по маркетплейсам» покажет, какие покупки на маркетплейсах были сделаны после просмотра этого же товара на сайте или в приложении за 30 дней до покупки, и какую долю выручки маркетплейсов они составляют.
Как загружать
Заказы с маркетплейсов загружаются тем же методом, что и остальные заказы, — синхронизацией заказов. Отличия:
- Укажите в заказе поле
marketplace— код маркетплейса. - Передайте идентификатор покупателя:
phone,emailили другой из списка. Без него заказ нельзя связать с просмотрами на сайте, такие заказы не загружаются. - Не указывайте
offline: true. Если в заказе есть иmarketplace, иoffline, флагofflineне учитывается: заказ попадает только в отчет по маркетплейсам, а не в ROPO по рознице.
Заказы с маркетплейсов не считаются онлайн-заказами. В отчетах «Заказы по каналам» и «Продажи товаров» они выводятся отдельно, в отчет «Эффективность платформы» не попадают, а в сегментах условие «Купил товар онлайн» их не учитывает. В остальном это обычные заказы: они попадают в профиль клиента и запускают триггеры по заказам.
Как и для оффлайн-заказов, отправляйте заказы партиями до 5000 штук, а не по одному.
Как снять маркетплейс с заказа
Если заказ ошибочно загружен с marketplace, отправьте его повторно с "marketplace": null (или пустой строкой). Если поле marketplace не передать совсем, сохраненное значение не изменится.
Код маркетплейса
Поле marketplace — строка из латинских букв, цифр, _ и -, до 64 символов. Регистр не важен: Kaspi будет сохранен как kaspi. Используйте один и тот же код для всех заказов маркетплейса: по нему строятся фильтр и разбивка в отчете.
Рекомендуемые коды:
| Маркетплейс | Код |
|---|---|
| Kaspi.kz | kaspi |
| Halyk Market | halyk_market |
| Wildberries | wildberries |
| Ozon | ozon |
| Яндекс Маркет | yandex_market |
| Мегамаркет | megamarket |
| Lamoda | lamoda |
| Uzum Market | uzum |
| Flip.kz | flip |
Для маркетплейса, которого нет в таблице, придумайте код по тем же правилам.
Товары в заказе
Отчет сопоставляет товар заказа с товаром, который клиент смотрел на сайте, по артикулу из товарного фида. Поэтому в 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