Активация веб-форм
Активировать веб-форму на сайте можно разными способами:
- Через JS API
- Добавить параметры в URL страницы
Через JS API
Чтобы активировать форму отзыва, достаточно в обработчик клика по кнопке или ссылке добавить следующий код:
var omnibox = Shoppilot.require('omnibox');
omnibox.send('showReviewForm'); // для вопроса — showQuestionForm
Через URL параметры
Чтобы активировать форму сразу после открытия целевой страницы (например,
карточки товара), необходимо в URL добавить query параметр
show_omnibox=reviews.form
У команды reviews.form есть опциональные аргументы:
| Название | Комментарий |
|---|---|
product_id | Идентификатор товара. Если нет, будет использоваться товар со страницы. |
order_number | Номер заказа. Для привязки отзыва к заказу. |
Примеры использования:
- https://sportmaster.ru/product/1716553?show_omnibox=reviews.form
- https://sportmaster.ru/product/1716553?show_omnibox=reviews.form(product_id:10473060,order_number:123123)
Композитная форма
Композитная форма позволяет отправить несколько отзывов за один запрос. URL параметры:
| Название | Комментарий |
|---|---|
store_id | Идентификатор сайта компании |
product_ids | Идентификаторы товаров, на которые пишутся отзывы |
order_number | Номер заказа |
author_name | Имя автора отзыва |
location_name | Название локации автора |
custom_attributes | Произвольные атрибуты отзыва |
custom_attributes - это ключ значение, разделенные знаком двоеточия ":",
перечисленные через запятую ","
Пример:
https://app.aplaut.io/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 |
В зависимости от способа активации формы отзыва, есть разные способы передавать эти параметры.
Форма отзыва на вашем сайте (омнибокс)
В настройки загрузчика скрипта необходимо добавить команды:
// …
_shoppilot.push(['_setReviewCustomSource', 'client-cabinet');
_shoppilot.push(['_setReviewCustomMedium', 'desktop');
_shoppilot.push(['_setReviewCustomCampaign', 'incentivized');
// …
Композитная форма
В URL страницы с композитной формой необходимо добавить параметры указанные выше. Пример:
https://app.aplaut.io/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
Если отзывы создаются с помощью
или
то указанные параметры передаются в теле запроса, как показано в документации к соответствующим методам API.
Используйте этот способ, если отзывы создаются через мобильное приложение.