Как настроить ссылку на форму отзыва для своего рассыльщика
Как составить ссылку для письма, которая открывает форму отзыва на странице товара или мультиформу Aplaut
Соберите ссылку на форму отзыва, если письма покупателям отправляет ваш рассыльщик (Mindbox, Unisender и другие), а не кампании Aplaut. Ссылка ведёт покупателя в одно из двух мест:
| Куда ведёт ссылка | Когда подходит |
|---|---|
| Страница товара на вашем сайте, форма отзыва открывается сама | Один товар в письме, на сайте установлены виджеты 2.0 |
| Мультиформа Aplaut | Несколько товаров из заказа, отзыв нужно привязать к заказу, сайт менять нельзя |
Что понадобится
- Товары есть в каталоге Aplaut, и в рассыльщике у них те же ID, что в каталоге.
- Для мультиформы — Company ID. Он указан в разделе Админ → API и доступы → Токены аутентификации (роль Администратор). Любой пользователь может скопировать его быстрой командой Скопировать ID компании: нажмите Ctrl+K (Cmd+K на macOS) и начните вводить название команды.
- Чтобы отзыв из мультиформы привязался к заказу, заказы загружены в Aplaut: через Platform API или в личном кабинете.
Ссылка на форму в карточке товара
Форма отзыва внутри виджета <ap-reviews> открывается, когда адрес страницы заканчивается на #/mps/reviews/new. Товар в ссылке не передаётся: форма берёт его из виджета отзывов на странице. Поэтому ссылка должна вести на страницу того товара, о котором вы просите отзыв.
Форма откроется, если на странице товара:
- стоит виджет отзывов
<ap-reviews>; - не включена аутентификация покупателя по JWT;
- не включена проверка покупки (
verifyPurchaseState): номер заказа в такой ссылке передать нельзя; - не отключён hash-роутинг (
isHashRoutingDisabled).
Шаг 1. Соберите ссылку
Добавьте #/mps/reviews/new в конец адреса страницы товара:
https://shop.example.com/product/123#/mps/reviews/new
Если в адресе страницы уже есть часть после #, замените её.
Шаг 2. Вставьте ссылку в шаблон письма
В шаблоне рассыльщика подставьте адрес страницы товара переменной и допишите к ней #/mps/reviews/new:
<переменная с URL товара>#/mps/reviews/new
Синтаксис переменной зависит от рассыльщика: возьмите поле с URL товара из его каталога или фида.
Отзыв по такой ссылке не привязывается к заказу: если это нужно, ведите покупателя на мультиформу.
Ссылка на мультиформу
Мультиформа — страница Aplaut, на которой покупатель оценивает сразу несколько товаров. Отдельно включать её не нужно.
Шаг 1. Настройте мультиформу
Откройте Админ → Виджеты и формы → Мультиформа (роль Менеджер или Администратор):
- В блоке Цвета выберите Основной цвет, Акценты и Предупреждения под стиль вашего сайта.
- Если вместе с отзывами о товарах нужна оценка магазина, в блоке Отзывы о компании включите Собирать отзывы о компании. Форма попросит оценить качество продукции, обслуживания и удобство доставки.
- Нажмите Сохранить.
Шаг 2. Соберите ссылку
https://forms.aplaut.io/multi_reviews/<COMPANY_ID>/new?product_ids=SKU-1,SKU-2&order_number=12345&author_name=Анна
| Параметр | Обязательный | Что передаёт |
|---|---|---|
product_ids | да | ID товаров из каталога через запятую. Товары, которых нет в каталоге, форма пропускает без ошибки |
order_number | нет | Номер заказа. Если заказ загружен в Aplaut, отзывы привязываются к нему и к покупателю из заказа |
author_name | нет | Имя покупателя, которое подставится в форму |
author_id | нет | ID покупателя в вашей системе |
location_name | нет | Город покупателя для поля Откуда вы?. Без параметра форма подставляет город, определённый по IP |
custom_attributes | нет | Дополнительные поля отзыва в формате ключ:значение через запятую, например segment:vip,store:msk. Двоеточие и запятая внутри значений не допускаются |
custom_source, custom_medium, custom_campaign | нет | Метки рассылки, сохраняются в отзыве |
Значения с пробелами и кириллицей кодируйте функцией URL-кодирования рассыльщика. Если в разделе Админ → Виджеты и формы → Настройки виджетов в блоке Эндпоинты API заполнено поле Базовый URL Forms API, замените https://forms.aplaut.io на этот адрес — по нему же строят ссылки на мультиформу кампании Aplaut.
Ссылка не подписывается и не истекает. Получить её через API нельзя: собирайте её в шаблоне письма из данных заказа.
Пример мультиформы:
https://forms.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
Проверка результата
- Отправьте тестовое письмо себе и перейдите по ссылке.
- Оставьте отзыв.
- В разделе Модерация → Отзывы найдите его быстрым фильтром Источник: для мультиформы это Композитная форма, для формы на сайте — Widgets 2.0.
| Признак | Причина | Что сделать |
|---|---|---|
| Страница товара открылась, формы нет | Не выполнено одно из условий раздела «Ссылка на форму в карточке товара» или после new стоит ID товара | Проверьте условия и адрес ссылки |
| В форме на сайте не тот товар | Ссылка ведёт на страницу другого товара | Проверьте переменную с URL товара в шаблоне |
| В мультиформе нет части товаров | ID в product_ids не совпадают с ID в каталоге | Сверьте ID в рассыльщике и в каталоге Aplaut |
| Отзыв из мультиформы не привязан к заказу | Заказ не загружен в Aplaut или order_number отличается от номера в Aplaut | Загрузите заказы и сверьте номер |
Смотрите также: настройки формы отзыва, фильтр «Источник».