REST Resource: accounts.containers.workspaces.triggers

Ressource: Trigger

Stellt einen Google Tag Manager-Trigger dar

JSON-Darstellung
{
  "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)
    }
  ]
}
Felder
path

string

Der relative API-Pfad des GTM-Triggers.

accountId

string

GTM-Konto-ID.

containerId

string

GTM-Container-ID.

workspaceId

string

GTM-Workspace-ID.

triggerId

string

Die Trigger-ID identifiziert den GTM-Trigger eindeutig.

name

string

Anzeigename des Triggers.

type

enum (EventType)

Hier wird das Datenschichtereignis definiert, das diesen Trigger auslöst.

customEventFilter[]

object (Condition)

Wird für benutzerdefinierte Ereignisse verwendet, die ausgelöst werden, wenn alle Bedingungen erfüllt sind.

filter[]

object (Condition)

Der Trigger wird nur ausgelöst, wenn alle Bedingungen erfüllt sind.

autoEventFilter[]

object (Condition)

Wird beim automatischen Ereignis-Tracking verwendet.

waitForTags

object (Parameter)

Ob die Formulareinreichung oder das Öffnen des Links verzögert werden soll, bis alle Tags ausgelöst wurden (durch Verhindern der Standardaktion und späteres Simulieren der Standardaktion). Nur gültig für die Trigger „Formulareinreichung“ und „Link-Klick“.

checkValidation

object (Parameter)

Ob Tags nur ausgelöst werden sollen, wenn das Ereignis „Senden des Formulars“ oder „Klick auf den Link“ nicht von einem anderen Ereignis-Handler abgebrochen wird (z.B. aufgrund von Validierung). Nur gültig für die Trigger „Formulareinreichung“ und „Link-Klick“.

waitForTagsTimeout

object (Parameter)

Zeit (in Millisekunden), die gewartet werden soll, bis Tags ausgelöst werden, wenn „waits_for_tags“ oben zu

true

Nur gültig für Trigger vom Typ „Formular senden“ und „Link-Klick“.

uniqueTriggerId

object (Parameter)

Die globale eindeutige ID des Triggers, der diese Daten automatisch generiert (z. B. ein Formulareinreichungs-, Linkklick- oder Timer-Listener). Damit können inkompatible automatische Ereignisse mit Triggerfiltern auf Grundlage von Trigger-IDs zusammenarbeiten. Dieser Wert wird bei der Ausgabegenerierung festgelegt, da die von Triggern implizierten Tags erst dann vorhanden sind. Nur gültig für die Trigger „Formular senden“, „Link-Klick“ und „Timer“.

eventName

object (Parameter)

Name des ausgelösten GTM-Ereignisses. Nur für Timer-Trigger gültig.

interval

object (Parameter)

Zeit zwischen dem Auslösen wiederkehrender Timer-Ereignisse (in Millisekunden). Nur für Timer-Trigger gültig.

limit

object (Parameter)

Begrenzung der Anzahl der GTM-Ereignisse, die durch diesen Timer-Trigger ausgelöst werden. Wenn kein Limit festgelegt ist, werden GTM-Ereignisse weiter ausgelöst, bis der Nutzer die Seite verlässt. Nur für Timer-Trigger gültig.

fingerprint

string

Der Fingerabdruck des GTM-Triggers, wie er zum Zeitpunkt der Speicherung berechnet wurde. Dieser Wert wird jedes Mal neu berechnet, wenn der Trigger geändert wird.

parentFolderId

string

ID des übergeordneten Ordners.

selector

object (Parameter)

CSS-Selektor für Klicktrigger (z. B. „a“, „button“ usw.) Nur für AMP-Klick-Trigger gültig.

intervalSeconds

object (Parameter)

Zeit zwischen dem Auslösen von Timer-Ereignissen (in Sekunden). Nur für AMP-Timer-Trigger gültig.

maxTimerLengthSeconds

object (Parameter)

Maximale Zeit für das Auslösen von Timer-Ereignissen (in Sekunden). Nur für AMP-Timer-Trigger gültig.

verticalScrollPercentageList

object (Parameter)

Liste von Ganzzahlwerten für Prozentsätze für Scroll-Trigger. Der Trigger wird ausgelöst, wenn beim vertikalen Scrollen der Ansicht die einzelnen Prozentsätze erreicht werden. Nur gültig für AMP-Scroll-Trigger.

horizontalScrollPercentageList

object (Parameter)

Liste von Ganzzahlwerten für Prozentsätze für Scroll-Trigger. Der Trigger wird ausgelöst, wenn beim horizontalen Scrollen der Ansicht die einzelnen Prozentsätze erreicht werden. Nur gültig für AMP-Scroll-Trigger.

visibilitySelector

object (Parameter)

Ein CSS-Selektor für den Sichtbarkeitstrigger (z.B. „#id“). Nur für AMP-Sichtbarkeitstrigger gültig.

visiblePercentageMin

object (Parameter)

Ein Sichtbarkeitstrigger hat eine Mindestsichtbarkeit in Prozent. Nur für AMP-Sichtbarkeitstrigger gültig.

visiblePercentageMax

object (Parameter)

Ein Sichtbarkeitstrigger kann die maximale Sichtbarkeit in Prozent erreichen. Nur für AMP-Sichtbarkeitstrigger gültig.

continuousTimeMinMilliseconds

object (Parameter)

Mindestdauer der kontinuierlichen Sichtbarkeit eines Sichtbarkeitstriggers in Millisekunden. Nur für AMP-Sichtbarkeitstrigger gültig.

totalTimeMinMilliseconds

object (Parameter)

Mindestdauer der Sichtbarkeit eines Sichtbarkeitstriggers (in Millisekunden). Nur für AMP-Sichtbarkeitstrigger gültig.

tagManagerUrl

string

Automatisch generierter Link zur Tag Manager-Benutzeroberfläche

notes

string

Nutzerhinweise zur Anwendung dieses Triggers im Container.

parameter[]

object (Parameter)

Zusätzliche Parameter

EventType

Enums
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

Methoden

create

Erstellt einen GTM-Trigger.

delete

Löscht einen GTM-Trigger.

get

Ruft einen GTM-Trigger ab.

list

Hier werden alle GTM-Trigger eines Containers aufgelistet.

revert

Hiermit werden Änderungen an einem GTM-Trigger in einem GTM-Arbeitsbereich rückgängig gemacht.

update

Aktualisiert einen GTM-Trigger.