Rules

Правила могут принимать значения "Истина" или "Ложь". Они используются для определения условий срабатывания и блокировки тегов, а также включения и отключения макросов в контейнерах мобильных приложений. Подробнее о правилах можно узнать в статьях о конфигурации тегов и макросов.

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

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

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

{
  "accountId": string,
  "containerId": string,
  "ruleId": string,
  "name": string,
  "notes": string,
  "condition": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ]
    }
  ],
  "fingerprint": string
}
Название свойства Значение Описание Примечания
accountId string Идентификатор аккаунта Менеджера тегов.
condition[] list Условия, формирующие правило (объединяются неявным логическим оператором AND). Можно перезаписывать
condition[].parameter[] list Список именованных параметров (ключ–значение). Различается в зависимости от типа условия. Примечания:
  • Для бинарных операторов добавьте параметры arg0 и arg1, описывающие левый и правый операнд соответственно.
  • Левый операнд (arg0) должен представлять собой ссылку на макрос.
  • Чтобы при сопоставлении регулярных выражений не учитывался регистр, добавьте логический параметр ignore_case со значением true. Если вы укажете другое значение или не укажете его вовсе, регистр будет учитываться.
  • Для отрицания оператора используется логический параметр negate со значением true.
Можно перезаписывать
condition[].parameter[].key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Можно перезаписывать
condition[].parameter[].list[] list Параметры этого параметра-списка (ключи игнорируются). Можно перезаписывать
condition[].parameter[].map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Можно перезаписывать
condition[].parameter[].type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на макрос (в том числе возвращающие нестроковые значения).


Допустимые значения:
  • boolean
  • integer
  • list
  • map
  • template
Можно перезаписывать
condition[].parameter[].value string Значение параметра, соответствующее указанному типу (может содержать ссылку на макрос, например "{{myMacro}}"). Можно перезаписывать
condition[].type string Тип оператора для этого условия.

Допустимые значения:
  • contains
  • cssSelector
  • endsWith
  • equals
  • greater
  • greaterOrEquals
  • less
  • lessOrEquals
  • matchRegex
  • startsWith
  • urlMatches
Можно перезаписывать
containerId string Идентификатор контейнера Менеджера тегов.
fingerprint string Цифровой отпечаток правила Менеджера тегов, вычисленный во время хранения. Вычисляется заново при каждом изменении правила.
name string Отображаемое название правила. Можно перезаписывать
notes string Пользовательские примечания об использовании правила в контейнере. Можно перезаписывать
ruleId string Уникальный идентификатор правила Менеджера тегов.

Методы

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

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