Jenis variabel buatan pengguna untuk web

Buat variabel web kustom buatan pengguna di Google Tag Manager agar sesuai dengan persyaratan spesifik yang mungkin belum tercakup oleh variabel built-in.

Untuk membuat variabel buatan pengguna yang baru:

1. Di navigasi sebelah kiri, klik Variabel.
2. Di bagian Variabel Buatan Pengguna, klik Baru.
3. Klik Konfigurasi Variabel lalu pilih jenis variabel yang diinginkan.
4. Masukkan opsi konfigurasi untuk jenis variabel yang dipilih.
5. Beri nama variabel tersebut. Gunakan skema penamaan yang deskriptif dari fungsi variabel, misalnya "Variabel Lapisan Data - Nama Produk".
6. Klik Simpan.

Tag Manager mendukung jenis variabel buatan pengguna ini untuk web:

• Navigasi
  • Perujuk HTTP
  • URL
• Variabel halaman
  • Cookie pihak pertama
  • JavaScript Kustom
  • Lapisan data
• Elemen halaman
  • Variabel peristiwa otomatis
  • Elemen DOM
  • Visibilitas elemen
• Utilitas
  • Konstanta
  • Peristiwa kustom
  • Nama lingkungan
  • Setelan Google Analytics
  • Tabel pemeta
  • Angka acak
  • Tabel RegEx
• Data penampung
  • ID Penampung
  • Nomor versi penampung
  • Mode debug

Navigasi

Perujuk HTTP

Nilai ditetapkan ke perujuk HTTP, yang merupakan URL halaman sebelumnya yang dikunjungi seseorang. Misalnya, jika seseorang membuka salah satu halaman produk Anda dari halaman beranda, perujuknya adalah halaman beranda. Instance jenis variabel ini dibuat secara otomatis oleh Tag Manager, namun Anda dapat membuat instance tambahan jika ingin menampilkan bagian URL perujuk yang berbeda.

URL

Jenis variabel ini memungkinkan Anda untuk mengurai dan menampilkan komponen URL. Tag Manager secara otomatis membuat tiga instance dari jenis variabel ini (url lengkap, hostname, dan jalur). Anda dapat membuat instance tambahan untuk menampilkan berbagai bagian URL. Komponen URL yang dapat Anda pilih adalah: Protokol, Hostname, Port, Jalur, Kueri, Fragmen, dan Ekstensi File. Kumpulan nilai masukan untuk variabel jenis ini adalah URL halaman yang sedang dilihat oleh pengguna (diambil dari document.location). Sesuaikan Sumber URL untuk menginformasikan Tag Manager agar menggunakan variabel lain sebagai sumber nilai URL.

Variabel halaman

Cookie pihak pertama

Nilai ini ditetapkan ke nilai cookie pihak pertama dengan nama domain yang saat ini digunakan oleh pengguna. Jika lebih dari satu cookie dengan nama yang sama diterapkan pada domain yang sama, nilai pertama akan dipilih. Nilai ini sama dengan jika Anda telah memanggil document.cookie dari dalam halaman dan memilih hasil pertama.

JavaScript Kustom

Nilai ditetapkan ke hasil fungsi JavaScript. JavaScript harus berbentuk fungsi anonim yang menghasilkan nilai. Misalnya, variabel JavaScript kustom dapat dibuat untuk mengubah semua instance dari variabel {{url}} standar menjadi huruf kecil:

function () {
  return {{url}}.toLowerCase();
}

Lapisan data

Nilai ditetapkan saat data didorong ke lapisan data melalui panggilan dataLayer.push():
dataLayer.push({'Nama Lapisan Data': 'nilai'}).

Anda dapat menentukan bagaimana Tag Manager menafsirkan titik ('.') di nama kunci:

• Versi 1: izinkan titik pada nama kunci. Misalnya, untuk dataLayer.push('a.b.c': 'nilai'), menafsirkan nama kunci sebagai "a.b.c" (yaitu, {'a.b.c': 'nilai'}).
• Versi 2: tafsirkan titik sebagai nilai berlapis. Misalnya, tafsirkan dataLayer.push({'a.b.c': 'nilai'}) sebagai tiga tingkat berlapis: {a: {b: {c: 'nilai'}}}.

Variabel JavaScript

