Установка виджета
Добавьте сниппет с публичным ключом и укажите свои домены.
1. Добавьте сниппет
Вставьте его в <head> каждой страницы или перед </body>. В личном кабинете сниппет показан уже с вашим ключом и адресом нашего CDN.
<script>window.lockstock=window.lockstock||function(){(lockstock.q=lockstock.q||[]).push(arguments)}</script>
<script src="https://cdn.lockstock.example/w/v1/loader.js" data-key="pk_live_…" async></script>- Первая строка заранее создаёт
window.lockstock, поэтому вызовы JavaScript API до загрузки виджета ставятся в очередь и не теряются. Не меняйте её: строгая Content Security Policy разрешает её по хешу. - Загрузчик весит меньше 5 КБ. Остальной виджет загружается, только когда покупатель ставит курсор в строку поиска или открывает чат, — а если на странице есть
<lockstock-search>, то когда браузер освободится. - Если виджет по какой-то причине не может запуститься, он остаётся выключенным, а страница не меняется.
2. Ключи и домены
data-key — ваш публичный ключ. Его безопасно размещать на странице: он только указывает на ваш магазин и работает только на ваших доменах.
| Ключ | Начинается с | Куда ставить |
|---|---|---|
| Публичный, боевой | pk_live_ | Сниппет на рабочем сайте |
| Публичный, тестовый | pk_test_ | Сниппет на тестовом сайте |
| Секретный | sk_ | Только ваш сервер, для push API. Никогда не размещайте на странице |
Виджет работает только на зарегистрированных доменах. Запрос с другого адреса отклоняется, и виджет там не включается. Добавьте в личном кабинете в разделе Домены все домены, которыми пользуются покупатели, включая www. и региональные поддомены. На странице Установка для каждого домена видно, когда виджет последний раз загружался там.
3. Проверьте
Новая установка начинает в режиме «Выключен». Переключите его на «Только я» и откройте сайт по ссылке предпросмотра из личного кабинета, добавив &lockstock_debug=1. Посмотрите в консоль браузера: одна строка от виджета покажет режим запуска, вашу группу и включён ли виджет. Затем запускайте поэтапно.
Если строки нет или в ней сказано, что виджет выключен, см. Решение проблем.