Triggers: create

Требуется авторизация

Создает триггер Менеджера тегов. Испытайте метод в действии или изучите пример.

Запрос

HTTP-запрос

POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/triggers

Параметры

Название параметра Значение Описание
Параметры пути
accountId string Идентификатор аккаунта Менеджера тегов.
containerId string Идентификатор контейнера Менеджера тегов.

Авторизация

Этот запрос требует авторизации в указанной ниже области доступа. Подробнее об аутентификации и авторизации

Область доступа
https://www.googleapis.com/auth/tagmanager.edit.containers

Тело запроса

В теле запроса необходимо задать ресурс Triggers со следующими свойствами:

Название свойства Значение Описание Примечания
Обязательные свойства
autoEventFilter[].parameter[] list Именованные параметры (ключ-значение). Список параметров различается в зависимости от типа условия. Примечания:
  • Для бинарных операторов добавьте параметры arg0 и arg1, описывающие левый и правый операнд соответственно.
  • Левый операнд (arg0) должен представлять собой ссылку на переменную.
  • Чтобы при сопоставлении регулярных выражений не учитывался регистр, добавьте логический параметр ignore_case со значением true. Если вы укажете другое значение или не укажете его вовсе, регистр будет учитываться.
  • Для отрицания оператора используйте логический параметр negate со значением true.
Редактируемый объект
autoEventFilter[].parameter[].type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
autoEventFilter[].type string Тип оператора для этого условия.

Допустимые значения:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
Редактируемый объект
checkValidation.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
continuousTimeMinMilliseconds.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
customEventFilter[].parameter[] list Именованные параметры (ключ-значение). Список параметров различается в зависимости от типа условия. Примечания:
  • Для бинарных операторов добавьте параметры arg0 и arg1, описывающие левый и правый операнд соответственно.
  • Левый операнд (arg0) должен представлять собой ссылку на переменную.
  • Чтобы при сопоставлении регулярных выражений не учитывался регистр, добавьте логический параметр ignore_case со значением true. Если вы укажете другое значение или не укажете его вовсе, регистр будет учитываться.
  • Для отрицания оператора используйте логический параметр negate со значением true.
Редактируемый объект
customEventFilter[].parameter[].type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
customEventFilter[].type string Тип оператора для этого условия.

Допустимые значения:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
Редактируемый объект
eventName.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
filter[].parameter[] list Именованные параметры (ключ-значение). Список параметров различается в зависимости от типа условия. Примечания:
  • Для бинарных операторов добавьте параметры arg0 и arg1, описывающие левый и правый операнд соответственно.
  • Левый операнд (arg0) должен представлять собой ссылку на переменную.
  • Чтобы при сопоставлении регулярных выражений не учитывался регистр, добавьте логический параметр ignore_case со значением true. Если вы укажете другое значение или не укажете его вовсе, регистр будет учитываться.
  • Для отрицания оператора используйте логический параметр negate со значением true.
Редактируемый объект
filter[].parameter[].type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
filter[].type string Тип оператора для этого условия.

Допустимые значения:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
Редактируемый объект
horizontalScrollPercentageList.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
interval.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
intervalSeconds.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
limit.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
maxTimerLengthSeconds.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
name string Отображаемое название триггера. Редактируемый объект
parameter[].type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
selector.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
totalTimeMinMilliseconds.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
type string Определяет событие уровня данных, которое приводит к срабатыванию триггера.

Допустимые значения:
  • "always"
  • "ampClick"
  • "ampScroll"
  • "ampTimer"
  • "ampVisibility"
  • "click"
  • "customEvent"
  • "domReady"
  • "elementVisibility"
  • "formSubmission"
  • "historyChange"
  • "jsError"
  • "linkClick"
  • "pageview"
  • "scrollDepth"
  • "timer"
  • "windowLoaded"
  • "youTubeVideo"
Редактируемый объект
uniqueTriggerId.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
verticalScrollPercentageList.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
visibilitySelector.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
visiblePercentageMax.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
visiblePercentageMin.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
waitForTags.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
waitForTagsTimeout.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).


