Перейти на сайт

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

Активируйте форму отзыва на сайте для реализации рассылок приглашений оставить отзыв на своей стороне, или других задач

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

  1. Через JS API

  2. Добавить параметры в URL страницы

Через JS API

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

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


Через URL параметры (для Widgets 1.0)

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

Название

Комментарий

product_id

Идентификатор товара. Если нет, будет использоваться товар со страницы.

order_number

Номер заказа. Для привязки отзыва к заказу.

author_name

Имя автора отзыва для предзаполнения формы. Если передаётся номер заказа, то имя будет взято из него*.

*работает только в случае, если в Aplaut передаются заказы


Примеры использования:

  1. https://sportmaster.ru/product/1716553?show_omnibox=reviews.form

  2. https://www.sportmaster.ru/product/1716553/?show_omnibox=reviews.form(product_id:10473060,order_number:123123,author_name:Leonard)

С помощью хэша, добавленного к url (для Widgets 2.0)

Чтобы активировать форму сразу после открытия целевой страницы (например, карточки товара), необходимо в URL добавить хэш  #/mps/reviews/new/{product_id}, где {product_id}  это offer.id  товара из каталога, импортируемого в Aplaut.


Пример использования:

1. https://sportmaster.ru/product/1716553/#/mps/reviews/new/1716553

Мультиформа

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

Название

Комментарий

store_id*

Идентификатор компании в Aplaut. Найти можно в ЛК, в разделе Настройки —> Разработчикам

product_ids *

Идентификаторы товаров (offer.id  из каталога, импортируемого в Aplaut), на которые пишутся отзывы, разделенные запятой

order_number

Номер заказа

author_name

Имя автора отзыва (будет предзаполнено в форме)

location_name

Название локации автора (будет предзаполнено в форме)

custom_attributes

Пользовательские атрибуты отзыва, если есть необходимость передавать доп. данные вместе с отзывом, которые хотите видеть в ЛК 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


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

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

Название

Комментарий

Пример

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

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

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

👆 На этом пока всё