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:
Kabul edilebilir değerler şunlardır:
|
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:
Kabul edilebilir değerler şunlardır:
|
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:
|
|
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.