Tag Manager API – Parameterreferenz

In diesem Dokument werden Zweck und Darstellung des Tag Manager-Parameterobjekts beschrieben.

Einführung

Mit der Tag Manager API können Sie Tag Manager-Ressourcen wie Tags, Trigger und Variablen erstellen und verwalten.

Die meisten Tag- und Variablentypen haben zusätzliche Parameter, die für das Tag oder die Variable spezifisch sind und beim Erstellen/Aktualisieren der Ressource festgelegt werden können. Die Liste der Parameter (key- und type-Paare) für jeden Tag- und Variablentyp ist in der Tag-Wörterbuch-Referenz aufgeführt.

Zum Konfigurieren dieser Tag- oder Variablen-spezifischen Parameter wird ein Parameterobjekt definiert und als Wert für das Attribut parameter der Tag- oder Variable-Ressource festgelegt.

Parameterobjekt

Das folgende Objekt stellt ein Parameterobjekt dar:

[
  {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ]
  }
]

type

Der Parametertyp des Tags oder der Variablen, die konfiguriert werden soll.

Das Attribut type bestimmt, ob das Attribut value, list oder map im Parameterobjekt enthalten sein muss. Dies wird in der folgenden Tabelle beschrieben.

Wenn beispielsweise type auf boolean gesetzt ist, sollte das Parameterobjekt ein value-Attribut enthalten und auf true oder false gesetzt sein.

Wert	Weitere hinzuzufügende Property	Zusätzliche Property festlegen
template	value	value ist ein beliebiger String, einschließlich Variablenverweisen, z.B. foo{{bar}}.
boolean	value	value ist entweder true oder false.
number	value	value ist eine Ganzzahl.
list	list	list enthält null oder mehr Parameter. Die Reihenfolge spielt dabei keine Rolle. Der key eines Parameters im list wird ignoriert.
map	map	map enthält null oder mehr Parameter, die Reihenfolge ist unerheblich. Der key-Wert eines Parameters im map muss eindeutig sein.

key

Der Parameterschlüssel des Tags oder der Variablen, die bzw. die konfiguriert wird.

Mit dem Feld key werden die Parameter bestimmter Tags oder Variablen identifiziert, die festgelegt werden. Alle Parametertypen benötigen ein key-Attribut (außer list-Parameter).

Beispiele

Ein Parameterobjekt für ein benutzerdefiniertes HTML-Tag, das einen Parameter vom Typ template und zwei Parameter vom Typ boolean enthält:

"parameter": [
  {
    "key": "html",
    "type": "template",
    "value": "<script>alert('hello world')</script>"
  },
  {
    "key": "supportDocumentWrite",
    "type": "boolean",
    "value": "false"
  }
]

Ein Parameterobjekt für ein Funktionsaufruf-Tag, das einen Parameter vom Typ template und einen Parameter vom Typ map hat:

"parameter": [
  {
    "key": "functionName",
    "type": "template",
    "value": "fn"
  },
  {
    "key": "functionArgument",
    "map": [
      {
        "key": "argkey1",
        "type": "template",
        "value": "argval1"
      }
    ],
    "type": "map"
  }
]