Tags: create

Ein GTM-Tag wird erstellt. Jetzt testen

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/tagmanager/v2/+parent/tags

Parameter

Parametername Wert Beschreibung
Pfadparameter
parent string Der relative API-Pfad von GTM Workspace. Beispiel: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autorisierung

Für diese Anfrage ist eine Autorisierung in folgendem Bereich erforderlich:

Umfang
https://www.googleapis.com/auth/tagmanager.edit.containers

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext eine Tags-Ressource mit den folgenden Eigenschaften an:

Property-Name Wert Beschreibung Hinweise
Erforderliche Eigenschaften
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
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
name string Anzeigename des Tags. 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
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
type string GTM-Tag-Typ. Bearbeitbar
Optionale Attribute
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.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.value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. Bearbeitbar
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.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.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
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[].value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. Bearbeitbar
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.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.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

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Tags-Ressource im Antworttext zurückgegeben.

Jetzt testen

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.