Bu belgede, Etiket Yöneticisi parametre nesnesinin amacı ve temsili açıklanmaktadır.
Giriş
Tag Manager API; Etiketler, Tetikleyiciler ve Değişkenler gibi Etiket Yöneticisi kaynaklarını oluşturmanıza ve yönetmenize olanak tanır.
Çoğu Etiket ve Değişken türü, Etiket veya Değişken'e özel ek parametreler içerir ve kaynağı oluştururken/güncellerken ayarlanabilir. Her bir Etiket ve Değişken türüne ait parametre listesi (key
, type
çift) Etiket Sözlüğü Referansı'nda listelenmiştir.
Bu Etiket veya Değişkene özgü parametreleri yapılandırmak için bir parametre nesnesi tanımlanır ve Etiket ya da
Değişken kaynağının parameter
özelliğinin değeri olarak ayarlanır.
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 Etiketin veya Değişkenin parametre türü.
type
özelliği, aşağıdaki tabloda açıklandığı gibi bir value
, list
veya map
özelliğinin parametre nesnesine dahil edilmesi gerekip gerekmediğini belirler.
Örneğin, type
, boolean
olarak ayarlanırsa parametre nesnesine bir value
özelliği eklenmeli ve true
veya false
olarak ayarlanmalıdır.
Değer | Dahil edilecek ek özellik | Ek mülkün nasıl ayarlanacağı |
---|---|---|
template |
value |
value , değişken referansları dahil herhangi bir dizedir (ör. foo{{bar}} ). |
boolean |
value |
value , true veya false değerine sahip.
|
number |
value |
value bir tam sayıdır. |
list |
list |
list sıfır veya daha fazla parametre içerecek, sıra önemli olabilir veya olmayabilir; list içindeki herhangi bir parametrenin key yoksayılır. |
map |
map |
map sıfır veya daha fazla parametre içerecek, sıra önemli değildir; map içindeki herhangi bir parametredeki key benzersiz olmalıdır. |
key
Yapılandırılan Etiketin veya Değişkenin parametre anahtarı.
key
alanı, ayarlanan belirli Etiketlerin veya Değişkenlerin parametresini tanımlamak için kullanılır. Tüm parametre türlerinde bir key
özelliği gerekir (list
parametreleri hariç).
Örnekler
Bir template
türü parametresi ve iki boolean
türü parametreye sahip olan Özel HTML Etiketi için bir parametre nesnesi:
"parameter": [ { "key": "html", "type": "template", "value": "<script>alert('hello world')</script>" }, { "key": "supportDocumentWrite", "type": "boolean", "value": "false" } ]
Bir template
türü parametresi ve bir map
türü parametresi olan İşlev Çağrısı Etiketi için bir parametre nesnesi:
"parameter": [ { "key": "functionName", "type": "template", "value": "fn" }, { "key": "functionArgument", "map": [ { "key": "argkey1", "type": "template", "value": "argval1" } ], "type": "map" } ]