Перейти к основному содержимому

Установка на веб-сайте

Как установить виджеты 2.0 через скрипт провайдера: добавить загрузчик на страницы сайта, разместить теги виджетов и проверить установку

Добавьте загрузчик виджетов на все страницы, где будут виджеты, и поставьте теги виджетов туда, где они должны появиться. Настройки виджетов приходят на сайт из скрипта провайдера: они хранятся в Aplaut и меняются в личном кабинете, а код сайта при этом не правится. Установка занимает 5–15 минут.

Что понадобится​

  • Доступ к HTML-шаблонам сайта.
  • Код загрузчика. Готовый код с вашими настройками показывает раздел Инструменты → Виджеты по значку Показать инструкции по установке, раздел открыт ролям Менеджер и Администратор. Без него понадобится Company ID из раздела Админ → API и доступы → Токены аутентификации (роль Администратор).
  • Сохранённый скрипт провайдера с токеном и включённый переключатель Отдавать скрипт провайдера вместо бандла: см. как настроить виджеты в личном кабинете. Пока переключатель выключен, по адресу загрузчика приходят виджеты без настроек, и на сайте они не появляются.

Шаг 1. Добавьте загрузчик в <head>​

Вставьте код в <head> на всех страницах с виджетами, до любых вызовов aplaut.* в коде страницы. Замените <COMPANY_ID> в адресе в конце загрузчика на Company ID вашей компании: загрузчик берёт по адресу https://get.aplaut.io/f/v2/<COMPANY_ID>/app.js код виджетов вместе со скриптом провайдера.

<link rel="preconnect" href="https://get.aplaut.io" />
<link rel="preconnect" href="https://get.apltcdn.com" />
<script>!function(t, e, n, c){if(!t[n]){var r, o, c;function s(t){r[t]=function(){o.push([t].concat(Array.prototype.slice.call(arguments, 0)))}}t[n]={}, (r=t[n]).v="1.0", r.q=[], o=r.q, r.init=function(t, e){r.initArgs=arguments}, r.start=function(){for(i=0;i<c.length;i++)s(c[i])}, r.start(), a=document.createElement("script"), m=document.getElementsByTagName("script")[0], a.async=1, a.src=e, a.type="module", m.parentNode.insertBefore(a, m)}}(window, "https://get.aplaut.io/f/v2/<COMPANY_ID>/app.js", "aplaut", ["createWidget", "setUser", "on", "off", "emit", "setParams", "setConsumer", "setAuthParams", "manageOrder", "clearFormData", "setAuthStrategy"]);</script>

Шаг 2. Разместите теги виджетов​

Поставьте тег виджета в то место страницы, где он должен появиться, и укажите в data-context-id ID товара, под которым товар загружен в Aplaut (offer.id из YML-каталога).

<ap-informer data-context-id="12345"></ap-informer>
<ap-reviews data-context-id="12345"></ap-reviews>
ВиджетТег
Отзывы<ap-reviews>
Информер с рейтингом<ap-informer>
Вопросы и ответы<ap-questions-answers>
Галерея фото и видео<ap-reviews-gallery>
AI-сводка отзывов<ap-reviews-summary>
Форма отзыва без списка<ap-reviews-form>
Сторис<ap-stories>
Форма сторис<ap-stories-form>
Приглашение оставить отзыв<ap-product-review-invite>

До загрузки тег — пустой блок. Виджет использует container queries, поэтому задайте тегу ширину родительского блока стилями, а информеру и отзывам — минимальную высоту min-height, чтобы страница не прыгала при загрузке.

Прокрутка к отзывам

Если информер или AI-сводка стоят на одной странице с виджетом отзывов, обязательно настройте прокрутку к отзывам по клику: сами по себе они к отзывам не ведут. Дайте контейнеру виджета отзывов id, у информера укажите этот id в data-scroll-target-id, а на AI-сводку повесьте обработчик клика:

<ap-informer data-context-id="12345" data-scroll-target-id="reviews"></ap-informer>
<ap-reviews-summary data-context-id="12345"></ap-reviews-summary>

<div id="reviews">
<ap-reviews data-context-id="12345"></ap-reviews>
</div>

<script>
document.querySelector('ap-reviews-summary').addEventListener('click', () => {
document.getElementById('reviews').scrollIntoView({ behavior: 'smooth' });
});
</script>
Ширина виджетов

Виджеты по умолчанию занимают всю ширину контейнера. Если нужны отступы по краям, задайте их контейнеру, в который ставите тег виджета, например через padding.

Проверка результата​

Откройте страницу с виджетом. Виджет появился там, где стоит тег, в консоли браузера нет ошибок, а на вкладке «Сеть» запросы к API Aplaut отвечают 200.

ПризнакПричинаЧто сделать
Ответ 401Токен в скрипте провайдера не подходит или истёк: по умолчанию токен действует два годаВыдайте новый токен приложения со скоупами content_api и submissions_api, выберите его в разделе Виджеты → Аутентификация и перенесите настройки в скрипт провайдера
Ответ 403 при отправке отзываУ токена в скрипте провайдера нет скоупа submissions_apiВыберите токен приложения с этим скоупом и перенесите настройки в скрипт провайдера
Ответ 404Товара нет в AplautПроверьте, что товар загружен и data-context-id совпадает с offer.id из фида
Тег пустой, запросов нетВыключен переключатель Отдавать скрипт провайдера вместо бандла, в скрипте провайдера нет токена или в адресе загрузчика чужой Company IDВключите переключатель в окне скрипта провайдера раздела Виджеты, проверьте токен и Company ID
Изменения из личного кабинета не видны на сайтеСкрипт провайдера кешируется до трёх часовПодождите и проверьте страницу в режиме инкогнито

Смотрите также: как настроить виджеты в личном кабинете, что делать, если опубликованный отзыв не виден на сайте.