Сайт

SDK 1.0.12

Интеграция через JS SDK

На сайте интеграции встраиваются автоматически через SDK. Площадке нужно подключить скрипт, указать параметры конфигурации и обеспечить доступ к содержанию материалов.

Два слоя

Отображение на странице

SDK забирает готовую разметку по article_id и domain и аккуратно вставляет ссылки и мини-офферы в DOM.

Подбор интеграций

Системе нужен текст материалов: рекомендуем RSS/API; если нет — парсинг публичных страниц; либо ручной запуск в кабинете.

Доступ к контенту

RSS

Предпочтительный вариант: быстрее находим свежие публикации и готовим релевантные интеграции.

Парсинг

Если RSS нет — указываете раздел со статьями и пример страницы с полным текстом.

Только вручную

Подбор запускается только действием автора в разделе «Подбор интеграций».

Подключение SDK

SDK подключается к странице один раз. Для каждого нового материала нужен отдельный DOM-блок контента и свой article_id. Повторно инициализировать SDK не нужно.

Минимальная конфигурация

Ключ partnerApiKey выдаётся в кабинете автора после настройки площадки.

HTML
<script>
  window.LinkItBeConfig = {
    partnerApiKey: 'your-partner-api-key',
  };
</script>
<script
  src="https://cdn.jsdelivr.net/npm/@linkitbe/sdk@1.0.12/dist/linkitbe_sdk.min.js"
  integrity="sha384-Ww6R1ZxdWrEQUloQS0ukxhxFHaOKNexPnwFKHGvgTGi9uTT9lKqt0pYylrcZmJLN"
  crossorigin="anonymous"
  async
></script>

Обработка статьи вручную

Достаточно вызвать обработку для нового блока:

JavaScript
window.LinkItBe.initArticle(articleId, contentBlock);
  • articleId — id материала в системе сайта;
  • contentBlock — DOM-элемент с телом материала.
Один и тот же блок обрабатывается только один раз (SDK помечает его как обработанный).

Автообработка ленты

Для бесконечной ленты включите enableFeedAutoProcess и укажите контейнер, селектор контента и резолвер article_id.

  • contentSelector — CSS-селектор блока контента;
  • articleIdResolver — функция, возвращающая articleId для блока;
  • enableFeedAutoProcess — true для MutationObserver на ленте;
  • feedObserverRootSelector — корень наблюдения (обязателен при автоленте).
HTML
<script>
window.LinkItBeConfig = {
  partnerApiKey: 'your-partner-api-key',
  contentSelector: '[your-content-selector="content_block"]',
  articleIdResolver: function (contentBlock) {
    // your article Id Resolver, for example:
    // const firstP = contentBlock.querySelector('p[id]');
    // if (!firstP) return null;
    // const idMatch = firstP.id.match(/^(\d+)_/);
    // return idMatch ? idMatch[1] : null;
  },
  enableFeedAutoProcess: true,
  feedObserverRootSelector: 'your-feed-root-selector',
};
</script>
<script
  src="https://cdn.jsdelivr.net/npm/@linkitbe/sdk@1.0.12/dist/linkitbe_sdk.min.js"
  integrity="sha384-Ww6R1ZxdWrEQUloQS0ukxhxFHaOKNexPnwFKHGvgTGi9uTT9lKqt0pYylrcZmJLN"
  crossorigin="anonymous"
  async
></script>

Тест и прод

Тест без публикации изменений

  • Browser extension (обёртка над SDK)
  • Вставка SDK через DevTools Console

Интеграция с публикацией

  • SDK в шаблон страницы
  • Script в контент новости (если поддерживается CMS)

Полезные опции конфигурации

partnerApiKey
API-ключ партнёра (обязателен для запросов разметки).
domain
По умолчанию window.location.hostname — домен площадки в системе.
contentSelector
Селектор DOM-блока с текстом статьи.
articleIdResolver
Функция (contentBlock) => articleId.
bootOnLoad
true — автозапуск при загрузке страницы (по умолчанию).
enableFeedAutoProcess
Автообработка новых узлов в ленте.
feedObserverRootSelector
Контейнер ленты для MutationObserver.
allowedFormats
Например ['keyword', 'mini-offer'] — какие форматы применять на клиенте.
apiBaseUrl
Базовый URL API разметки (по умолчанию https://api.linkitbe.com).
miniOfferInsertBeforeSelector
Куда вставлять мини-оффер; null — в конец contentBlock.
showPreview
Показывать превью оффера при наведении на ссылку.

Публичный API SDK

  • window.LinkItBe.initArticle(articleId, contentBlock) — обработать один материал;
  • window.LinkItBe.startFeedAutoMarkup(feedRoot) — запустить observer на контейнере ленты.