Tags

Теги контейнеров обычно связаны с одним или несколькими необязательными правилами активации (firingRuleId) и блокировки (blockingRuleId). Тег срабатывает, если хотя бы одно правило активации оказывается истинным, а все правила блокировки – ложными. Чтобы определить последовательность активации тегов, используйте необязательное свойство priority. А чтобы указать, какие теги должны срабатывать и завершать работу перед активацией определенного тега, используйте свойство dependencies. Подробную информацию о параметрах тегов можно найти в этой статье.

Список методов для этого ресурса приведен в конце страницы.

Представление ресурса

Представление тега Google Менеджера тегов.

{
  "accountId": string,
  "containerId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ]
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "fingerprint": string,
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "paused": boolean
}
Название свойства Значение Описание Примечания
accountId string Идентификатор аккаунта Менеджера тегов.
blockingRuleId[] list Идентификаторы правил блокировки. Если какое-либо из перечисленных правил окажется истинным, тег не сработает. Можно перезаписывать
blockingTriggerId[] list Идентификаторы блокирующих триггеров. Если какой-либо из перечисленных триггеров окажется истинным, тег не сработает. Можно перезаписывать
containerId string Идентификатор контейнера Менеджера тегов.
fingerprint string Цифровой отпечаток тега Менеджера тегов, вычисленный во время хранения. Вычисляется заново при каждом изменении тега.
firingRuleId[] list Идентификаторы правил активации. Тег будет срабатывать, если любое из перечисленных правил истинно, а все значения blockingRuleIds (если указаны) – ложны. Можно перезаписывать
firingTriggerId[] list Идентификаторы триггеров активации. Тег будет срабатывать, если любому из перечисленных триггеров присвоено значение true, а всем его blockingTriggerIds (если указаны) – false. Можно перезаписывать
liveOnly boolean Если свойству присвоено значение true, тег будет срабатывать только в реальной среде (а не в режиме предварительного просмотра или отладки). Можно перезаписывать
name string Отображаемое название тега. Можно перезаписывать
notes string Пользовательские примечания о том, как применять тег в контейнере. Можно перезаписывать
parameter[] list Параметры тега. Можно перезаписывать
parameter[].key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Можно перезаписывать
parameter[].list[] list Параметры этого параметра-списка (ключи игнорируются). Можно перезаписывать
parameter[].map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Можно перезаписывать
parameter[].type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые значения).


Допустимые значения:
  • boolean
  • integer
  • list
  • map
  • template
Можно перезаписывать
parameter[].value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Можно перезаписывать
parentFolderId string Идентификатор родительской папки.
paused boolean Приостановлен ли тег (логическое значение). Можно перезаписывать
priority nested object Определенный пользователем приоритет тега (в числовом выражении). Теги активируются асинхронно в соответствии с их приоритетом: те, у которых приоритет выше, активируются раньше. Приоритет тега может быть выражен положительным или отрицательным числом. Значение по умолчанию – 0. Можно перезаписывать
priority.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Можно перезаписывать
priority.list[] list Параметры этого параметра-списка (ключи игнорируются). Можно перезаписывать
priority.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Можно перезаписывать
priority.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые значения).


Допустимые значения:
  • boolean
  • integer
  • list
  • map
  • template
Можно перезаписывать
priority.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Можно перезаписывать
scheduleEndMs long Временная метка, соответствующая окончанию выполнения тега (в миллисекундах). Можно перезаписывать
scheduleStartMs long Временная метка, соответствующая началу выполнения тега (в миллисекундах). Можно перезаписывать
setupTag[] list Список тегов настройки (в настоящее время разрешен только один).
setupTag[].stopOnSetupFailure boolean Если задано значение true, основной тег будет активирован только в случае срабатывания тега настройки, а если false – независимо от этого.
setupTag[].tagName string Название тега настройки.
tagFiringOption string Вариант активации этого тега.

Допустимые значения:
  • oncePerEvent
  • oncePerLoad
  • unlimited
tagId string Уникальный идентификатор тега Менеджера тегов.
teardownTag[] list Список тегов teardown (в настоящее время разрешен только один).
teardownTag[].stopTeardownOnFailure boolean Если задано значение true, тег teardown будет активирован только в случае срабатывания основного тега, а если false – независимо от этого.
teardownTag[].tagName string Название тега teardown.
type string Тип тега Менеджера тегов. Можно перезаписывать

Методы

Ниже перечислены методы, с помощью которых можно создавать, изменять, удалять и получать теги.

create
Создает тег Менеджера тегов.
delete
Удаляет тег Менеджера тегов.
get
Получает тег Менеджера тегов.
list
Создает список всех тегов Менеджера тегов в контейнере.
update
Обновляет тег Менеджера тегов.