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 GTM-Konto-ID.
blockingRuleId[] list Blockierregel-IDs. Wird eine der aufgelisteten Regeln als „true“ ausgewertet, wird das Tag nicht ausgelöst. Bearbeitbar
blockingTriggerId[] list Trigger-IDs blockieren. Wird einer der aufgeführten Trigger als „true“ ausgewertet, wird das Tag nicht ausgelöst. Bearbeitbar
consentSettings nested object Einwilligungseinstellungen eines Tags. Bearbeitbar
consentSettings.consentStatus string Der Einwilligungsstatus des Tags. Wenn dieser Wert auf NEEDED gesetzt ist, prüft die Laufzeit, ob die im Feld consent_type angegebenen Einwilligungsarten gewährt wurden.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • needed
  • notNeeded
  • notSet
consentSettings.consentType nested object Die Art der Einwilligungen, die bei der Tag-Auslösung geprüft werden sollen, wenn der Status „Einwilligung erforderlich“ lautet. Dieser Parameter muss vom Typ LIST sein, wobei jedes Listenelement vom Typ STRING ist.
consentSettings.consentType.isWeakReference boolean Gibt an, ob stark oder schwach auf einen Referenztypparameter 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 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 Kartenparameters (müssen Schlüssel haben, 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 „true“ dargestellt wird oder „false“
  • integer: Der Wert stellt eine 64-Bit-Ganzzahl mit Vorzeichen zur Basis 10 dar.
  • list: Es sollte eine Liste von Parametern angegeben werden.
  • map: Es sollte eine Zuordnung von Parametern angegeben werden.
  • template: Der Wert steht für einen beliebigen Text. Dies kann Variablenverweise umfassen (auch Variablenverweise, die Nicht-String-Typen zurückgeben)
  • trigger_reference: Der Wert steht für einen Trigger, 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: <ph type="x-smartling-placeholder">
    </ph>
  • boolean
  • integer
  • list
  • map
  • tagReference
  • template
  • triggerReference
  • typeUnspecified
Bearbeitbar
consentSettings.consentType.value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten), je nach dem angegebenen Typ. Bearbeitbar
containerId string GTM-Container-ID.
fingerprint string Der Fingerabdruck des GTM-Tags, der zum Zeitpunkt der Speicherung berechnet wurde. Dieser Wert wird bei jeder Änderung des Tags neu berechnet.
firingRuleId[] list Auslösungsregel-IDs. Ein Tag wird ausgelöst, wenn eine der aufgelisteten Regeln wahr und alle zugehörigen blockingRuleIds (falls angegeben) falsch sind. Bearbeitbar
firingTriggerId[] list Trigger-IDs werden ausgelöst. Ein Tag wird ausgelöst, wenn einer der aufgeführten Trigger wahr und alle zugehörigen blockingTriggerIds (falls angegeben) falsch sind. Bearbeitbar
liveOnly boolean Ist sie auf „true“ gesetzt, wird das Tag nur in der Live-Umgebung ausgelöst, also nicht im Vorschau- oder Debug-Modus. Bearbeitbar
monitoringMetadata nested object Eine Zuordnung von Schlüssel/Wert-Paaren von Tag-Metadaten, die für das Tag-Monitoring in die Ereignisdaten einbezogen 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 stark oder schwach auf einen Referenztypparameter 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 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 Kartenparameters (müssen Schlüssel haben, 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 „true“ dargestellt wird oder „false“
  • integer: Der Wert stellt eine 64-Bit-Ganzzahl mit Vorzeichen zur Basis 10 dar.
  • list: Es sollte eine Liste von Parametern angegeben werden.
  • map: Es sollte eine Zuordnung von Parametern angegeben werden.
  • template: Der Wert steht für einen beliebigen Text. Dies kann Variablenverweise umfassen (auch Variablenverweise, die Nicht-String-Typen zurückgeben)
  • trigger_reference: Der Wert steht für einen Trigger, 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: <ph type="x-smartling-placeholder">
    </ph>
  • boolean
  • integer
  • list
  • map
  • tagReference
  • template
  • triggerReference
  • typeUnspecified
Bearbeitbar
monitoringMetadata.value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten), je nach dem angegebenen Typ. Bearbeitbar
monitoringMetadataTagNameKey string Wenn das Feld nicht leer ist, wird der Anzeigename des Tags mithilfe des angegebenen Schlüssels in die Monitoring-Metadatenzuordnung aufgenommen. Bearbeitbar
name string Anzeigename des Tags. Bearbeitbar
notes string Nutzernotizen zur Anwendung dieses Tags im Container. Bearbeitbar
parameter[] list Die Parameter des Tags. Bearbeitbar
parameter[].isWeakReference boolean Gibt an, ob stark oder schwach auf einen Referenztypparameter 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 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 Kartenparameters (müssen Schlüssel haben, 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 „true“ dargestellt wird oder „false“
  • integer: Der Wert stellt eine 64-Bit-Ganzzahl mit Vorzeichen zur Basis 10 dar.
  • list: Es sollte eine Liste von Parametern angegeben werden.
  • map: Es sollte eine Zuordnung von Parametern angegeben werden.
  • template: Der Wert steht für einen beliebigen Text. Dies kann Variablenverweise umfassen (auch Variablenverweise, die Nicht-String-Typen zurückgeben)
  • trigger_reference: Der Wert steht für einen Trigger, 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: <ph type="x-smartling-placeholder">
    </ph>
  • boolean
  • integer
  • list
  • map
  • tagReference
  • template
  • triggerReference
  • typeUnspecified
Bearbeitbar
parameter[].value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten), je nach dem angegebenen 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 höherem 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 stark oder schwach auf einen Referenztypparameter 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 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 Kartenparameters (müssen Schlüssel haben, 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 „true“ dargestellt wird oder „false“
  • integer: Der Wert stellt eine 64-Bit-Ganzzahl mit Vorzeichen zur Basis 10 dar.
  • list: Es sollte eine Liste von Parametern angegeben werden.
  • map: Es sollte eine Zuordnung von Parametern angegeben werden.
  • template: Der Wert steht für einen beliebigen Text. Dies kann Variablenverweise umfassen (auch Variablenverweise, die Nicht-String-Typen zurückgeben)
  • trigger_reference: Der Wert steht für einen Trigger, 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: <ph type="x-smartling-placeholder">
    </ph>
  • boolean
  • integer
  • list
  • map
  • tagReference
  • template
  • triggerReference
  • typeUnspecified
Bearbeitbar
priority.value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten), je nach dem angegebenen 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 Setup-Tags. Derzeit ist nur eine Option 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 Einrichtungs-Tag-Auslösung ausgelöst.
setupTag[].tagName string Der Name des Setup-Tags.
tagFiringOption string Option zum Auslösen dieses Tags.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • oncePerEvent
  • oncePerLoad
  • tagFiringOptionUnspecified
  • unlimited
tagId string Mit der Tag-ID wird das GTM-Tag eindeutig identifiziert.
tagManagerUrl string Automatisch erstellter Link zur Tag Manager-Benutzeroberfläche
teardownTag[] list Die Liste der Teardown-Tags. Derzeit ist nur eine Option zulässig.
teardownTag[].stopTeardownOnFailure boolean Falls wahr, 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 Status der Haupt-Tag-Auslösung ausgelöst.
teardownTag[].tagName string Der Name des Teardown-Tags.
type string GTM-Tag-Typ. Bearbeitbar
workspaceId string GTM-Arbeitsbereich-ID.

Methoden

erstellen
Erstellt ein GTM-Tag.
Delete
Löscht ein GTM-Tag.
get
Ruft ein GTM-Tag ab.
list
Listet alle GTM-Tags eines Containers auf.
Wiederherstellen
Setzt Änderungen an einem GTM-Tag in einem GTM-Arbeitsbereich zurück.
Update
Aktualisiert ein GTM-Tag.