Tags

Die mit dem Container verknüpften Tags. Tags sind normalerweise mit einer oder mehreren Auslösungsregeln (siehe firingRuleId unten) und optional mit einer oder mehreren Blockierregeln (siehe blockingRuleId unten) verknüpft. Wenn mindestens eine Auslösungsregel den Wert "true" und genau null Blockierregeln den Wert "true" ergibt, wird das Tag ausgelöst (ausführen). Mit der optionalen Eigenschaft priority können Sie festlegen, welche Tags vor anderen Tags ausgelöst werden. Verwenden Sie die Eigenschaft dependencies, um anzugeben, welche anderen Tags ausgelöst und abgeschlossen werden müssen, bevor dieses Tag ausgelöst wird. Weitere Informationen zu den Parametern, die für Google Tag Manager-Tags festgelegt werden können, finden Sie in der Tag-Wörterbuch-Referenz.

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Stellt ein Google Tag Manager-Tag dar.

{
  "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
}

Property-Name	Wert	Beschreibung	Hinweise
accountId	string	Google Tag Manager-Konto-ID.
blockingRuleId[]	list	Blockierregel-IDs. Wenn eine der aufgeführten Regeln als „true“ ausgewertet wird, wird das Tag nicht ausgelöst.	Bearbeitbar
blockingTriggerId[]	list	Trigger-IDs blockieren Wenn einer der aufgeführten Trigger „true“ ergibt, wird das Tag nicht ausgelöst.	Bearbeitbar
containerId	string	GTM-Container-ID
fingerprint	string	Der Fingerabdruck des GTM-Tags, der zum Speichernzeitpunkt berechnet wird. Dieser Wert wird bei jeder Änderung des Tags neu berechnet.
firingRuleId[]	list	Auslösungsregel-IDs Ein Tag wird ausgelöst, wenn eine der aufgeführten Regeln erfüllt ist und alle zugehörigen blockingRuleIds-Werte (falls vorhanden) falsch sind.	Bearbeitbar
firingTriggerId[]	list	Auslösende Trigger-IDs. Ein Tag wird ausgelöst, wenn einer der aufgelisteten Trigger wahr ist und alle seine blockingTriggerIds (falls vorhanden) falsch sind.	Bearbeitbar
liveOnly	boolean	Ist die Richtlinie auf „true“ gesetzt, wird dieses Tag nur in der Live-Umgebung ausgelöst, nicht im Vorschau- oder Debug-Modus.	Bearbeitbar
name	string	Anzeigename des Tags.	Bearbeitbar
notes	string	Nutzerhinweise zur Anwendung dieses Tags auf den Container.	Bearbeitbar
parameter[]	list	Die Parameter des Tags.	Bearbeitbar
parameter[].key	string	Der benannte Schlüssel, der einen Parameter eindeutig identifiziert. Erforderlich für Parameter der obersten Ebene sowie für Zuordnungswerte. Wird für Listenwerte ignoriert.	Bearbeitbar
parameter[].list[]	list	Die Parameter dieses Listenparameters (Schlüssel werden ignoriert).	Bearbeitbar
parameter[].map[]	list	Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein).	Bearbeitbar
parameter[].type	string	Der Parametertyp. Gültige Werte sind: boolean: Der Wert steht für einen booleschen Wert, der als „wahr“ oder „falsch“ dargestellt wird. integer: Der Wert stellt einen vorzeichenbehafteten 64-Bit-Ganzzahlwert in Basis 10 dar. list: Es muss eine Liste mit Parametern angegeben werden map: Es muss eine Zuordnung von Parametern angegeben werden. template: Der Wert steht für beliebigen Text. Dieser kann Variablenverweise enthalten (auch Variablenverweise, die möglicherweise Typen zurückgeben, die keine Strings sind). trigger_reference: Der Wert stellt einen Trigger dar, der als Trigger-ID dargestellt wird. Zulässige Werte sind: "boolean" "integer" "list" "map" "template" "triggerReference"	Bearbeitbar
parameter[].value	string	Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ.	Bearbeitbar
parentFolderId	string	ID des übergeordneten Ordners.
paused	boolean	„True“, wenn das Tag pausiert ist.	Bearbeitbar
priority	nested object	Benutzerdefinierte numerische Priorität des Tags. Tags werden asynchron in der Reihenfolge ihrer Priorität ausgelöst. Tags mit einem höheren numerischen Wert werden zuerst ausgelöst. Die Priorität eines Tags kann ein positiver oder negativer Wert sein. Der Standardwert ist 0.	Bearbeitbar
priority.key	string	Der benannte Schlüssel, der einen Parameter eindeutig identifiziert. Erforderlich für Parameter der obersten Ebene sowie für Zuordnungswerte. Wird für Listenwerte ignoriert.	Bearbeitbar
priority.list[]	list	Die Parameter dieses Listenparameters (Schlüssel werden ignoriert).	Bearbeitbar
priority.map[]	list	Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein).	Bearbeitbar
priority.type	string	Der Parametertyp. Gültige Werte sind: boolean: Der Wert steht für einen booleschen Wert, der als „wahr“ oder „falsch“ dargestellt wird. integer: Der Wert stellt einen vorzeichenbehafteten 64-Bit-Ganzzahlwert in Basis 10 dar. list: Es muss eine Liste mit Parametern angegeben werden map: Es muss eine Zuordnung von Parametern angegeben werden. template: Der Wert steht für beliebigen Text. Dieser kann Variablenverweise enthalten (auch Variablenverweise, die möglicherweise Typen zurückgeben, die keine Strings sind). trigger_reference: Der Wert stellt einen Trigger dar, der als Trigger-ID dargestellt wird. Zulässige Werte sind: "boolean" "integer" "list" "map" "template" "triggerReference"	Bearbeitbar
priority.value	string	Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ.	Bearbeitbar
scheduleEndMs	long	Der Endzeitstempel in Millisekunden für die Planung eines Tags.	Bearbeitbar
scheduleStartMs	long	Der Startzeitstempel in Millisekunden für die Planung eines Tags.	Bearbeitbar
setupTag[]	list	Die Liste der Einrichtungs-Tags. Derzeit ist nur eine Methode zulässig.
setupTag[].stopOnSetupFailure	boolean	Bei „true“ wird das Haupt-Tag nur dann ausgelöst, wenn das Setup-Tag erfolgreich ausgelöst wurde. Bei „false“ wird das Haupt-Tag unabhängig vom Status der Auslösung des eingerichteten Tags ausgelöst.
setupTag[].tagName	string	Der Name des Einrichtungs-Tags.
tagFiringOption	string	Option zum Auslösen dieses Tags. Zulässige Werte sind: "oncePerEvent" "oncePerLoad" "unlimited"
tagId	string	Mit der Tag-ID wird das GTM-Tag eindeutig identifiziert.
teardownTag[]	list	Die Liste der Teardown-Tags. Derzeit ist nur eine Methode zulässig.
teardownTag[].stopTeardownOnFailure	boolean	Falls „true“, wird das Teardown-Tag nur dann ausgelöst, wenn das Haupt-Tag erfolgreich ausgelöst wurde. Bei „false“ wird das Teardown-Tag unabhängig vom Hauptauslösestatus des Tags ausgelöst.
teardownTag[].tagName	string	Der Name des Teardown-Tags.
type	string	GTM-Tag-Typ.	Bearbeitbar

Methoden

Verwenden Sie die folgenden Methoden, um Tags zu erstellen, zu ändern, zu löschen oder abzurufen.

Erstellen

Ein GTM-Tag wird erstellt.

delete

Google Tag Manager-Tags werden gelöscht.

get

Erhält ein GTM-Tag.

list

Listet alle GTM-Tags eines Containers auf.

Aktualisieren

Ein GTM-Tag wird aktualisiert.