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:
- Buka penampung Tag Manager yang ingin Anda edit.
- Di tab Ruang kerja pada navigasi 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 menjelaskan 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 bawaan 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 oleh Pengiklan Diaktifkan
Untuk Android, variabel akan menghasilkan nilai true jika pelacakan iklan diaktifkan, atau false jika pengguna menonaktifkan iklan berbasis 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 bawaan yang setara.
Konstanta
Nilai ditetapkan ke string yang Anda tentukan.
Tabel Pemeta
Nilai ditetapkan sesuai dengan petunjuk di tabel pemeta. Tabel pemeta berisi dua kolom (Tabel masih kosong karena hanya sebagai ilustrasi tentang penggunaan data kemudian):
| 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. Cara ini berguna jika aplikasi disiapkan dengan cara yang sedemikian rupa sampai nilai yang sesuai (misalnya, ID tracking konversi) dapat dipetakan pada Kode Versi Aplikasi atau aspek aplikasi lainnya. Dalam contoh ini, variabel yang bernama ID Konversi dibuat. Jika Kode Versi Aplikasi adalah 1.0, nilai ditetapkan ke “12345”; jika Kode Versi Aplikasi adalah 1.1, nilai ditetapkan ke “34567”. Tidak ada batasan jumlah baris dalam tabel pemeta. Kolom pada tabel ini 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 bawaan yang setara.
Data Penampung
ID Penampung
Nilainya adalah ID publik penampung (misalnya, GTM-ABC42). Dalam sebagian besar kasus, Anda harus menggunakan variabel bawaan 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 bawaan yang setara.
Aplikasi
ID Aplikasi
Nilai ditetapkan ke nama paket (Android) atau ID aplikasi (iOS). Dalam sebagian besar kasus, Anda harus menggunakan variabel bawaan yang setara.
Nama Aplikasi
Nilai ditetapkan ke nama aplikasi. Dalam sebagian besar kasus, Anda harus menggunakan variabel bawaan yang setara.
Kode Versi Aplikasi
Nilai ditetapkan ke versi aplikasi yang sedang berjalan. Dalam sebagian besar kasus, Anda harus menggunakan variabel bawaan 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 bawaan yang setara.
Perangkat
Nama Perangkat
Nilai ditetapkan ke nama perangkat untuk aplikasi yang sedang berjalan (misalnya, "Samsung Android", "Pixel 2"). Dalam sebagian besar kasus, Anda harus menggunakan variabel bawaan 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 bawaan yang setara.
Versi Sistem Operasi
Nilai ditetapkan ke versi sistem operasi yang menginstal aplikasi. Dalam sebagian besar kasus, Anda harus menggunakan variabel bawaan yang setara.
Platform
Nilai ditetapkan ke platform untuk aplikasi yang sedang berjalan (misalnya, "Android", "iOS"). Dalam sebagian besar kasus, Anda harus menggunakan variabel bawaan yang setara.
Resolusi Layar
Nilai ditetapkan ke resolusi layar perangkat untuk aplikasi yang sedang berjalan. Formatnya adalah "lebar x tinggi", misalnya, "1920 x 1080". Dalam sebagian besar kasus, Anda harus menggunakan variabel bawaan yang setara.
Lainnya
Panggilan fungsi
Nilai ditetapkan ke nilai yang ditampilkan 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 kode berikut:
{
"fuel-burn-rate": 20
}
Your mobile app can retrieve a value in the variable by providing the key. For example:
public class MainActivity {
// Add your public container ID.
private static final String CONTAINER_ID = "XXX-YYY";
// Container configuration value keys, used later
// for retrieving values.
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";
// Rest of your onCreate code.
}
}
/*
* Method to update game configuration values using a
* Google Tag Manager container.
*/
public void updateConfigurationFromContainer(Container container) {
// Get reference to the container.
Container container = mFutureContainer.get();
// Update game settings using Container
// configuration value keys.
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.