SDKВебJavaScript SDK

JavaScript SDK

JavaScript SDK для запроса и отображения рекламы в HTML, React и Vue.

Площадка

Для подключения нужны ID площадки и список адресов сайтов, на которых будет размещена реклама.

Поле	Значение
Название	Название площадки в кабинете и отчётах.
Адреса сайтов	HTTPS-адрес без пути, например `https://chat.example.com`.
`platformId`	Публичный ID площадки для настройки SDK.

Адрес должен точно совпадать с Origin запроса: протокол, домен и порт. Поддомены, включая www, указываются отдельно.

Подключение

Подключите скрипт, создайте клиент и передайте контейнер для рекламы.

HTML / JavaScript

<div id="ad-slot"></div>
<script src="https://sidekick-ads.com/sdk/sidekick-web.js"></script>
<script>
  const ads = Sidekick.create({ platformId: "plt_example" });

  ads.requestAd({
    target: document.getElementById("ad-slot"),
    requestId: "chat-42-message-7",
    context: {
      question: "Headphones?",
      answer: "Here are some options…"
    },
    test: true,
    testFormat: "card"
  });
</script>

platformId замените на ID площадки. Клиент создаётся один раз на время работы приложения. API-ключ для браузерного SDK не требуется.

Тестовая реклама

test: true возвращает тестовую рекламу без списаний. Формат задаётся в testFormat.

text · image · response · card · consent · quiz

Для рабочей интеграции уберите test или передайте false. При отсутствии рекламы или ошибке запроса сохраняйте ответ приложения.

Показ оплачивается, когда реклама увидена: не меньше половины карточки на экране не меньше секунды. SDK подтверждает просмотр сам.

Оформление →Справочник SDK →