Tags

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

Ressourcendarstellungen

Stellt ein Google Tag Manager-Tag dar.

{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  ],
  "fingerprint": string,
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "tagManagerUrl": string,
  "paused": boolean,
  "monitoringMetadata": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "monitoringMetadataTagNameKey": string,
  "consentSettings": {
    "consentStatus": string,
    "consentType": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": 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
consentSettings	nested object	Einwilligungseinstellungen eines Tags.	Bearbeitbar
consentSettings.consentStatus	string	Der Einwilligungsstatus des Tags. Wenn die Richtlinie auf NEEDED gesetzt ist, prüft die Laufzeit, ob die im Feld consent_type angegebenen Einwilligungsarten gewährt wurden. Zulässige Werte sind: "needed" "notNeeded" "notSet"
consentSettings.consentType	nested object	Die Art der Einwilligungen, die bei der Tag-Auslösung im Status „Einwilligung erforderlich“ geprüft werden sollen. Dieser Parameter muss vom Typ LIST sein, wobei jedes Listenelement den Typ STRING hat.
consentSettings.consentType.isWeakReference	boolean	Gibt an, ob auf einen Referenztypparameter stark oder schwach verwiesen wird. Wird nur von Transformationen verwendet.	Bearbeitbar
consentSettings.consentType.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
consentSettings.consentType.list[]	list	Die Parameter dieses Listenparameters (Schlüssel werden ignoriert).	Bearbeitbar
consentSettings.consentType.map[]	list	Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein).	Bearbeitbar
consentSettings.consentType.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. tag_reference: Der Wert steht für ein Tag, das als Tag-Name dargestellt wird. Zulässige Werte sind: "boolean" "integer" "list" "map" "tagReference" "template" "triggerReference" "typeUnspecified"	Bearbeitbar
consentSettings.consentType.value	string	Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ.	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
monitoringMetadata	nested object	Eine Zuordnung von Schlüssel/Wert-Paaren von Tag-Metadaten, die in die Ereignisdaten für das Tag-Monitoring aufgenommen werden sollen. Hinweise: Dieser Parameter muss vom Typ MAP sein. Alle Parameter in der Karte sind vom Typ TEMPLATE, dürfen jedoch keine Variablenverweise enthalten.	Bearbeitbar
monitoringMetadata.isWeakReference	boolean	Gibt an, ob auf einen Referenztypparameter stark oder schwach verwiesen wird. Wird nur von Transformationen verwendet.	Bearbeitbar
monitoringMetadata.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
monitoringMetadata.list[]	list	Die Parameter dieses Listenparameters (Schlüssel werden ignoriert).	Bearbeitbar
monitoringMetadata.map[]	list	Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein).	Bearbeitbar
monitoringMetadata.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. tag_reference: Der Wert steht für ein Tag, das als Tag-Name dargestellt wird. Zulässige Werte sind: "boolean" "integer" "list" "map" "tagReference" "template" "triggerReference" "typeUnspecified"	Bearbeitbar
monitoringMetadata.value	string	Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ.	Bearbeitbar
monitoringMetadataTagNameKey	string	Wenn das Feld nicht leer ist, wird der Tag-Anzeigename mithilfe des angegebenen Schlüssels in die Monitoring-Metadatenzuordnung aufgenommen.	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[].isWeakReference	boolean	Gibt an, ob auf einen Referenztypparameter stark oder schwach verwiesen wird. Wird nur von Transformationen verwendet.	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. tag_reference: Der Wert steht für ein Tag, das als Tag-Name dargestellt wird. Zulässige Werte sind: "boolean" "integer" "list" "map" "tagReference" "template" "triggerReference" "typeUnspecified"	Bearbeitbar
parameter[].value	string	Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ.	Bearbeitbar
parentFolderId	string	ID des übergeordneten Ordners.
path	string	relativer API-Pfad des GTM-Tags.
paused	boolean	Gibt an, ob das Tag pausiert ist, wodurch das Tag nicht ausgelöst wird.	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.isWeakReference	boolean	Gibt an, ob auf einen Referenztypparameter stark oder schwach verwiesen wird. Wird nur von Transformationen verwendet.	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. tag_reference: Der Wert steht für ein Tag, das als Tag-Name dargestellt wird. Zulässige Werte sind: "boolean" "integer" "list" "map" "tagReference" "template" "triggerReference" "typeUnspecified"	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" "tagFiringOptionUnspecified" "unlimited"
tagId	string	Mit der Tag-ID wird das GTM-Tag eindeutig identifiziert.
tagManagerUrl	string	Automatisch generierter Link zur Tag Manager-Benutzeroberfläche
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
workspaceId	string	GTM-Arbeitsbereich-ID.

Methoden

Erstellen

ein GTM-Tag erstellt wird.

delete

Google Tag Manager-Tags werden gelöscht.

get

Erhält ein GTM-Tag.

list

Listet alle GTM-Tags eines Containers auf.

revert

Änderungen an einem GTM-Tag in einem GTM-Arbeitsbereich rückgängig machen.

Aktualisieren

Ein GTM-Tag wird aktualisiert.