Rules

Aturan penampung. Aturan dievaluasi ke benar (true) atau salah (false) selama runtime. Makro ini dapat digunakan untuk mengontrol kapan tag diaktifkan atau diblokir agar tidak diaktifkan, dan untuk mengontrol kapan makro di penampung seluler diaktifkan atau dinonaktifkan. Untuk detail selengkapnya, lihat aturan pengaktifan dan penonaktifan konfigurasi tag serta aturan pengaktifan dan penonaktifan konfigurasi makro.

Untuk daftar metode resource ini, lihat bagian akhir halaman ini.

Representasi resource

Mewakili aturan Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "ruleId": string,
  "name": string,
  "notes": string,
  "condition": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ]
    }
  ],
  "fingerprint": string
}
Nama properti Nilai Deskripsi Catatan
accountId string ID Akun GTM.
condition[] list Daftar kondisi yang membentuk aturan ini (DAN implisit di antara keduanya). dapat ditulis
condition[].parameter[] list Daftar parameter bernama (kunci/nilai), bergantung pada jenis kondisi. Catatan:
  • Untuk operator biner, sertakan parameter bernama arg0 dan arg1 untuk menentukan operand kiri dan kanan.
  • Pada saat ini, operand kiri (arg0) harus menjadi referensi ke makro.
  • Untuk pencocokan Ekspresi Reguler yang tidak peka huruf besar/kecil, sertakan parameter boolean bernama ignore_case yang disetel ke true. Jika tidak ditentukan atau ditetapkan ke nilai lain, pencocokan akan peka huruf besar/kecil.
  • Untuk menegasikan operator, sertakan parameter Boolean bernama negate dan tetapkan ke true.
dapat ditulis
condition[].parameter[].key string Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. dapat ditulis
condition[].parameter[].list[] list Parameter parameter daftar ini (kunci akan diabaikan). dapat ditulis
condition[].parameter[].map[] list Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). dapat ditulis
condition[].parameter[].type string Jenis parameter. Nilai yang valid adalah:
  • boolean: Nilai mewakili boolean, yang diwakili sebagai 'true' atau 'false'
  • integer: Nilai mewakili nilai bilangan bulat dengan tanda tangan 64-bit, di basis 10
  • list: Daftar parameter harus ditentukan
  • map: Peta parameter harus ditentukan
  • template: Nilai mewakili teks apa pun; nilai ini dapat mencakup referensi makro (bahkan referensi makro yang mungkin menampilkan jenis non-string)


Nilai yang dapat diterima:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
dapat ditulis
condition[].parameter[].value string Nilai parameter (dapat berisi referensi makro seperti "") yang sesuai dengan jenis yang ditentukan. dapat ditulis
condition[].type string Jenis operator untuk kondisi ini.

Nilai yang dapat diterima adalah:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
dapat ditulis
containerId string ID Penampung GTM.
fingerprint string Sidik jari Aturan GTM seperti yang dihitung pada waktu penyimpanan. Nilai ini dihitung ulang setiap kali aturan diubah.
name string Nama tampilan aturan. dapat ditulis
notes string Catatan pengguna tentang cara menerapkan aturan ini di penampung. dapat ditulis
ruleId string ID Aturan secara unik mengidentifikasi Aturan GTM.

Metode

Gunakan metode di bawah untuk membuat, mengubah, menghapus, atau mengambil aturan.

buat
Membuat aturan GTM.
hapus
Menghapus aturan GTM.
dapatkan
Mendapatkan aturan GTM.
list
Mencantumkan semua aturan GTM penampung.
pembaruan
Memperbarui aturan GTM.