Допустимые значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Редактируемый объект
Необязательные свойства
autoEventFilter[] list Используется для автоматического отслеживания событий. Редактируемый объект
autoEventFilter[].parameter[].key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
autoEventFilter[].parameter[].list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
autoEventFilter[].parameter[].map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
autoEventFilter[].parameter[].value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
checkValidation nested object Должны ли теги активироваться только в том случае, если отправка формы или клик по ссылке не были отменены другим обработчиком событий (например, при подтверждении). Свойство действительно только для триггеров отправки формы и клика по ссылке. Редактируемый объект
checkValidation.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
checkValidation.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
checkValidation.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
checkValidation.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
continuousTimeMinMilliseconds nested object Минимальное непрерывное время видимости (в миллисекундах). Действительно только для триггеров видимости на AMP-страницах. Редактируемый объект
continuousTimeMinMilliseconds.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
continuousTimeMinMilliseconds.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
continuousTimeMinMilliseconds.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
continuousTimeMinMilliseconds.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
customEventFilter[] list Свойство для пользовательского события, которое запускается, только когда все условия выполнены. Редактируемый объект
customEventFilter[].parameter[].key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
customEventFilter[].parameter[].list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
customEventFilter[].parameter[].map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
customEventFilter[].parameter[].value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
eventName nested object Название запущенного события Менеджера тегов. Свойство действительно только для триггеров таймера. Редактируемый объект
eventName.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
eventName.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
eventName.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
eventName.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
filter[] list Триггер будет срабатывать, только если все условия выполнены. Редактируемый объект
filter[].parameter[].key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
filter[].parameter[].list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
filter[].parameter[].map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
filter[].parameter[].value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
horizontalScrollPercentageList nested object Список целочисленных процентных значений для триггеров прокрутки. Триггер будет срабатывать при достижении каждого из значений при прокрутке страницы по горизонтали. Свойство действительно только для триггеров прокрутки AMP-страниц. Редактируемый объект
horizontalScrollPercentageList.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
horizontalScrollPercentageList.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
horizontalScrollPercentageList.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
horizontalScrollPercentageList.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
interval nested object Время между активацией повторяющихся событий таймера (в миллисекундах). Свойство действительно только для триггеров таймера. Редактируемый объект
interval.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
interval.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
interval.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
interval.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
intervalSeconds nested object Время между запуском событий таймера (в секундах). Только для триггеров таймера на AMP-страницах. Редактируемый объект
intervalSeconds.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
intervalSeconds.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
intervalSeconds.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
intervalSeconds.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
limit nested object Максимальное количество событий Менеджера тегов, которые может активировать этот триггер таймера. Если ограничение не установлено, события будут запускаться, пока пользователь не покинет страницу. Свойство действительно только для триггеров таймера. Редактируемый объект
limit.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
limit.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
limit.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
limit.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
maxTimerLengthSeconds nested object Максимальное время для активации событий таймера (в секундах). Только для триггеров таймера на AMP-страницах. Редактируемый объект
maxTimerLengthSeconds.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
maxTimerLengthSeconds.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
maxTimerLengthSeconds.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
maxTimerLengthSeconds.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
parameter[].key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
parameter[].list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
parameter[].map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
parameter[].value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
selector nested object CSS-селектор триггера клика (например, "A" или "BUTTON"). Только для триггеров клика на AMP-страницах. Редактируемый объект
selector.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
selector.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
selector.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
selector.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
totalTimeMinMilliseconds nested object Минимальное общее время видимости (в миллисекундах). Действительно только для триггеров видимости на AMP-страницах. Редактируемый объект
totalTimeMinMilliseconds.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
totalTimeMinMilliseconds.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
totalTimeMinMilliseconds.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
totalTimeMinMilliseconds.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
uniqueTriggerId nested object Глобально уникальный идентификатор триггера, который генерирует автоматические события (отправку формы, клик по ссылке или прослушивание таймера). Обеспечивает совместимость таких событий с фильтрацией триггеров по идентификаторам. Значение свойства заполняется во время генерирования вывода, когда создаются связанные с триггерами теги. Действителен только для триггеров отправки формы, клика по ссылке и таймера. Редактируемый объект
uniqueTriggerId.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
uniqueTriggerId.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
uniqueTriggerId.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
uniqueTriggerId.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
verticalScrollPercentageList nested object Список целочисленных процентных значений для триггеров прокрутки. Триггер будет срабатывать при достижении каждого из значений при прокрутке страницы по вертикали. Свойство действительно только для триггеров прокрутки AMP-страниц. Редактируемый объект
verticalScrollPercentageList.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
verticalScrollPercentageList.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
verticalScrollPercentageList.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
verticalScrollPercentageList.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
visibilitySelector nested object CSS-селектор триггера видимости (например, "#id"). Действительно только для триггеров видимости на AMP-страницах. Редактируемый объект
visibilitySelector.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
visibilitySelector.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
visibilitySelector.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
visibilitySelector.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
visiblePercentageMax nested object Триггер для максимального процента видимости. Действительно только для триггеров видимости на AMP-страницах. Редактируемый объект
visiblePercentageMax.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
visiblePercentageMax.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
visiblePercentageMax.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
visiblePercentageMax.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
visiblePercentageMin nested object Триггер для минимального процента видимости. Действительно только для триггеров видимости на AMP-страницах. Редактируемый объект
visiblePercentageMin.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
visiblePercentageMin.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
visiblePercentageMin.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
visiblePercentageMin.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
waitForTags nested object Откладывать ли отправку формы или открытие ссылки до тех пор, пока не сработают все теги (для этого действие по умолчанию приостанавливается, а затем имитируется). Свойство действительно только для триггеров отправки формы и клика по ссылке. Редактируемый объект
waitForTags.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
waitForTags.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
waitForTags.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
waitForTags.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
waitForTagsTimeout nested object Время ожидания срабатывания тегов (в миллисекундах), когда свойство waits_for_tags (см. выше) принимает значение true. Свойство действительно только для триггеров отправки формы и клика по ссылке. Редактируемый объект
waitForTagsTimeout.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
waitForTagsTimeout.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
waitForTagsTimeout.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
waitForTagsTimeout.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект

