Благодарим за интерес к предварительной версии документации о новой платформе для тегов Google. Этот сайт проходит публичное бета-тестирование. Оставить отзыв

Настройка продуктов и отправка данных

Команды gtag() можно вызывать в любом месте страницы после глобального тега. В gtag() доступны три команды: config и set – для определения свойств, а event – для отправки данных.

Инициализация продуктов с помощью команды config

Используйте команду config, чтобы инициализировать и настроить параметры для аккаунта конкретного продукта. Команда config имеет следующий формат:

gtag('config', '<TARGET_ID>', {<additional_config_info>});

Здесь <TARGET_ID> – это идентификатор аккаунта продукта, в которой вы хотите отправлять данные, а <additional_config_info> – необязательный объект, в котором можно задать дополнительные параметры конфигурации.

С помощью команды config можно указать продукты и аккаунты, обрабатываемые тегом gtag.js, и задать соответствующие настройки. Действия, инициируемые командой config, зависят от продукта, указанного в параметре target_ID. Например, в некоторых случаях команда config сообщает gtag.js, что нужно отправить обращение типа "Просмотр страницы". Дополнительную информацию о том, как работает команда config в рамках того или иного продукта, можно получить по ссылкам ниже.

Простейший пример кода содержит только команду config и параметр target_ID:

gtag('config', 'G-XXXXXX');

Команду config можно изменить и дополнить, указав параметры в необязательном объекте <additional_config_info>. Например, информация о просмотре страниц не будет автоматически отправляться в Google Аналитику, если добавить следующий параметр:

gtag('config', 'G-XXXXXX', {'send_page_view': false});

Отправка данных при помощи команды event

Команда event позволяет указать, как передавать данные о событиях. Например, с помощью команды event можно отправить событие login (вход в аккаунт) с параметром method (способ), имеющим значение "Google":

gtag('event', 'login', {
  'method': 'Google'
});

Существует ряд рекомендуемых событий и параметров, которые могут оказаться полезными в определенных контекстах. Вы также можете отправлять пользовательские события, которые не входят в список рекомендуемых.

Настройка данных для всех событий с помощью команды set

Команда set позволяет задавать параметры для всех последующих событий на странице. Например, если во всех транзакциях на вашем сайте используется одинаковая валюта, вы можете один раз задать параметр currency в команде set, а не указывать валюту для каждого отдельного события.

gtag('set', {'currency': 'USD'});

В одной команде set можно задать несколько атрибутов.

gtag('set', {
  'country': 'US',
  'currency': 'USD'
});