Активировать веб-форму на сайте можно разными способами:
Через JS API
Добавить параметры в URL страницы
Чтобы активировать форму отзыва, достаточно в обработчик клика по кнопке или ссылке добавить следующий код:
var omnibox = Shoppilot.require('omnibox'); omnibox.send('showReviewForm'); // для вопроса — showQuestionForm
Чтобы активировать форму сразу после открытия целевой страницы (например, карточки товара), необходимо в URL добавить query параметр show_omnibox=reviews.form
. У команды reviews.form
есть опциональные аргументы:
Название | Комментарий |
| Идентификатор товара. Если нет, будет использоваться товар со страницы. |
| Номер заказа. Для привязки отзыва к заказу. |
| Имя автора отзыва для предзаполнения формы. Если передаётся номер заказа, то имя будет взято из него*. |
*работает только в случае, если в Aplaut передаются заказы
Примеры использования:
Чтобы активировать форму сразу после открытия целевой страницы (например, карточки товара), необходимо в URL добавить хэш #/mps/reviews/new/{product_id}
, где {product_id}
это offer.id
товара из каталога, импортируемого в Aplaut.
Пример использования:
1. https://sportmaster.ru/product/1716553/#/mps/reviews/new/1716553
Мультиформа позволяет отправить несколько отзывов за один запрос. Поддерживаемые URL параметры:
Название | Комментарий |
| Идентификатор компании в Aplaut. Найти можно в ЛК, в разделе Настройки —> Разработчикам |
| Идентификаторы товаров ( |
| Номер заказа |
| Имя автора отзыва (будет предзаполнено в форме) |
| Название локации автора (будет предзаполнено в форме) |
| Пользовательские атрибуты отзыва, если есть необходимость передавать доп. данные вместе с отзывом, которые хотите видеть в ЛК Aplaut |
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
Для отслеживания источников отзывов в ЛК доступны следующие параметры:
Название | Комментарий | Пример |
| Название источника отзыва |
|
| Тип источника отзыва |
|
| Название кампании |
|
В зависимости от способа активации формы отзыва, есть разные способы передавать эти параметры.
В настройки загрузчика скрипта необходимо добавить команды:
// …
_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
Если отзывы создаются с помощью Submissions API или Platform API, то указанные параметры передаются в теле запроса, как показано в документации к соответствующим методам API.
Используйте этот способ, если отзывы создаются через мобильное приложение.