Nilai ditetapkan ke variabel JavaScript global yang Anda tentukan. Jika nilai yang diperlukan tidak disiapkan di lapisan data (lihat variabel Lapisan Data), dan tidak terlihat di DOM (lihat juga: variabel Elemen DOM), nilai tersebut dapat diperoleh dari variabel JavaScript. Gunakan jenis variabel ini jika Anda dapat menemukan nilai di kode sumber halaman sebagai variabel JavaScript global.

Elemen halaman

Variabel peristiwa otomatis

Menangkap informasi tentang item yang memicu peristiwa (misalnya klik, pengiriman formulir, visibilitas elemen, dll.)

• Elemen: Menghasilkan objek elemen. Dapat diperlakukan seperti objek untuk JavaScript kustom, misalnya {{Element}}.title, atau di pemilih CSS, misalnya {{Element}} cocok dengan Pemilih CSS div.foo.
• Jenis Elemen: Menghasilkan nilai element.tagName., misalnya 'A', 'BUTTON', 'IMG'
• Atribut Elemen: Menentukan nama atribut dan opsi ini akan menghasilkan nilai atribut tersebut.
• Kelas Elemen: Menghasilkan daftar kelas yang ditemukan di atribut class elemen.
• ID Elemen: Menghasilkan nilai atribut id.
• Target Elemen: Menghasilkan nilai atribut target, misalnya '_blank'.
• Teks Elemen: Menghasilkan nilai konten teks elemen.
• URL Elemen: Menghasilkan URL elemen, yang dikumpulkan dari atribut href atau action.
• Fragmen URL Baru Histori: Menghasilkan fragmen URL baru dari histori browser, misalnya '#summary'.
• Fragmen URL Lama Histori: Menghasilkan fragmen URL lama dari histori browser, misalnya '#intro'.
• Status Baru Histori: Objek status histori baru, dikontrol oleh panggilan situs ke pushState.
• Status Lama Histori: Objek status histori lama, dikontrol oleh panggilan situs ke pushState.
• Sumber Perubahan Histori: Menghasilkan peristiwa yang menyebabkan perubahan histori, misalnya 'pushState', 'replaceState', dll.

Elemen DOM

Nilai ditetapkan ke teks elemen DOM (Model Objek Dokumen) atau nilai atribut elemen DOM yang ditentukan. Jika nilai yang diperlukan tidak disiapkan di lapisan data (lihat variabel Lapisan Data), nilai tersebut kemungkinan dapat diambil dari DOM. Gunakan jenis variabel ini jika Anda dapat menemukan nilai di DOM.

Jika nama atribut opsional telah ditetapkan, nilai variabel akan menghasilkan nilai yang ditentukan dari atribut tersebut (misalnya data-food="cupcake"); jika tidak, nilai akan menjadi teks dalam elemen DOM.

Visibilitas Elemen

Nilai ditetapkan berdasarkan status terlihat dari elemen DOM yang ditentukan. Tidak seperti pemicu Visibilitas Elemen, satu variabel Visibilitas Elemen hanya dapat melaporkan visibilitas satu elemen. Pilih apakah Anda akan memilih elemen berdasarkan ID elemen atau Pemilih CSS. Jika beberapa elemen dicocokkan dengan Pemilih CSS yang ditentukan, elemen pertama yang cocok akan digunakan.

Anda dapat memilih jenis output untuk variabel ini:

• True/False: Nilai boolean yang menunjukkan apakah elemen yang dipilih terlihat saat variabel direferensikan. 
• Persen: Nilai persentase antara 0 dan 100 yang menunjukkan persentase bagian elemen yang dipilih terlihat di layar saat variabel direferensikan.

Jika memilih True/False sebagai jenis output, Anda juga dapat menentukan Persentase Terlihat Minimum untuk menentukan persentase bagian elemen terpilih yang harus terlihat di layar untuk variabel agar menghasilkan true.

Utilitas

Konstanta

Nilai ditetapkan pada string yang Anda berikan. Variabel string konstan biasanya digunakan saat beberapa tag mungkin memanfaatkan nomor akun yang sama. Lihat juga: Setelan Google Analytics.

Peristiwa Kustom

Nilai ditetapkan ke nama peristiwa kustom yang didorong ke lapisan data.

Nama Lingkungan

Menghasilkan nama lingkungan yang dilihat dalam mode pratinjau.

Setelan Google Analytics

Variabel Setelan Google Analytics digunakan pada tag Universal Analytics dalam penampung web dan seluler (Firebase) untuk secara terpusat mengonfigurasi dan membagikan setelan Google Analytics umum yang digunakan di beberapa tag. Saat Anda membuat tag Google Analytics menggunakan Universal Analytics, Tag Manager akan meminta Anda untuk memilih atau membuat variabel Setelan Google Analytics. Pelajari lebih lanjut.

