Перейти к содержанию

Активация веб-форм

Активировать веб-форму на сайте можно разными способами:

  1. Через JS API
  2. Добавить параметры в URL страницы

Через JS API

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

1
2
var omnibox = Shoppilot.require('omnibox');
omnibox.send('showReviewForm'); // для вопроса — showQuestionForm

Через URL параметры

Чтобы активировать форму сразу после открытия целевой страницы (например, карточки товара), необходимо в URL добавить query параметр show_omnibox=reviews.form

Пример ссылки: https://www.sportmaster.ru/product/1716553?show_omnibox=reviews.form

Композитная форма

Композитная форма позволяет отправить несколько отзывов за один запрос. URL параметры:

Название Комментарий
store_id Идентификатор сайта компании
product_ids Идентификаторы товаров, на которые пишутся отзывы
order_number Номер заказа
author_name Имя автора отзыва
location_name Название локации автора
custom_attributes Произвольные атрибуты отзыва

custom_attributes - это ключ значение, разделенные знаком двоеточия(:), перечисленные через запятую(,)

Пример:

https://app.shoppilot.ru/multi_reviews/52b5aff5f92ea190a100003f/new?author_name=Мария&order_number=RAND-559672863610&product_ids=115732,115731&location_name=Москва&custom_attributes=user_area:lk,pro:true

где 52b5aff5f92ea190a100003f – параметр store_id

Отслеживание источников

Для отслеживания источников отзывов в ЛК доступны следующие параметры:

Название Комментарий Пример
custom_source Название источника отзыва client-cabinet
custom_medium Тип источника отзыва desktop
custom_campaign Название кампании incentivized

В зависимости от способа активации формы отзыва, есть разные способы передавать эти параметры.

Форма отзыва на вашем сайте (омнибокс)

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

1
2
3
4
5
// …
_shoppilot.push(['_setReviewCustomSource', 'client-cabinet');
_shoppilot.push(['_setReviewCustomMedium', 'desktop');
_shoppilot.push(['_setReviewCustomCampaign', 'incentivized');
// …

Композитная форма

В URL страницы с композитной формой необходимо добавить параметры указанные выше. Пример:

https://app.shoppilot.ru/multi_reviews/52b5aff5f92ea190a100003f/new?author_name=Мария&order_number=RAND-559672863610&product_ids=115732,115731&location_name=Москва&custom_source=client-cabinet&custom_medium=desktop&custom_campaign=incentivized

API

Если отзывы создаются с помощью Submissions API или Platform API, то указанные параметры передаются в теле запроса, как показано в документации к соответсвующим методам API.

Используйте этот способ, если отзывы создаются через мобильное приложение.