Macros

Kapsayıcının makroları. Makrolar, çalışma zamanında değerlendirilen değerleri temsil eder. Kuralları ve etiketleri yapılandırırken makrolara başvurabilirsiniz. Google Etiket Yöneticisi makroları için ayarlanabilecek özelliklerle ilgili ayrıntılar için Makro Sözlük Referansı'nı inceleyin. Kullanıcıların makroları nasıl oluşturduğu ve kullandığı hakkında bilgi edinmek için Google Etiket Yöneticisi Yardım Merkezi'ndeki Makrolar başlıklı makaleyi inceleyin.

Bu kaynağa ilişkin yöntemlerin listesi için bu sayfanın sonuna göz atın.

Kaynak temsilleri

Bir Google Etiket Yöneticisi makrosunu temsil eder.

{
  "accountId": string,
  "containerId": string,
  "macroId": string,
  "name": string,
  "type": string,
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "enablingRuleId": [
    string
  ],
  "disablingRuleId": [
    string
  ],
  "fingerprint": string,
  "parentFolderId": string
}
Mülk adı Değer Açıklama Notlar
accountId string GTM Hesap Kimliği.
containerId string GTM Kapsayıcı Kimliği.
disablingRuleId[] list Yalnızca mobil kapsayıcılar için: Koşullu makroları devre dışı bırakmak için kural kimliklerinin listesi. Makro, etkinleştiren kurallardan biri doğruysa, devre dışı bırakan tüm kurallar yanlışsa makro etkinleştirilir. Sıralanmamış bir grup olarak ele alındı. yazılabilir
enablingRuleId[] list Yalnızca mobil kapsayıcılar için: Koşullu makroları etkinleştirmek için kural kimliklerinin listesi. Etkinleştiren kurallardan biri doğru, devre dışı bırakan tüm kurallar yanlış ise makro etkinleştirilir. Sıralanmamış bir grup olarak ele alındı. yazılabilir
fingerprint string GTM Makrosunun depolama zamanında hesaplanan parmak izi. Makro her değiştirildiğinde bu değer yeniden hesaplanır.
macroId string Makro Kimliği, Google Etiket Yöneticisi Makrosunu benzersiz bir şekilde tanımlar.
name string Makronun görünen adı. yazılabilir
notes string Bu makronun kapsayıcıya nasıl uygulanacağına ilişkin kullanıcı notları. yazılabilir
parameter[] list Makronun parametreleri. yazılabilir
parameter[].key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Harita değerleri ve üst düzey parametreler için gereklidir. Liste değerleri için yoksayılır. yazılabilir
parameter[].list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
parameter[].map[] list Bu eşleme parametresinin parametreleri (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
parameter[].type string Parametre türü. Geçerli değerler şunlardır:
  • boolean: Değer, "true" veya "false" olarak temsil edilen bir boole'yi temsil eder
  • integer: Değer, 10 tabanında 64 bit imzalı bir tam sayı değerini temsil eder
  • list: Parametre listesi belirtilmelidir
  • map: Bir parametre eşlemesi belirtilmelidir
  • template: Değer herhangi bir metni temsil eder. Bu, makro referanslarını (dize olmayan türler döndürebilen makro referanslarını bile) içerebilir.


Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
yazılabilir
parameter[].value string Bir parametrenin değeri (belirtilen türe uygun olduğu şekilde, "" gibi makro referansları içerebilir). yazılabilir
parentFolderId string Üst klasör kimliği.
scheduleEndMs long Bir makroyu programlamak için milisaniye cinsinden bitiş zaman damgası. yazılabilir
scheduleStartMs long Bir makroyu programlamak için milisaniye cinsinden başlangıç zaman damgası. yazılabilir
type string Google Etiket Yöneticisi Makro Türü. yazılabilir

Yöntemler

Makro oluşturmak, değiştirmek, silmek veya almak için aşağıdaki yöntemleri kullanın.

oluştur
GTM makrosu oluşturur.
sil
GTM makrosu siler.
al
GTM makrosu alır.
list
Bir kapsayıcının tüm GTM makrolarını listeler.
güncelleme
GTM makrosu günceller.