Интеграция Shopping Assistant

Выберите способ отображения чата. Во всех вариантах сначала подготовьте секцию ассистента и данные, затем проверьте ответы в «Превью».

Вариант	Когда подходит	Что реализует ваша команда
Web через кампанию	Нужен готовый чат на сайте с Web-интеграцией Gravity Field.	Настраивает кампанию, добавляет точку входа, оформляет чат и вставляет товарный шаблон. Виджет отправляет сообщения и отображает переписку.
API	Нужен собственный интерфейс или другой клиентский канал.	Хранит состояние чата, отправляет запросы, отображает ответы и карточки, обрабатывает действия и события.
Android / iOS SDK	Ассистент нужен в мобильном приложении.	Добавляет кнопку входа и товарную карусель, обрабатывает переходы. SDK обеспечивает экран чата и обмен сообщениями.

Где искать инструкции

• Источники данных — каталог, собственный поиск, наличие в магазинах и отзывы. Начните с подготовки данных.
• Web-интеграция — готовый виджет и кампания. Параметры виджета пригодятся при настройке внешнего вида и поведения интерфейса.
• API-интеграция — последовательность реализации собственного чата. Точные поля запросов и ответов находятся в API-справочнике.
• Трекинг событий — передача показов, кликов и действий покупателя. Проверьте его после реализации интерфейса.

До начала разработки

1. Получите ID секции и подтвердите, что для неё подключён Shopping Assistant.
2. Проверьте товары, доступные сценарии и контекст страниц.
3. Согласуйте место показа и контрольную группу кампании.
4. Определите, кто отвечает за кнопку, товарные карточки, поддержку и события.

Для API V2 нужны API-ключ и базовая интеграция. Установка Web-скрипта описана отдельно. Не размещайте серверные API-ключи в публичном коде кампании.

После интеграции

Проверьте чат на целевых страницах, в контрольной группе и при ошибках сети. Убедитесь, что события отправляются один раз: трекинг. Завершите проверку запуска.

Если вы меняете канал или используете новую функцию API, проверьте поддержку в выбранном интерфейсе. Серверная возможность не добавляет автоматически кнопку или обработчик в Web-виджет.