Buat variabel seluler 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:
- Di navigasi sebelah kiri, klik Variabel.
- Di bagian Variabel Buatan Pengguna, klik Baru.
- Klik Konfigurasi Variabel lalu pilih jenis variabel yang diinginkan.
- Masukkan opsi konfigurasi untuk jenis variabel yang dipilih.
- Beri nama variabel tersebut. Gunakan skema penamaan yang deskriptif dari fungsi variabel, misalnya "Variabel Lapisan Data - Nama Produk".
- Klik Simpan.
Tag Manager mendukung jenis variabel buatan pengguna ini untuk seluler:
Firebase
Nama Peristiwa
Nilai ditetapkan ke "eventNameXYZ" jika kode berikut di aplikasi Anda dieksekusi:
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];
Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Parameter Peristiwa:
Nilai ditetapkan ke nilai parameter peristiwa Google Analytics (Firebase) untuk kunci tertentu.
Properti Pengguna Firebase
Nilai ditetapkan ke nilai properti pengguna Google Analytics (Firebase) untuk kunci tertentu.
Utilitas
Pelacakan Pengiklan Diaktifkan
Untuk Android, variabel akan menghasilkan nilai true jika pelacakan iklan diaktifkan, atau false jika pengguna memilih untuk tidak ikut iklan menurut minat. Pelajari lebih lanjut di Pusat Developer Android. Versi SDK sebelum v4 akan selalu mengembalikan false. Untuk iOS versi 6 dan yang lebih baru, nilai ini ditetapkan ke properti advertisingTrackingEnabled. Selain dari itu, nilai ini ditetapkan ke true. Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Konstanta
Nilai ditetapkan ke string yang Anda tentukan.
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 yang kosong untuk menggambarkan cara data digunakan nanti):
| 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 aplikasi Anda disiapkan dengan cara yang sedemikian rupa sampai nilai yang sesuai (misalnya, ID tracking konversi) dapat dipetakan pada Kode Versi Aplikasi atau aspek lainnya dari aplikasi. Dalam contoh ini, variabel yang bernama ID Konversi dibuat. Jika Kode Versi Aplikasi 1.0, nilai ditetapkan ke "12345"; jika Kode Versi Aplikasi 1.1, nilai ditetapkan ke "34567". Tidak ada batasan pada jumlah baris di tabel pemeta. Kolom tabel peka terhadap huruf besar dan huruf kecil.
| Jika {{Kode Versi Aplikasi}} sama dengan | Tetapkan {{ID Konversi}} menjadi |
|---|---|
| 1,0 | 12345 |
| 1.1 | 34567 |
| 1.2 | 56789 |
Angka Acak
Nilai ditetapkan ke angka acak antara 0 sampai 2147483647. Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Data Penampung
ID Penampung
Nilainya adalah ID publik penampung (misalnya GTM-ABC42). Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Nomor Versi Penampung
Jika penampung berada dalam mode pratinjau, nilai variabel ini adalah nomor versi pratinjau penampung. Jika tidak, nilai variabel ini adalah nomor versi aktif penampung. Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Aplikasi
ID Aplikasi
Nilai ditetapkan ke nama paket (Android) atau ID aplikasi (iOS). Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Nama Aplikasi
Nilai ditetapkan ke nama aplikasi. Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Kode Versi Aplikasi
Nilai ditetapkan ke versi aplikasi yang sedang berjalan. Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
ID untuk Iklan
Untuk Android, nilai ditetapkan ke ID Iklan. Versi SDK sebelum v4 akan selalu menampilkan string kosong. Untuk iOS versi 6 dan versi lebih tinggi, nilai ditetapkan ke pengidentifikasi untuk iklan (IDFA). Untuk versi dibawahnya, nilai ditetapkan ke string kosong.
Versi SDK
Nilai ditetapkan ke versi SDK sistem operasi yang menginstal aplikasi. Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Perangkat
Nama Perangkat
Nilai ditetapkan ke nama perangkat dari aplikasi yang sedang berjalan (misalnya, "Samsung Android", "Pixel 2"). Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Bahasa
Nilai ditetapkan pada kode bahasa dua huruf yang mewakili bahasa perangkat yang ditetapkan pengguna. Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Versi Sistem Operasi
Nilai ditetapkan ke versi sistem operasi yang menginstal aplikasi. Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Platform
Nilai ditetapkan ke platform aplikasi yang sedang berjalan (misalnya, "Android", "iOS"). Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Resolusi Layar
Nilai ditetapkan ke resolusi layar perangkat dari aplikasi yang sedang berjalan. Formatnya adalah "lebar x tinggi", misalnya, "1920 x 1080". Dalam sebagian besar kasus, Anda harus menggunakan variabel built-in yang setara.
Lainnya
Panggilan fungsi
Nilai ditetapkan ke nilai yang dihasilkan dari panggilan ke fungsi yang didaftarkan sebelumnya. Untuk mempelajari lebih lanjut, lihat dokumentasi SDK Android atau iOS.
Kumpulan Nilai (hanya penampung lama)
Variabel ini berisi kumpulan pasangan kunci-nilai yang dinyatakan dalam format JSON. Anda menggunakan Kumpulan Nilai untuk menetapkan nilai konfigurasi bagi aplikasi Anda. Untuk aplikasi game balap mobil, misalnya, Anda mungkin mendefinisikan variabel "Setelan aplikasi" dari jenis Kumpulan Nilai dengan hal berikut:
{
"max-fuel": 200,
"starting-fuel": 100,
"fuel-burn-rate": 20
}
Aplikasi seluler Anda dapat mengambil nilai dalam variabel dengan memberikan kunci. Contoh:
public class MainActivity {
// Tambahkan ID penampung publik Anda.
private static final String CONTAINER_ID = "XXX-YYY";
// Kunci nilai konfigurasi penampung, digunakan nanti
// untuk mengambil nilai.
private static final String MAX_FUEL_KEY = "max-fuel";
private static final String INIT_FUEL_KEY = "init-fuel";
private static final String FUEL_BURN_KEY = "fuel-burn-rate";
// Sisa kode onCreate Anda.
}
}
/*
* Metode untuk memperbarui nilai konfigurasi game menggunakan
* penampung Google Pengelola Tag.
*/
public void updateConfigurationFromContainer(Container container) {
// Dapatkan referensi ke penampung.
Container container = mFutureContainer.get();
// Perbarui setelan game menggunakan
// kunci nilai konfigurasi Penampung.
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
Variabel Kumpulan Nilai memiliki pemicu yang berkaitan dengannya. Untuk nilai konfigurasi yang berlaku bagi semua instance dan versi aplikasi Anda, tetapkan pemicu pengaktifan ke nilai standar "Selalu". Baca dokumentasi developer (Android atau iOS) untuk mengetahui detail tentang cara menggunakan variabel Kumpulan Nilai.