Tags

Kapsayıcıyla ilişkilendirilen etiketler. Etiketler genellikle bir veya daha fazla tetikleme kuralıyla (aşağıdaki firingRuleId bölümüne bakın) ve isteğe bağlı olarak bir veya daha fazla engelleme kuralıyla ilişkilendirilir (aşağıdaki blockingRuleId bölümüne bakın). En az bir tetikleme kuralı doğru, tam olarak sıfır engelleme kuralı da doğru şeklinde değerlendirilirse etiket tetiklenir (yürütülür). Hangi etiketlerin diğerlerinden önce tetikleneceğini ayarlamak için isteğe bağlı priority özelliğini kullanın. Bu etiket tetiklenmeden önce başka hangi etiketlerin tetiklenmesi ve tamamlanması gerektiğini belirtmek için dependencies özelliğini kullanın. Google Etiket Yöneticisi etiketleri için ayarlanabilecek parametrelerle ilgili ayrıntılar için Etiket Sözlüğü Referansı'na bakın.

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

Kaynak temsilleri

Google Etiket Yöneticisi etiketini temsil eder.

{
  "accountId": string,
  "containerId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ]
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "fingerprint": string,
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "paused": boolean
}
Mülk adı Değer Açıklama Notlar
accountId string GTM Hesap Kimliği.
blockingRuleId[] list Engelleme kuralı kimlikleri. Listelenen kurallardan herhangi biri doğru olarak değerlendirilirse etiket etkinleşmez. yazılabilir
blockingTriggerId[] list Tetikleyici kimlikleri engelleniyor. Listelenen tetikleyicilerden biri doğru olarak değerlendirilirse etiket etkinleşmez. yazılabilir
containerId string GTM Kapsayıcı Kimliği.
fingerprint string GTM Etiketinin depolama zamanında hesaplanan parmak izi. Bu değer, etiket her değiştirildiğinde yeniden hesaplanır.
firingRuleId[] list Tetikleme kuralı kimlikleri. Listelenen kurallardan herhangi biri doğru ve tüm blockingRuleIds (belirtilmişse) yanlış olduğunda etiket etkinleşir. yazılabilir
firingTriggerId[] list Tetikleyen tetikleyici kimlikleri. Listelenen tetikleyicilerden herhangi biri doğru ve blockingTriggerIds değerinin tamamı (belirtildiyse) yanlış olduğunda etiket tetiklenir. yazılabilir
liveOnly boolean Doğru değerine ayarlanırsa bu etiket yalnızca canlı ortamda tetiklenir (ör. önizleme veya hata ayıklama modunda tetiklenmez). yazılabilir
name string Etiketin görünen adı. yazılabilir
notes string Bu etiketin kapsayıcıya nasıl uygulanacağıyla ilgili kullanıcı notları. yazılabilir
parameter[] list Etiketin 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; değişken referanslar (dize olmayan türler döndürebilen değişken referansları bile) içerebilir.
  • trigger_reference: Değer, bir tetikleyiciyi temsil eder ve tetikleyici kimliği olarak temsil edilir


Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
yazılabilir
parameter[].value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. yazılabilir
parentFolderId string Üst klasör kimliği.
paused boolean Etiket duraklatılmışsa doğru değerini alır. yazılabilir
priority nested object Etiketin kullanıcı tanımlı sayısal önceliği. Etiketler, öncelik sırasına göre eşzamansız olarak tetiklenir. Daha yüksek sayısal değere sahip etiketler önce tetiklenir. Bir etiketin önceliği pozitif veya negatif bir değer olabilir. Varsayılan değer 0'dır. yazılabilir
priority.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
priority.list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
priority.map[] list Bu eşleme parametresinin parametreleri (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
priority.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; değişken referanslar (dize olmayan türler döndürebilen değişken referansları bile) içerebilir.
  • trigger_reference: Değer, bir tetikleyiciyi temsil eder ve tetikleyici kimliği olarak temsil edilir


Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
yazılabilir
priority.value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. yazılabilir
scheduleEndMs long Bir etiketin planlanacağı bitiş zaman damgası (milisaniye cinsinden). yazılabilir
scheduleStartMs long Bir etiketin planlanacağı başlangıç zaman damgası (milisaniye cinsinden). yazılabilir
setupTag[] list Kurulum etiketlerinin listesi. Şu anda yalnızca bir tanesine izin veriyoruz.
setupTag[].stopOnSetupFailure boolean Doğru ise, yalnızca kurulum etiketi başarıyla tetiklendiğinde ana etiketi tetikleyin. Yanlış değerine ayarlanırsa kurulum etiketi etkinleşme durumundan bağımsız olarak ana etiketi tetikle.
setupTag[].tagName string Kurulum etiketinin adı.
tagFiringOption string Bu etiketi etkinleştirme seçeneği.

Kabul edilebilir değerler şunlardır:
  • "oncePerEvent"
  • "oncePerLoad"
  • "unlimited"
tagId string Etiket Kimliği, GTM Etiketini benzersiz bir şekilde tanımlar.
teardownTag[] list Söküm etiketlerinin listesi. Şu anda yalnızca bir tanesine izin veriyoruz.
teardownTag[].stopTeardownOnFailure boolean Doğru ise, söküm etiketini yalnızca ana etiket başarıyla tetiklendiğinde tetikleyin. Yanlış değerine ayarlanırsa söküm etiketini, ana etiket etkinleşme durumundan bağımsız olarak tetikle.
teardownTag[].tagName string Söküm etiketinin adı.
type string GTM Etiket Türü. yazılabilir

Yöntemler

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

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