Tag Manager API – Parameterreferenz

In diesem Dokument werden der Zweck und die Darstellung von Tag Manager beschrieben. Parameter-Objekt enthält.

Einführung

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

Die meisten Tag- und Variablentypen haben zusätzliche Parameter, die speziell an das Tag oder die Variable und kann beim Erstellen/Aktualisieren der Ressource festgelegt werden. Die Liste von Parametern (key-, type-Paare) für jedes Tag und jede Variable sind in den das Tag-Wörterbuch Referenz.

Um diese Tag- oder Variablen-spezifischen Parameter zu konfigurieren, wird ein Parameter Objekt definiert und als Wert für parameter festgelegt. des Tags. oder Variable.

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 sollen.

Das Attribut type bestimmt, eine value-, list- oder map-Property muss wie in der Tabelle beschrieben im Parameterobjekt enthalten sein. unten.

Wenn beispielsweise type auf boolean gesetzt ist, dann ist ein Das Attribut value muss im Parameterobjekt enthalten und festgelegt sein. auf true oder false.

Wert	Zusätzliche Property, die eingeschlossen werden soll	Festlegen, auf welche Eigenschaft die zusätzliche Property festgelegt werden soll
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 kann/kann ist nicht wichtig; die key eines beliebigen Parameters im list werden ignoriert.
map	map	map enthält null oder mehr Parameter, die Reihenfolge nicht Matter; Das key für einen beliebigen Parameter im map sollte eindeutig sein.

key

Der Parameterschlüssel des Tags oder der Variablen, die konfiguriert werden sollen.

Das Feld key dient dazu, den Parameter eines bestimmten Tags oder Variablen, die festgelegt werden. Für alle Parametertypen ist ein key erforderlich Property mit Ausnahme von list-Parametern.

Beispiele

Ein Parameterobjekt für ein benutzerdefiniertes HTML-Tag mit einem template-Typparameter und zwei boolean-Typen Parameter:

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

Ein Parameterobjekt für einen Funktionsaufruf Tag mit einem template-Typparameter und einem map Typparameter:

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