Tabel Pemeta

Nilai ditetapkan sesuai dengan petunjuk di tabel pemeta. Tabel pemeta berisi dua kolom: (Tabel kosong untuk menggambarkan bagaimana data digunakan nantinya):

Jika [variabel yang dipilih] sama dengan	Tetapkan [variabel ini] menjadi

Jenis Tabel Pemeta memungkinkan Anda membuat variabel yang nilainya bervariasi sesuai dengan nilai di variabel lain. Ini berguna jika situs disiapkan dengan cara yang sedemikian rupa sampai nilai yang sesuai (misalnya, ID konversi) dapat dipetakan pada URL, elemen DOM, atau bagian lain halaman. Dalam contoh ini, variabel yang bernama ID Konversi dibuat. Jika URL-nya berisi "/thanks/buy1.html", nilainya ditetapkan ke "12345"; jika URL-nya berisi "thanks/buy2.html", nilainya ditetapkan ke "34567".

Jika {{url}} berisi	Tetapkan {{ID Konversi}} menjadi
/thanks/buy1.html	12345
/thanks/buy2.html	34567
/thanks/buy3.html	56789

Angka acak

Nilai ditetapkan ke angka acak antara 0 sampai 2147483647.

Tabel RegEx

Variabel Tabel RegEx Table mirip dengan variabel Tabel Pemeta, dengan penambahan kemampuan untuk menjalankan pola ekspresi reguler untuk item yang ingin Anda cocokkan.

Untuk konfigurasi Tabel RegEx ini:

Pola	Output
.*/page[1-3]\.html.*	foo
.*/page[4-6]\.html.*	Bar
.*/page[7-9]\.html.*	baz

Nilai output variabel adalah sebagai berikut:

Hasil yang sesuai	Nilai
http://example.com/page1.html	foo
http://www.example.com/page1.html	foo
http://example.com/page2.html#detail	foo
http://example.com/page5.html	bar
http://example.com/page5.html?status=new	bar
http://example.com/page6.html	bar
https://example.com/page9.html	baz

Pencarian Tabel RegEx dijalankan dari atas daftar ke bawah. Jika ditemukan kecocokan, nilai output yang sesuai akan ditampilkan.

Pilih Tetapkan Nilai Default untuk menetapkan nilai output saat tidak ditemukan kecocokan.

Secara default, pola harus cocok dengan string input lengkap dan tidak peka huruf besar/kecil. Perilaku ini dapat disesuaikan di Setelan Lanjutan:

• Abaikan Kapitalisasi: Pola akan mencocokkan dengan huruf besar dan huruf kecil tanpa harus menjadikannya ekspresi reguler secara eksplisit.

• Pencocokan Lengkap Saja: Jika diaktifkan, pola harus cocok dengan keseluruhan input. Ini sama dengan menggunakan tanda (^) di awal dan ($) di akhir pola secara implisit. Jika dinonaktifkan, pola akan bernilai cocok saat ditemukan di mana pun pada input.

• Aktifkan Grup Tangkapan dan Fungsi Penggantian: Jika diaktifkan, Anda dapat menggunakan sintaks pengganti simbol dolar untuk menyertakan bagian input (misalnya, dari grup tangkapan pada pola yang cocok) pada output. Misalnya, jika ekspresi reguler yang cocok adalah /(news)/page(2)\.html, Anda dapat menggunakan $1 untuk mereferensikan grup tangkapan pertama ("news") dan $2 untuk mereferensikan grup tangkapan kedua ("2").

Penggunaan "Akftifkan Grup Tangkapan dan Fungsi Penggantian" dengan "Pencocokan Lengkap Saja" yang dinonaktifkan dapat menyebabkan perilaku tidak terduga (misalnya, seluruh nilai input mungkin saja ditampilkan dengan bagian yang dicocokkan diganti.)

Data Penampung

ID Penampung

Menghasilkan ID penampung Tag Manager, misalnya 'GTM-101010'.

Nomor Versi Penampung

Jika penampung ada di mode pratinjau, variabel versi penampung akan menghasilkan nomor versi pratinjau penampung. Jika tidak, variabel ini akan menghasilkan nomor versi penampung yang berlaku.

Mode Debug

Nilai ditetapkan ke true jika penampung berada dalam mode pratinjau dan debug, dan false jika tidak.