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

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

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

Через 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`	Номер заказа. Для привязки отзыва к заказу.
`author_name`	Имя автора отзыва для предзаполнения формы. Если передаётся номер заказа, то имя будет взято из него*.

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

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

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

Композитная форма позволяет отправить несколько отзывов за один запрос. 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

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

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

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