Macros

Die Makros eines Containers. Makros stellen Werte dar, die zur Laufzeit ausgewertet werden. Sie können beim Konfigurieren von Regeln und Tags auf Makros verweisen. Weitere Informationen zu den Eigenschaften, die für Google Tag Manager-Makros festgelegt werden können, finden Sie in der Makro-Wörterbuchreferenz. Informationen dazu, wie Nutzer Makros einrichten und verwenden, finden Sie in der Google Tag Manager-Hilfe unter Makros.

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

Ressourcendarstellungen

Stellt ein Google Tag Manager-Makro dar.

{
  "accountId": string,
  "containerId": string,
  "macroId": string,
  "name": string,
  "type": string,
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "enablingRuleId": [
    string
  ],
  "disablingRuleId": [
    string
  ],
  "fingerprint": string,
  "parentFolderId": string
}

Property-Name	Wert	Beschreibung	Hinweise
accountId	string	Google Tag Manager-Konto-ID.
containerId	string	GTM-Container-ID
disablingRuleId[]	list	Nur für mobile Container: Eine Liste mit Regel-IDs zum Deaktivieren bedingter Makros. Das Makro ist aktiviert, wenn eine der Aktivierungsregeln wahr ist, während alle Deaktivierungsregeln falsch sind. Wird als ungeordnetes Set behandelt.	Bearbeitbar
enablingRuleId[]	list	Nur für mobile Container: Eine Liste mit Regel-IDs zum Aktivieren bedingter Makros. Das Makro ist aktiviert, wenn eine der Aktivierungsregeln wahr und alle Deaktivierungsregeln falsch sind. Wird als ungeordnetes Set behandelt.	Bearbeitbar
fingerprint	string	Der Fingerabdruck des GTM-Makros, wie er zum Speicherzeitpunkt berechnet wird. Dieser Wert wird bei jeder Änderung des Makros neu berechnet.
macroId	string	Die Makro-ID kennzeichnet das GTM-Makro eindeutig.
name	string	Anzeigename des Makros.	Bearbeitbar
notes	string	Nutzerhinweise zur Anwendung dieses Makros im Container.	Bearbeitbar
parameter[]	list	Die Parameter des Makros.	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 Makroreferenzen enthalten, auch Makroreferenzen, die möglicherweise Typen zurückgeben, die keine Strings sind. Zulässige Werte sind: "boolean" "integer" "list" "map" "template"	Bearbeitbar
parameter[].value	string	Der Wert eines Parameters (kann Makroreferenzen wie "" enthalten) je nach Typ.	Bearbeitbar
parentFolderId	string	ID des übergeordneten Ordners.
scheduleEndMs	long	Der Endzeitstempel in Millisekunden zum Planen eines Makros.	Bearbeitbar
scheduleStartMs	long	Der Startzeitstempel in Millisekunden zum Planen eines Makros.	Bearbeitbar
type	string	GTM-Makrotyp.	Bearbeitbar

Methoden

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

Erstellen

Ein GTM-Makro wird erstellt.

delete

Damit wird ein GTM-Makro gelöscht.

get

Ruft ein GTM-Makro ab.

list

Listet alle GTM-Makros eines Containers auf.

Aktualisieren

Aktualisiert ein Google Tag Manager-Makro.