REST Resource: accounts.containers.workspaces.triggers

Zasób: Trigger

Reprezentuje regułę Menedżera tagów Google.

Zapis JSON
{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "triggerId": string,
  "name": string,
  "type": enum (EventType),
  "customEventFilter": [
    {
      object (Condition)
    }
  ],
  "filter": [
    {
      object (Condition)
    }
  ],
  "autoEventFilter": [
    {
      object (Condition)
    }
  ],
  "waitForTags": {
    object (Parameter)
  },
  "checkValidation": {
    object (Parameter)
  },
  "waitForTagsTimeout": {
    object (Parameter)
  },
  "uniqueTriggerId": {
    object (Parameter)
  },
  "eventName": {
    object (Parameter)
  },
  "interval": {
    object (Parameter)
  },
  "limit": {
    object (Parameter)
  },
  "fingerprint": string,
  "parentFolderId": string,
  "selector": {
    object (Parameter)
  },
  "intervalSeconds": {
    object (Parameter)
  },
  "maxTimerLengthSeconds": {
    object (Parameter)
  },
  "verticalScrollPercentageList": {
    object (Parameter)
  },
  "horizontalScrollPercentageList": {
    object (Parameter)
  },
  "visibilitySelector": {
    object (Parameter)
  },
  "visiblePercentageMin": {
    object (Parameter)
  },
  "visiblePercentageMax": {
    object (Parameter)
  },
  "continuousTimeMinMilliseconds": {
    object (Parameter)
  },
  "totalTimeMinMilliseconds": {
    object (Parameter)
  },
  "tagManagerUrl": string,
  "notes": string,
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
Pola
path

string

Ścieżka względna interfejsu API reguły GTM.

accountId

string

Identyfikator konta Menedżera tagów Google.

containerId

string

Identyfikator kontenera GTM.

workspaceId

string

Identyfikator obszaru roboczego Menedżera tagów Google.

triggerId

string

Identyfikator reguły jednoznacznie identyfikuje regułę Google Tag Manager.

name

string

Wyświetlana nazwa reguły.

type

enum (EventType)

Definiuje zdarzenie warstwy danych, które powoduje to regułę.

customEventFilter[]

object (Condition)

Służy do wywoływania zdarzenia niestandardowego, które jest wywoływane, gdy wszystkie warunki są spełnione.

filter[]

object (Condition)

Reguła zostanie uruchomiona tylko wtedy, gdy wszystkie warunki będą spełnione.

autoEventFilter[]

object (Condition)

Służy do automatycznego śledzenia zdarzeń.

waitForTags

object (Parameter)

Czy opóźnić przesłanie formularza lub otwarcie linku do momentu wywołania wszystkich tagów (poprzez uniemożliwienie wykonania domyślnego działania i następne zasymulowanie tego działania). Dotyczy tylko reguł opartych na przesłaniu formularza i kliknięciach linków.

checkValidation

object (Parameter)

Czy tagi powinny być uruchamiane tylko wtedy, gdy zdarzenie przesłania formularza lub kliknięcia linku nie zostało anulowane przez inny moduł obsługi zdarzeń (np. ze względu na walidację). Dotyczy tylko reguł opartych na przesłaniu formularza i kliknięciach linków.

waitForTagsTimeout

object (Parameter)

Czas oczekiwania (w milisekundach) na wykonanie tagów, gdy wartość parametru „waits_for_tags” wynosi

true

Dostępne tylko w przypadku reguł Przesłanie formularza i Kliknięcie linku.

uniqueTriggerId

object (Parameter)

Niepowtarzalny globalnie identyfikator reguły, która automatycznie generuje ten element (detektor przesłania formularza, kliknięcia linku lub zegara), jeśli występuje. Służy do umożliwienia współpracy niezgodnych zdarzeń automatycznych z filtrowaniem reguł na podstawie identyfikatorów reguł. Ta wartość jest wypełniana podczas generowania danych wyjściowych, ponieważ tagi sugerowane przez te reguły nie istnieją do tego czasu. Dostępne tylko w przypadku reguł opartych na przesłaniu formularza, kliknięciach linków i regułach czasowych.

eventName

object (Parameter)

Nazwa wywołanego zdarzenia GTM. Dotyczy tylko wyzwalaczy typu Timer.

interval

object (Parameter)

Czas między wywołaniem cyklicznych zdarzeń typu Timer (w milisekundach). Dotyczy tylko wyzwalaczy typu Timer.

limit

object (Parameter)

Limit liczby zdarzeń GTM, które uruchamia ta reguła powiązana z licznikiem czasu. Jeśli nie ustawisz limitu, będziemy nadal wywoływać zdarzenia GTM, dopóki użytkownik nie opuści strony. Dotyczy tylko wyzwalaczy typu Timer.

fingerprint

string

Odcisk palca reguły GTM obliczonego w momencie zapisu. Ta wartość jest ponownie obliczana po każdej zmianie reguły.

parentFolderId

string

Identyfikator folderu nadrzędnego.

selector

object (Parameter)

Selektor CSS dla działania po kliknięciu (np. „a”, „button” itp.). Dotyczy tylko wyzwalacza kliknięcia w witrynie AMP.

intervalSeconds

object (Parameter)

Czas między wywołaniami zdarzeń typu Timer (w sekundach). Dotyczy tylko wyzwalacza AMP Timer.

maxTimerLengthSeconds

object (Parameter)

Maksymalny czas do uruchomienia zdarzeń typu Timer (w sekundach). Dotyczy tylko wyzwalacza AMP Timer.

verticalScrollPercentageList

object (Parameter)

Lista wartości liczbowych w procentach dla wyzwalaczy przewijania. Reguła zostanie uruchomiona, gdy po przewinięciu widoku w pionie zostanie osiągnięty każdy z tych procentów. Dotyczy tylko wyzwalaczy przewijania AMP.

horizontalScrollPercentageList

object (Parameter)

Lista wartości liczbowych w procentach dla wyzwalaczy przewijania. Reguła zostanie uruchomiona, gdy po przewinięciu widoku poziomo zostanie osiągnięty każdy z procentów. Dotyczy tylko wyzwalaczy przewijania AMP.

visibilitySelector

object (Parameter)

Selektor CSS reguły widoczności (np. „#id”). Dotyczy tylko wyzwalacza AMP Visibility.

visiblePercentageMin

object (Parameter)

Wyzwalacz widoczności – minimalny odsetek widoczności. Dotyczy tylko wyzwalacza AMP Visibility.

visiblePercentageMax

object (Parameter)

Wyzwalacz widoczności o maksymalnej widoczności procentowej. Dotyczy tylko wyzwalacza AMP Visibility.

continuousTimeMinMilliseconds

object (Parameter)

Minimalny ciągły czas widoczności (w milisekundach) dla reguły dotyczącej widoczności. Dotyczy tylko wyzwalacza AMP Visibility.

totalTimeMinMilliseconds

object (Parameter)

Minimalny łączny czas widoczności (w milisekundach) w przypadku reguły dotyczącej widoczności. Dotyczy tylko wyzwalacza AMP Visibility.

tagManagerUrl

string

Automatycznie wygenerowany link do interfejsu Menedżera tagów

notes

string

Użytkownik może dowiedzieć się, jak zastosować ten regułę w kontenerze.

parameter[]

object (Parameter)

dodatkowe parametry.

EventType

Wartości w polu enum
eventTypeUnspecified
pageview
domReady
windowLoaded
customEvent
triggerGroup
init
consentInit
serverPageview
always
firebaseAppException
firebaseAppUpdate
firebaseCampaign
firebaseFirstOpen
firebaseInAppPurchase
firebaseNotificationDismiss
firebaseNotificationForeground
firebaseNotificationOpen
firebaseNotificationReceive
firebaseOsUpdate
firebaseSessionStart
firebaseUserEngagement
formSubmission
click
linkClick
jsError
historyChange
timer
ampClick
ampTimer
ampScroll
ampVisibility
youTubeVideo
scrollDepth
elementVisibility

Metody

create

Tworzy prawidłowy element GTM.

delete

Usuwa regułę w Menedżerze tagów Google.

get

Pobiera regułę GTM.

list

Wyświetla wszystkie reguły GTM w kontenerze.

revert

Przywraca zmiany w wyzwalaczu GTM w Google Workspace.

update

Aktualizuje GTM Trigger.