Инструкция по интеграции для сайтов электронной коммерции

Данная инструкция описывает общий подход к интеграции продуктов компании Search AI для электронной коммерции.

В большинстве случаев интеграция осуществляется путем добавления трекингового кода на все страницы сайта, а все последующие действия выполняются техническими специалистами компании Search AI.

Для интеграции всех компонентов сервиса используется единый интеграционный сниппет.

Сбор поведенческих событий

Для сбора событий с сайта необходимо импортировать скрипт client.js на каждую страницу сайта в начало секции body. Скрипт доступен по адресу:

//cdn.diginetica.net/<site id>/client.js?ts=<timestamp>, где:

<site id> - здесь и далее - число, идентификатор соответствующего сайта (должен прилагаться к данной инструкции)

<timestamp> - текущий timestamp (формат - UNIX time на https://currentmillis.com/), в JavaScript может быть получен методом Date.now(). Должен быть актуальным при каждой загрузке страницы.

Скрипт доступен по протоколам HTTP и HTTPS; необходимо использовать тот же протокол, который использует сам сайт. Рекомендуется импортировать его с атрибутами defer и async, чтобы он не влиял на загрузку страницы.

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

<html>

<head>

...

</head>

<body>

...

</body>

</html>

ⓘ Обратить внимание

Сниппет устанавливается в начало секции body (в теге body приоритетнее всего, но ниже элементов страницы и ниже GTM) для минимизации времени отображения поисковых подсказок и виджета на странице результатов поиска. Если у вас SPA, то его инициализация нужна после рендера DOM элементов

Интеграционный сниппет

Интеграционный сниппет представляет собой javascript код. Установить асинхронный трекинговый код на сайт можно с помощью следующего сниппета:

var digiScript = document.createElement('script');

digiScript.src = '//cdn.diginetica.net/<site id>/client.js?ts=' + Date.now();

digiScript.defer = true;

digiScript.async = true;

document.body.appendChild(digiScript);

</script>

ⓘ Обратить внимание

Параметр <site id> должен быть корректно заполнен для интегрируемого сайта из числа идентификаторов, предоставленных сотрудниками компании Search AI.