Рекомендации товаров

IMSHOP Retail Protocol (IRP) является объектом интеллектуальной собственности ООО «АЙ ЭМ СОЛЮШНЗ» (IMSHOP) и защищён как объект авторского права. Свидетельство о депонировании произведения № 023-014461 от 16 января 2023 г. подтверждает исключительные права ООО «АЙ ЭМ СОЛЮШНЗ» на данные технологии.

IMSHOP Retail Protocol создан по заказу ООО «АЙ ЭМ СОЛЮШНЗ». Использование IMSHOP Retail Protocol допустимо только при взаимодействии с ООО "АЙ ЭМ СОЛЮШНЗ" и наличии действующего лицензионного договора. Более подробно можно ознакомиться здесь.

Дополнительные интеграции вводятся в эксплуатацию после завершения основных интеграций:

Для подключения дополнительных интеграций обратитесь к вашему менеджеру в IMSHOP.IO

Запрос

APP SERVER → INFRASTRUCTURE

От вас потребуется URL, на который наш сервер будет слать POST-запрос. Да, мы запрашиваем данные через POST, а не через GET.

В вашу систему будут приходить вот такие данные:

{
    "privateId": "12345",
    "userIdentifier": "qwerty12345",
    "installId": "6c22184c-ef45-43c5-b5e8-98cd64f1bd58",
    "location": {
      "city": "Москва",
      "cityFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
      "region": "Москва",
      "regionFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5"
    }
}

  • privateId — id модели товара (group_id из фида. идентификатор модели карточки товара, а не конкретного варианта цвета / размера)

  • userIdentifier — external id (идентификатор пользователя в сайте из ответа запроса профиля пользователя после авторизации)

  • installId - идентификатор установки / устройства

  • location (в разработке) — локация пользователя, объект «Местоположение»

Ответ

Массив с объектами

ids - Массив идентификаторов товаров из фида. В блоке рекомендаций выводятся модели, поэтому рекомендуем передавать group_id; если по какой-то причине в фиде этот атрибут отсутствует - передаётся id оффера, например:

  1. модель карточки товара. Пример из фида: <offer id="12345" group_id="67890"... - в качестве идентификатора указывается "67890"

  2. цветоразмер. Пример из фида <offer id="12345"... - в качестве идентификатора указывается "12345"

title - Название блока с товарами

type (опционально) - Тип блока рекомендаций; см. раздел Upsell.

Пример ответа

[{ ids: ["12345"], title: "Покупают вместе с этим" }]

Upsell (в разработке)

При добавлении товара в корзину через карточку товара, пользователю можно показать несколько релевантных предложений (аксессуаров). Для этого в массив рекомендаций нужно добавить объект с type "upsell" (title в нём задавать не требуется).

Пример ответа

[
    { ids: ["01234", "54321"], type: "upsell" },
    { ids: ["12345", "98765"], title: "Покупают вместе с этим" }
]
PreviousДополнительные товарыNextВиджет описания рассрочки

Last updated