REST Resource: accounts.containers.triggers

Ressource: Trigger

Stellt einen Google Tag Manager-Trigger dar

JSON-Darstellung
{
  "accountId": string,
  "containerId": 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)
  },
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
Felder
accountId

string

GTM-Konto-ID

containerId

string

GTM-Container-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 auf das Auslösen von Tags gewartet werden soll, wenn „waits_for_tags“ oben zu

true

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

uniqueTriggerId

object (Parameter)

Die global eindeutige ID des Triggers, der diese Daten automatisch generiert (z. B. ein Formular-, Link-Klick- 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.

parameter[]

object (Parameter)

Zusätzliche Parameter

EventType

Enums
pageview
domReady
windowLoaded
customEvent
triggerGroup
always
formSubmission
click
linkClick
jsError
historyChange
timer
ampClick
ampTimer
ampScroll
ampVisibility
youTubeVideo
scrollDepth
elementVisibility

Bedingung

Stellt ein Prädikat dar.

JSON-Darstellung
{
  "type": enum (ConditionType),
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
Felder
type

enum (ConditionType)

Der Operatortyp für diese Bedingung.

parameter[]

object (Parameter)

Eine Liste mit benannten Parametern (Schlüssel/Wert), je nach Typ der Bedingung. Hinweise:

  • Geben Sie für binäre Operatoren die Parameter

    arg0

    und

    arg1

    für die Angabe des linken und rechten Operanden.

  • Zu diesem Zeitpunkt ist der linke Operand (

    arg0

    ) muss ein Verweis auf eine Variable sein.

  • Wenn die Groß- und Kleinschreibung beim Regex-Abgleich ignoriert werden soll, fügen Sie den booleschen Parameter

    ignore_case

    die auf

    true

    . Wenn dieser Wert nicht angegeben oder auf einen anderen Wert festgelegt ist, wird die Übereinstimmung nach Groß- und Kleinschreibung geprüft.

  • Wenn Sie einen Operator negieren möchten, fügen Sie einen booleschen Parameter mit dem Namen

    negate

    boolescher Parameter, der auf

    true

    .

ConditionType

Enums
equals
contains
startsWith
endsWith
matchRegex
greater
greaterOrEquals
less
lessOrEquals
cssSelector
urlMatches

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.

update

Aktualisiert einen GTM-Trigger.