Настройка передачи индивидуальных параметров через пиксель Target Ads

О том как правильно настроить пиксель платформы для сбора и отправки дополнительной информации о пользовательских действиях на сайте.
Функция _targetadsTag, используемая для взаимодействия с платформой Target Ads, принимает два основных аргумента:
Тип события: строковое значение, которое описывает тип отслеживаемого события. Пример такого события — page_view, что указывает на факт просмотра страницы пользователем.
Объект события: объект, который содержит детализированную информацию о событии. Для события типа page_view, этот объект может включать следующие сущности:
  • user: объект, содержащий параметры, характеризующие пользователя. В этом объекте могут быть различные атрибуты, описывающие пользователя, такие как сегмент, лояльность или дата последнего заказа. Уникальный идентификатор пользователя передаётся с использованием ключа uid.
  • event_params: объект, включающий параметры, непосредственно связанные с событием page_view. Эти параметры предоставляют дополнительные сведения, которые помогают более точно анализировать событие.
Обе категории параметров (user и event_params) состоят из пар ключ-значение, где ключ - это название параметра, а значение - данные, соответствующие этому параметру. Ограничение на количество параметров, которые можно передать, составляет до пяти параметров для каждого типа.

Подключение к библиотеке Target Ads осуществляется через асинхронную загрузку скрипта, что позволяет избежать задержек в отображении содержимого страницы. Инициализация платформы и передача данных о событии происходит при помощи вызова функции _targetadsTag с соответствующими аргументами.
Передача параметров осуществляется в строго определённом формате, и несоблюдение структуры или отсутствие ключевых параметров, таких как uid, может привести к неправильной обработке данных.
Вот пример использования функции _targetadsTag с абстрактными значениями идентификатора проекта, идентификатора пользователя и других параметров:

<script async src='https://cdn.targetads.io/websdk/index.js'></script>
<script>
// Инициализация targetAdsDataLayer, если она еще не была выполнена
window.targetAdsDataLayer = window.targetAdsDataLayer || [];

// Объявление функции-обертки для упрощения вызова targetAdsDataLayer
function _targetadsTag() {
    // Добавление переданных аргументов в массив targetAdsDataLayer
    window.targetAlexaDataLayer.push(arguments);
}

// Инициализация метрики с уникальным ID проекта
_targetadsTag('init', '<id проекта>');

// Отправка события просмотра страницы (page_view)
// с параметрами пользователя и параметрами события
_targetadsTag('page_view', {
    'user': {
        'uid': '<user id>', // Уникальный идентификатор пользователя
        '<параметр пользователя>': '<значение параметра>' // Дополнительные параметры
    },
    'event_params': {
        '<параметр события>': '<значение параметра>' // Параметры, связанные с событием
    }
});
</script>