Membuat Pemicu GTM. Coba sekarang.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/tagmanager/v2/+parent/triggers
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter jalur | ||
parent |
string |
Jalur relatif API Workspace GTM. Contoh: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id} |
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut:
Cakupan |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Untuk informasi selengkapnya, lihat halaman autentikasi dan otorisasi.
Isi permintaan
Dalam isi permintaan, sediakan resource Pemicu dengan properti berikut:
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
Properti yang Diperlukan | |||
autoEventFilter[].parameter[] |
list |
Daftar parameter bernama (kunci/nilai), bergantung pada jenis kondisi. Catatan:
|
dapat ditulis |
autoEventFilter[].parameter[].type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
autoEventFilter[].type |
string |
Jenis operator untuk kondisi ini.
Nilai yang dapat diterima adalah:
|
dapat ditulis |
checkValidation.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
continuousTimeMinMilliseconds.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
customEventFilter[].parameter[] |
list |
Daftar parameter bernama (kunci/nilai), bergantung pada jenis kondisi. Catatan:
|
dapat ditulis |
customEventFilter[].parameter[].type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
customEventFilter[].type |
string |
Jenis operator untuk kondisi ini.
Nilai yang dapat diterima adalah:
|
dapat ditulis |
eventName.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
filter[].parameter[] |
list |
Daftar parameter bernama (kunci/nilai), bergantung pada jenis kondisi. Catatan:
|
dapat ditulis |
filter[].parameter[].type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
filter[].type |
string |
Jenis operator untuk kondisi ini.
Nilai yang dapat diterima adalah:
|
dapat ditulis |
horizontalScrollPercentageList.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
interval.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
intervalSeconds.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
limit.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
maxTimerLengthSeconds.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
name |
string |
Nama tampilan pemicu. | dapat ditulis |
parameter[].type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
selector.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
totalTimeMinMilliseconds.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
type |
string |
Menentukan peristiwa lapisan data yang menyebabkan pemicu ini.
Nilai yang dapat diterima adalah:
|
dapat ditulis |
uniqueTriggerId.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
verticalScrollPercentageList.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
visibilitySelector.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
visiblePercentageMax.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
visiblePercentageMin.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
waitForTags.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
waitForTagsTimeout.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
Properti Opsional | |||
autoEventFilter[] |
list |
Digunakan dalam kasus pelacakan peristiwa otomatis. | dapat ditulis |
autoEventFilter[].parameter[].key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
autoEventFilter[].parameter[].list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
autoEventFilter[].parameter[].map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
autoEventFilter[].parameter[].value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
checkValidation |
nested object |
Apakah kami hanya akan mengaktifkan tag jika pengiriman formulir atau peristiwa klik link tidak dibatalkan oleh beberapa pengendali peristiwa lain (misalnya karena validasi). Hanya valid untuk pemicu Pengiriman Formulir dan Klik Link. | dapat ditulis |
checkValidation.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
checkValidation.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
checkValidation.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
checkValidation.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
continuousTimeMinMilliseconds |
nested object |
Visibilitas memicu waktu terlihat berkelanjutan minimum (dalam milidetik). Hanya valid untuk pemicu Visibilitas AMP. | dapat ditulis |
continuousTimeMinMilliseconds.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
continuousTimeMinMilliseconds.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
continuousTimeMinMilliseconds.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
continuousTimeMinMilliseconds.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
customEventFilter[] |
list |
Digunakan dalam kasus peristiwa kustom, yang diaktifkan jika semua Kondisi benar. | dapat ditulis |
customEventFilter[].parameter[].key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
customEventFilter[].parameter[].list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
customEventFilter[].parameter[].map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
customEventFilter[].parameter[].value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
eventName |
nested object |
Nama peristiwa GTM yang diaktifkan. Hanya valid untuk pemicu Timer. | dapat ditulis |
eventName.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
eventName.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
eventName.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
eventName.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
filter[] |
list |
Pemicu hanya akan diaktifkan jika semua Kondisi benar. | dapat ditulis |
filter[].parameter[].key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
filter[].parameter[].list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
filter[].parameter[].map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
filter[].parameter[].value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
horizontalScrollPercentageList |
nested object |
Daftar nilai persentase bilangan bulat untuk pemicu scroll. Pemicu akan diaktifkan saat setiap persentase tercapai saat tampilan di-scroll secara horizontal. Hanya valid untuk pemicu scroll AMP. | dapat ditulis |
horizontalScrollPercentageList.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
horizontalScrollPercentageList.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
horizontalScrollPercentageList.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
horizontalScrollPercentageList.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
interval |
nested object |
Waktu antara memicu Peristiwa Timer berulang (dalam milidetik). Hanya valid untuk pemicu Timer. | dapat ditulis |
interval.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
interval.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
interval.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
interval.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
intervalSeconds |
nested object |
Waktu antara Peristiwa Timer untuk memulai (dalam detik). Hanya valid untuk pemicu Timer AMP. | dapat ditulis |
intervalSeconds.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
intervalSeconds.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
intervalSeconds.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
intervalSeconds.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
limit |
nested object |
Batas jumlah peristiwa GTM yang akan diaktifkan Pemicu Timer ini. Jika tidak ada batas yang ditetapkan, kami akan terus mengaktifkan peristiwa GTM hingga pengguna meninggalkan halaman. Hanya valid untuk pemicu Timer. | dapat ditulis |
limit.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
limit.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
limit.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
limit.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
maxTimerLengthSeconds |
nested object |
Waktu maksimum untuk mengaktifkan Peristiwa Timer (dalam detik). Hanya valid untuk pemicu Timer AMP. | dapat ditulis |
maxTimerLengthSeconds.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
maxTimerLengthSeconds.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
maxTimerLengthSeconds.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
maxTimerLengthSeconds.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
notes |
string |
Catatan pengguna tentang cara menerapkan pemicu ini di penampung. | dapat ditulis |
parameter[] |
list |
Parameter tambahan. | dapat ditulis |
parameter[].key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
parameter[].list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
parameter[].map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
parameter[].value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
selector |
nested object |
Pemilih CSS pemicu klik (yaitu "a", "button", dll.). Hanya valid untuk pemicu Klik AMP. | dapat ditulis |
selector.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
selector.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
selector.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
selector.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
totalTimeMinMilliseconds |
nested object |
Total waktu terlihat minimum pemicu visibilitas (dalam milidetik). Hanya valid untuk pemicu Visibilitas AMP. | dapat ditulis |
totalTimeMinMilliseconds.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
totalTimeMinMilliseconds.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
totalTimeMinMilliseconds.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
totalTimeMinMilliseconds.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
uniqueTriggerId |
nested object |
ID pemicu unik global yang membuat ID ini secara otomatis (Pemroses Formulir, Klik Link, atau Pengatur Waktu) jika ada. Digunakan untuk membuat peristiwa otomatis yang tidak kompatibel berfungsi bersama dengan pemfilteran pemicu berdasarkan ID pemicu. Nilai ini diisi selama pembuatan output karena tag yang tersirat oleh pemicu tidak ada hingga saat itu. Hanya valid untuk pemicu Pengiriman Formulir, Klik Link, dan Timer. | dapat ditulis |
uniqueTriggerId.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
uniqueTriggerId.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
uniqueTriggerId.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
uniqueTriggerId.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
verticalScrollPercentageList |
nested object |
Daftar nilai persentase bilangan bulat untuk pemicu scroll. Pemicu akan diaktifkan saat setiap persentase tercapai saat tampilan di-scroll secara vertikal. Hanya valid untuk pemicu scroll AMP. | dapat ditulis |
verticalScrollPercentageList.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
verticalScrollPercentageList.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
verticalScrollPercentageList.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
verticalScrollPercentageList.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
visibilitySelector |
nested object |
Pemilih CSS pemicu visibilitas (yaitu "#id"). Hanya valid untuk pemicu Visibilitas AMP. | dapat ditulis |
visibilitySelector.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
visibilitySelector.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
visibilitySelector.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
visibilitySelector.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
visiblePercentageMax |
nested object |
Visibilitas memicu visibilitas persen maksimum. Hanya valid untuk pemicu Visibilitas AMP. | dapat ditulis |
visiblePercentageMax.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
visiblePercentageMax.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
visiblePercentageMax.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
visiblePercentageMax.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
visiblePercentageMin |
nested object |
Visibilitas memicu visibilitas persen minimum. Hanya valid untuk pemicu Visibilitas AMP. | dapat ditulis |
visiblePercentageMin.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
visiblePercentageMin.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
visiblePercentageMin.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
visiblePercentageMin.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
waitForTags |
nested object |
Apakah kami harus menunda pengiriman formulir atau membuka link hingga semua tag telah diaktifkan (dengan mencegah tindakan default dan kemudian menyimulasikan tindakan default tersebut). Hanya valid untuk pemicu Pengiriman Formulir dan Klik Link. | dapat ditulis |
waitForTags.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
waitForTags.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
waitForTags.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
waitForTags.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
waitForTagsTimeout |
nested object |
Waktu tunggu (dalam milidetik) hingga tag diaktifkan saat 'waits_for_tags' di atas bernilai true . Hanya valid untuk pemicu Pengiriman Formulir dan Klik Link. |
dapat ditulis |
waitForTagsTimeout.key |
string |
Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. | dapat ditulis |
waitForTagsTimeout.list[] |
list |
Parameter parameter daftar ini (kunci akan diabaikan). | dapat ditulis |
waitForTagsTimeout.map[] |
list |
Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). | dapat ditulis |
waitForTagsTimeout.value |
string |
Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. | dapat ditulis |
Respons
Jika berhasil, metode ini akan menampilkan Resource pemicu dalam isi respons.
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan melihat respons.