Tags

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.

{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  ],
  "fingerprint": string,
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "tagManagerUrl": string,
  "paused": boolean,
  "monitoringMetadata": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "monitoringMetadataTagNameKey": string,
  "consentSettings": {
    "consentStatus": string,
    "consentType": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": 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
consentSettings nested object Bir etiketin izin ayarları. yazılabilir
consentSettings.consentStatus string Etiketin izin durumu. GEREKLİ olarak ayarlanırsa çalışma zamanı, consent_type alanı tarafından belirtilen izin türlerinin verilip verilmediğini kontrol eder.

Kabul edilebilir değerler şunlardır:
  • "needed"
  • "notNeeded"
  • "notSet"
consentSettings.consentType nested object İzin GEREKLİ durumundayken etiket etkinleşmesi sırasında kontrol edilecek izin türü. Bu parametre LIST türünde olmalıdır; burada her liste öğesi STRING türünde olmalıdır.
consentSettings.consentType.isWeakReference boolean Bir referans türü parametresine kesinlikle veya zayıf bir şekilde başvurulup başvurulmadığı. Yalnızca Dönüşümler tarafından kullanılır. yazılabilir
consentSettings.consentType.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
consentSettings.consentType.list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
consentSettings.consentType.map[] list Bu eşleme parametresinin parametreleri (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
consentSettings.consentType.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
  • tag_reference: Değer, etiket adı olarak temsil edilen bir etiketi temsil eder


Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
yazılabilir
consentSettings.consentType.value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. 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
monitoringMetadata nested object Etiket izleme için etkinlik verilerine dahil edilecek etiket meta verilerinin anahtar/değer çiftlerinin eşlemesi. Notlar:
  • Bu parametrenin türü MAP olmalıdır.
  • Haritadaki her parametrenin türü TEMPLATE olsa da değişken referansları içeremez.
yazılabilir
monitoringMetadata.isWeakReference boolean Bir referans türü parametresine kesinlikle veya zayıf bir şekilde başvurulup başvurulmadığı. Yalnızca Dönüşümler tarafından kullanılır. yazılabilir
monitoringMetadata.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
monitoringMetadata.list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
monitoringMetadata.map[] list Bu eşleme parametresinin parametreleri (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
monitoringMetadata.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
  • tag_reference: Değer, etiket adı olarak temsil edilen bir etiketi temsil eder


Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
yazılabilir
monitoringMetadata.value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. yazılabilir
monitoringMetadataTagNameKey string Boş değilse etiketin görünen adı, belirtilen anahtar kullanılarak izleme meta veri haritasına eklenir. 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[].isWeakReference boolean Bir referans türü parametresine kesinlikle veya zayıf bir şekilde başvurulup başvurulmadığı. Yalnızca Dönüşümler tarafından kullanılır. 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
  • tag_reference: Değer, etiket adı olarak temsil edilen bir etiketi temsil eder


Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
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.
path string GTM Etiketi'nin API göreli yolu.
paused boolean Etiketin duraklatılıp duraklatılmadığını belirtir. Bu durum, etiketin etkinleşmesini engeller. 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.isWeakReference boolean Bir referans türü parametresine kesinlikle veya zayıf bir şekilde başvurulup başvurulmadığı. Yalnızca Dönüşümler tarafından kullanılı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
  • tag_reference: Değer, etiket adı olarak temsil edilen bir etiketi temsil eder


Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
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"
  • "tagFiringOptionUnspecified"
  • "unlimited"
tagId string Etiket Kimliği, GTM Etiketini benzersiz bir şekilde tanımlar.
tagManagerUrl string Etiket yöneticisi kullanıcı arayüzü için otomatik olarak oluşturulan bağlantı
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
workspaceId string GTM Çalışma Alanı Kimliği.

Yöntemler

oluştur
GTM Etiketi oluşturur.
sil
Bir GTM Etiketi'ni siler.
al
GTM etiketi alır.
list
Bir Kapsayıcının tüm GTM Etiketlerini listeler.
revert
Bir GTM çalışma alanındaki GTM etiketindeki değişiklikleri geri alır.
güncelleme
GTM etiketini günceller.