Rules

Die Regeln eines Containers. Die Regeln werden während der Laufzeit als "true" oder "false" ausgewertet. Damit lässt sich steuern, wann ein Tag ausgelöst wird oder nicht ausgelöst wird. Außerdem lässt sich damit steuern, wann Makros in einem mobilen Container aktiviert oder deaktiviert werden. Weitere Informationen finden Sie in den Regeln zum Auslösen und Deaktivieren einer Tag-Konfiguration bzw. in den Regeln zum Aktivieren und Deaktivieren der Konfiguration eines Makros.

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

Ressourcendarstellungen

Stellt eine Google Tag Manager-Regel dar.

{
  "accountId": string,
  "containerId": string,
  "ruleId": string,
  "name": string,
  "notes": string,
  "condition": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ]
    }
  ],
  "fingerprint": string
}

Property-Name	Wert	Beschreibung	Hinweise
accountId	string	Google Tag Manager-Konto-ID.
condition[]	list	Die Liste der Bedingungen, aus denen diese Regel besteht (implizites UND dazwischen).	Bearbeitbar
condition[].parameter[]	list	Eine Liste benannter Parameter (Schlüssel/Wert), je nach Art der Bedingung. Hinweise: Geben Sie für binäre Operatoren die Parameter arg0 und arg1 an, um den linken bzw. rechten Operanden anzugeben. Derzeit muss der linke Operand (arg0) ein Verweis auf ein Makro sein. Für den Abgleich von regulären Ausdrücken ohne Berücksichtigung der Groß- und Kleinschreibung fügen Sie einen booleschen Parameter namens ignore_case hinzu, der auf true gesetzt ist. Wenn kein Wert angegeben oder auf einen anderen Wert festgelegt ist, wird beim Abgleich zwischen Groß- und Kleinschreibung unterschieden. Um einen Operator zu negieren, fügen Sie den booleschen Parameter negate hinzu und setzen Sie ihn auf true.	Bearbeitbar
condition[].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
condition[].parameter[].list[]	list	Die Parameter dieses Listenparameters (Schlüssel werden ignoriert).	Bearbeitbar
condition[].parameter[].map[]	list	Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein).	Bearbeitbar
condition[].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
condition[].parameter[].value	string	Der Wert eines Parameters (kann Makroreferenzen wie "" enthalten) je nach Typ.	Bearbeitbar
condition[].type	string	Der Operatortyp für diese Bedingung. Zulässige Werte sind: "contains" "cssSelector" "endsWith" "equals" "greater" "greaterOrEquals" "less" "lessOrEquals" "matchRegex" "startsWith" "urlMatches"	Bearbeitbar
containerId	string	GTM-Container-ID
fingerprint	string	Der Fingerabdruck der GTM-Regel, der zum Speicherzeitpunkt berechnet wird. Dieser Wert wird bei jeder Änderung der Regel neu berechnet.
name	string	Anzeigename der Regel.	Bearbeitbar
notes	string	Nutzerhinweise zur Anwendung dieser Regel auf den Container.	Bearbeitbar
ruleId	string	Die Regel-ID identifiziert die GTM-Regel eindeutig.

Methoden

Mit den folgenden Methoden können Sie Regeln erstellen, ändern, löschen oder abrufen.

Erstellen

Eine GTM-Regel wird erstellt.

delete

Eine GTM-Regel wird gelöscht.

get

Ruft eine Go-to-Market-Regel ab.

list

Listet alle GTM-Regeln eines Containers auf.

Aktualisieren

Aktualisiert eine Google Tag Manager-Regel.