Ответ

В случае успеха этот метод возвращает ресурс Triggers в теле ответа.

Примеры

Примечание. Примеры кода для этого метода не охватывают все поддерживаемые языки программирования (их список опубликован на странице, посвященной клиентским библиотекам).

Java

Используется клиентская библиотека Java.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request creates a new trigger for the authorized user.
 */

// Create the condition parameters objects.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("arg0");
arg0.setValue("{{Page URL}}");
Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("arg1");
arg1.setValue("timed.html");

// Create the auto event condition object.
Condition condition = new Condition();
condition.setType("contains");
condition.setParameter(Arrays.asList(arg0, arg1));

// Create the event parameter.
Parameter eventName = new Parameter();
eventName.setType("template");
eventName.setValue("gtm.timer");

// Create the interval parameter.
Parameter interval = new Parameter();
interval.setType("template");
interval.setValue("10000");

// Create the limit parameter.
Parameter limit = new Parameter();
limit.setType("template");
limit.setValue("10");

// Create the trigger object.
Trigger trigger = new Trigger();
trigger.setName("Timer Trigger");
trigger.setType("timer");
trigger.setAutoEventFilter(Arrays.asList(condition));
trigger.setEventName(eventName);
trigger.setInterval(interval);
trigger.setLimit(limit);

try {
  Trigger response = tagmanager.accounts().containers().
      triggers().create("123456", "54321", trigger).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the create method are stored in the response object.
 * The following code shows how to access the created Id and Fingerprint.
 */
System.out.println("Trigger Id = " + response.getTriggerId());
System.out.println("Trigger Fingerprint = " + response.getFingerprint());

Python

Используется клиентская библиотека Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request creates a new trigger.
try:
  response = tagmanager.accounts().containers().triggers().create(
      accountId='123456',
      containerId='54321',
      body={
          'name': 'Timed trigger',
          'type': 'timer',
          'autoEventFilter': [
              {
                  'type': 'contains',
                  'parameter': [
                      {
                          'type': 'template',
                          'key': 'arg0',
                          'value': '{{Page URL}}'
                      },
                      {
                          'type': 'template',
                          'key': 'arg1',
                          'value': 'timed.html'
                      }
                  ]
              }
          ],
          'eventName': {
              'type': 'template',
              'value': 'gtm.timer'
          },
          'interval': {
              'type': 'template',
              'value': '10000'
          },
          'limit': {
              'type': 'template',
              'value': '10'
          }
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

# The results of the create method are stored in response object.
# The following code shows how to access the created id and fingerprint.
print 'Trigger Id = %s' % response.get('triggerId')
print 'Trigger Fingerprint = %s' % response.get('fingerprint')

Практическое задание

Воспользуйтесь инструментом API Explorer, чтобы применить этот метод к реальным данным и узнать, как он работает.