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" } ]