Tags

Tagi powiązane z kontenerem. Tagi są zazwyczaj powiązane z co najmniej 1 regułą uruchamiania (patrz firingRuleId poniżej) i opcjonalnie z co najmniej 1 regułą blokowania (patrz blockingRuleId poniżej). Gdy co najmniej 1 reguła uruchamiania otrzyma wartość prawda, a dokładnie zero reguł blokowania zwróci wartość prawda, tag zostanie uruchomiony (wykonanie). Użyj opcjonalnej właściwości priority, aby określić, które tagi mają się uruchamiać jako pierwsze. Użyj właściwości dependencies, aby określić, które inne tagi muszą się uruchomić i zakończyć przed uruchomieniem tego tagu. Szczegółowe informacje o parametrach, które można ustawiać w tagach Menedżera tagów Google, znajdziesz w dokumentacji słownika tagów.

Listę metod dostępnych w przypadku tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Reprezentuje tag Menedżera tagów 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
}
nazwa usługi, Wartość Opis Uwagi
accountId string Identyfikator konta Menedżera tagów Google.
blockingRuleId[] list Identyfikatory reguł blokowania. Jeśli któraś z wymienionych reguł ma wartość prawda, tag się nie uruchomi. z możliwością zapisu
blockingTriggerId[] list Identyfikatory reguł blokujących. Jeśli któraś z tych reguł ma wartość Prawda, tag się nie uruchomi. z możliwością zapisu
containerId string Identyfikator kontenera Menedżera tagów Google.
fingerprint string Odcisk cyfrowy tagu Menedżera tagów Google obliczany podczas przechowywania. Ta wartość jest obliczana ponownie po każdej modyfikacji tagu.
firingRuleId[] list Uruchamianie identyfikatorów reguł. Tag jest uruchamiany, gdy którakolwiek z wymienionych reguł jest prawdziwa, a wszystkie reguły blockingRuleIds (jeśli zostały określone) mają wartość fałsz. z możliwością zapisu
firingTriggerId[] list Identyfikatory aktywatorów. Tag jest uruchamiany, gdy którakolwiek z tych reguł ma wartość prawda, a wszystkie jego reguły (blockingTriggerIds) mają wartość Fałsz. z możliwością zapisu
liveOnly boolean Jeśli zasada ma wartość Prawda, ten tag będzie się uruchamiać tylko w środowisku aktywnym (np. nie w trybie podglądu ani debugowania). z możliwością zapisu
name string Wyświetlana nazwa tagu. z możliwością zapisu
notes string Użytkownik zauważa, jak zastosować ten tag w kontenerze. z możliwością zapisu
parameter[] list Parametry tagu. z możliwością zapisu
parameter[].key string Nazwany klucz, który jednoznacznie identyfikuje parametr. Wymagane dla parametrów najwyższego poziomu oraz wartości mapy. Ignorowana w przypadku wartości list. z możliwością zapisu
parameter[].list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
parameter[].map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
parameter[].type string Typ parametru. Prawidłowe wartości to:
  • boolean: wartość jest wartością logiczną „true” (prawda) lub „false” (fałsz).
  • integer: wartość przedstawia 64-bitową liczbę całkowitą ze znakiem w systemie 10
  • list: należy określić listę parametrów
  • map: należy określić mapę parametrów
  • template: wartość reprezentuje dowolny tekst; może to być odwołania do zmiennych (nawet odwołania do zmiennych, które mogą zwracać typy inne niż ciągi znaków).
  • trigger_reference: wartość reprezentuje regułę, reprezentującą ją identyfikator reguły.


Akceptowane wartości:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
z możliwością zapisu
parameter[].value string Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
parentFolderId string Identyfikator folderu nadrzędnego.
paused boolean Prawda, jeśli tag jest wstrzymany. z możliwością zapisu
priority nested object Zdefiniowany przez użytkownika liczbowy priorytet tagu. Tagi są uruchamiane asynchronicznie w kolejności zgodnej z priorytetem. Tagi o większej wartości liczbowej uruchamiają się jako pierwsze. Priorytet tagu może być dodatni lub ujemny. Wartością domyślną jest 0. z możliwością zapisu
priority.key string Nazwany klucz, który jednoznacznie identyfikuje parametr. Wymagane dla parametrów najwyższego poziomu oraz wartości mapy. Ignorowana w przypadku wartości list. z możliwością zapisu
priority.list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
priority.map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
priority.type string Typ parametru. Prawidłowe wartości to:
  • boolean: wartość jest wartością logiczną „true” (prawda) lub „false” (fałsz).
  • integer: wartość przedstawia 64-bitową liczbę całkowitą ze znakiem w systemie 10
  • list: należy określić listę parametrów
  • map: należy określić mapę parametrów
  • template: wartość reprezentuje dowolny tekst; może to być odwołania do zmiennych (nawet odwołania do zmiennych, które mogą zwracać typy inne niż ciągi znaków).
  • trigger_reference: wartość reprezentuje regułę, reprezentującą ją identyfikator reguły.


Akceptowane wartości:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
z możliwością zapisu
priority.value string Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
scheduleEndMs long Sygnatura czasowa zakończenia (w milisekundach) pozwalająca zaplanować tag. z możliwością zapisu
scheduleStartMs long Sygnatura czasowa początku uruchomienia tagu (w milisekundach). z możliwością zapisu
setupTag[] list Lista tagów konfiguracji. Obecnie zezwalamy na jedną z tych opcji.
setupTag[].stopOnSetupFailure boolean Jeśli ma wartość prawda, uruchamiaj tag główny tylko wtedy, gdy tag konfiguracji zostanie uruchomiony. Jeśli wartość to fałsz, uruchamiaj tag główny niezależnie od stanu uruchomienia tagu konfiguracji.
setupTag[].tagName string Nazwa tagu konfiguracji.
tagFiringOption string Opcja uruchamiania tego tagu.

Akceptowane wartości:
  • "oncePerEvent"
  • "oncePerLoad"
  • "unlimited"
tagId string Identyfikator tagu jednoznacznie identyfikuje tag Menedżera tagów Google.
teardownTag[] list Lista tagów dezaktywacji. Obecnie zezwalamy na jedną z tych opcji.
teardownTag[].stopTeardownOnFailure boolean Jeśli ma wartość prawda, tag dezaktywacji uruchamiaj tylko wtedy, gdy tag główny uruchomi się pomyślnie. Jeśli ma wartość false (fałsz), uruchamiaj tag dezaktywacji niezależnie od stanu uruchomienia głównego tagu.
teardownTag[].tagName string Nazwa tagu demontażu.
type string Typ tagu Menedżera tagów Google. z możliwością zapisu

Metody

Skorzystaj z poniższych metod, aby tworzyć, modyfikować, usuwać i pobierać tagi.

create (utwórz)
Tworzy tag Menedżera tagów Google.
usuń
Usuwa tag Menedżera tagów Google.
pobierz
Pobiera tag Menedżera tagów Google.
list
Wyświetla listę wszystkich tagów Menedżera tagów Google w kontenerze.
aktualizacja
Aktualizuje tag Menedżera tagów Google.