Etiket Yöneticisi API'si - Parametre Referansı

Bu belgede Etiket Yöneticisi'nin amacı ve temsili açıklanmaktadır. parametresi nesnesidir.

Giriş

Tag Manager API, Etiket Yöneticisi kaynaklarını oluşturmanıza ve yönetmenize olanak tanır. (ör. Etiketler, Tetikleyiciler ve Değişkenler)

Çoğu Etiket ve Değişken türünün ek parametreleri vardır. değerini belirleyebilir ve kaynağı oluştururken/güncellerken ayarlanabilir. Liste Her Etiket ve Değişken için parametre (key, type çift) aşağıda listelenen türleri Etiket Sözlüğü Referans.

Bu Etikete veya Değişkene özgü parametreleri yapılandırmak için, bir parametre nesne tanımlanır ve parameter için değer olarak ayarlanır Etiketin özelliği veya Değişken kaynağı.

Parametre nesnesi

Aşağıdaki nesne, bir parametre nesnesini temsil eder:

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

type

Yapılandırılan Etiket veya Değişkenin parametre türü.

type özelliği şunları belirler: value, list veya map mülkü olup olmadığı tabloda açıklandığı gibi parametre nesnesine eklenmesi gerekir bölümüne göz atın.

Örneğin, type boolean olarak ayarlanırsa bir value özelliği, parametre nesnesine dahil edilmeli ve true veya false adlı alıcıya.

Değer	Dahil edilecek ek mülk	Ek mülk ne olarak ayarlanır?
template	value	value, değişken referansları (ör. foo{{bar}}.
boolean	value	value, true veya false olur.
number	value	value, bir tam sayıdır.
list	list	list sıfır veya daha fazla parametre içerecek, sipariş şunu içerebilir/sıralama önemli değildir. list içindeki herhangi bir parametrenin key değeri yok sayılır.
map	map	map sıfır veya daha fazla parametre içerir, sıra içermez konu; map içindeki herhangi bir parametredeki key benzersiz olması gerekir.

key

Yapılandırılan Etiket veya Değişkenin parametre anahtarı.

key alanı, belirli bir öğenin parametresini tanımlamak için kullanılır. Ayarlanan Etiketler veya Değişkenler. Tüm parametre türleri için key gereklidir özelliği (list parametreler hariç).

Örnekler

Özel HTML Etiketi için parametre nesnesi Bu öğe, bir template türü parametresi ve iki boolean türüne sahip parametre:

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

İşlev Çağrısı için bir parametre nesnesi Etiket (bir template türü parametresi ve bir map) type parametresi:

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