Untuk mengaktifkan perubahan runtime pada penerapan Google Analytics yang tidak mengharuskan Anda membangun ulang dan mengirim ulang biner aplikasi ke marketplace, menerapkan Universal Analytics (UA) di aplikasi Anda dengan Google Tag Manager (GTM).
Panduan ini menunjukkan cara menggunakan tag Universal Analytics dan SDK Google Tag Manager untuk iOS agar dapat:
- Mengirim tampilan layar.
- Mengirim peristiwa.
- Kirim transaksi e-commerce.
- Mengirim data Enhanced E-commerce.
Mengirim tampilan layar
Untuk mengirim tampilan layar setiap kali layar baru dibuka di aplikasi Anda ke Google Analytics:
- Buat variabel nama layar.
- Membuat layar terbuka pemicu peristiwa.
- Membuat Universal Analytics tag tampilan layar.
- Mendorong peristiwa layar terbuka dan nama layar ke lapisan data.
1. Membuat variabel nama layar
Untuk membuat variabel nama layar di GTM:
- Login ke Google Tag Manager menggunakan akun layanan.
- Pilih penampung seluler.
- Di menu navigasi sebelah kiri, klik Variabel.
- Di bagian Variabel Buatan Pengguna, klik Baru.
- Klik Variabel Tanpa Judul untuk memasukkan nama layar nama variabel.
- Pilih Variabel Lapisan Data sebagai jenis variabel.
- Masukkan screenName sebagai Nama Variabel Lapisan Data lalu tetapkan nilai default layar tidak diketahui.
- Klik Buat Variabel.
2. Membuat pemicu peristiwa layar terbuka
Untuk membuat pemicu di GTM untuk mengaktifkan Tag tampilan layar Universal Analytics:
- Login ke Google Tag Manager menggunakan akun layanan.
- Pilih penampung seluler.
- Di menu navigasi kiri, klik Pemicu.
- Klik Baru.
- Klik Pemicu Tanpa Judul untuk memasukkan nama pemicu OpenScreenEvent.
- Pilih peristiwa Kustom.
- Pada Aktifkan Aktif, masukkan kondisi berikut:
- Klik Create Trigger.
3. Membuat tag tampilan layar Universal Analytics
Untuk membuat tag tampilan layar Universal Analytics yang diaktifkan oleh peristiwa layar terbuka:
- Login ke Google Tag Manager menggunakan akun layanan.
- Pilih penampung seluler.
- Di menu navigasi kiri, klik Tag.
- Klik Baru.
- Klik Tag Tanpa Judul untuk memasukkan nama tag Buka Layar.
- Pilih produk Google Analytics.
- Masukkan ID pelacakan.
- Pilih Tampilan Aplikasi sebagai Jenis Pelacakan.
- Klik Setelan lainnya.
- Klik Kolom untuk Ditetapkan.
- Klik + Tambahkan Kolom berulang kali untuk menambahkan kolom berikut:
- Klik Lanjutkan.
- Di bagian Aktifkan Aktif, klik Kustom.
- Pilih pemicu kustom OpenScreenEvent.
- Klik Simpan.
- Klik Buat Tag.
4. Mengirim peristiwa layar terbuka dan nama layar menjadi lapisan data
Tambahkan kode ke aplikasi Anda untuk mengirim peristiwa openScreen
dan
screenName
ke lapisan data, misalnya:
// ViewController.m // Push an 'openScreen' event to the data layer. // #import "ViewController.h" #import "TAGDataLayer.h" #import "TAGManager.h" @implementation ViewController - (void)viewDidAppear { [super viewDidAppear]; // NOTE: A GTM container should already have been opened, otherwise events // pushed to the DataLayer will not fire tags in that container. TAGDataLayer *dataLayer = [TAGManager instance].dataLayer; [dataLayer push:@{@"event": @"openScreen", // Event, name of Open Screen Event. @"screenName": @"Home Screen"}]; // Name of the screen name field, screen name value. } // Rest of the ViewController implementation @end
Mengirim peristiwa
Untuk mengirim peristiwa ke Google Analytics saat pengguna berinteraksi dengan Kontrol UI atau konten di aplikasi Anda:
- (Opsional) Buat variabel peristiwa.
- Buat pemicu peristiwa.
- Buat tag peristiwa Universal Analytics.
- Nilai variabel peristiwa dan peristiwa push ke lapisan data.
Langkah-langkah berikut menunjukkan cara peristiwa dikirim ke Google Analytics saat pengguna memulai pemutaran video.
1. (Opsional) Membuat variabel peristiwa
Jika peristiwa menggunakan variabel lapisan data untuk merepresentasikan kategorinya, {i>action<i}, label, atau bidang nilai, Anda harus terlebih dahulu membuat variabel tersebut. Dalam contoh ini, tag peristiwa pemutaran video menggunakan variabel lapisan data untuk mendapatkan judul videonya.
Untuk membuat variabel nama video di GTM:
- Login ke akun Google Tag Manager.
- Pilih penampung seluler.
- Di menu navigasi sebelah kiri, klik Variabel.
- Di bagian Variabel Buatan Pengguna, klik Baru.
- Klik Variabel Tanpa Judul untuk memasukkan nama variabel nama video.
- Pilih Variabel Lapisan Data sebagai jenis variabel.
- Masukkan videoName sebagai Nama Variabel Lapisan Data lalu tetapkan nilai default untuk video tidak diketahui.
- Klik Buat Variabel.
2. Membuat pemicu peristiwa
Untuk membuat pemicu peristiwa di GTM untuk mengaktifkan Tag peristiwa Universal Analytics:
- Login ke Google Tag Manager menggunakan akun layanan.
- Pilih penampung seluler.
- Di menu navigasi kiri, klik Pemicu.
- Klik Baru.
- Klik Pemicu Tanpa Judul untuk memasukkan nama pemicu VideoPlayEvent sendiri.
- Pilih peristiwa Kustom.
- Pada Aktifkan Aktif, masukkan kondisi berikut:
- Klik Create Trigger.
3. Membuat tag peristiwa Universal Analytics
Untuk membuat tag peristiwa Universal Analytics yang diaktifkan oleh peristiwa pemutaran video:
- Login ke Google Tag Manager menggunakan akun layanan.
- Pilih penampung seluler.
- Di menu navigasi kiri, klik Tag.
- Klik Baru.
- Klik Tag Tanpa Judul untuk memasukkan nama tag Peristiwa Pemutaran Video.
- Pilih produk Google Analytics.
- Masukkan ID pelacakan.
- Pilih Peristiwa sebagai Jenis Pelacakan.
- Masukkan parameter pelacakan peristiwa berikut:
- Klik Setelan lainnya.
- Klik Kolom untuk Ditetapkan.
- Klik + Tambahkan Kolom berulang kali untuk menambahkan kolom berikut:
- Klik Lanjutkan.
- Di bagian Aktifkan Aktif, klik Kustom.
- Pilih pemicu kustom VideoPlayEvent.
- Klik Simpan.
- Klik Buat Tag.
4. Nilai variabel peristiwa dan peristiwa push ke lapisan data
Tulis kode untuk mengirim peristiwa videoPlay
dan
videoName
ke lapisan data, misalnya:
// VideoPlayer.m // Push a 'videoPlay' event to the data layer. // #import "TAGDataLayer.h" #import "TAGManager.h" #import "Video.h" #import "VideoPlayer.h" @implementation VideoPlayer // Called when a user initiates a video playback. - (void)onPlay:(Video *)video { TAGDataLayer *dataLayer = [TAGManager instance].dataLayer; // This call assumes the container has already been opened, otherwise events // pushed to the DataLayer will not fire tags in that container. [dataLayer push:@{@"event": @"videoPlay", // Event, name of Video Play Event. @"videoName": video.title, // Additional data layer variables used by the event tag. @"screenName": @"Home Screen"}]; [self play:video]; } // Rest of the implementation @end
Kirim transaksi e-commerce
Saat pengguna menyelesaikan pembelian dalam aplikasi, untuk mengirim transaksi dan item terkait ke Google Analytics:
- Buat pemicu transaksi.
- Membuat Universal Analytics tag transaksi.
- Mendorong peristiwa transaksi, transaksi, lapisan data.
Untuk daftar nama variabel transaksi dan item yang didukung, lihat Data e-commerce yang didukung variabel lapisan.
1. Membuat pemicu transaksi
Untuk membuat pemicu transaksi di GTM untuk mengaktifkan Tag transaksi Universal Analytics:
- Login ke Google Tag Manager menggunakan akun layanan.
- Pilih penampung seluler.
- Di menu navigasi kiri, klik Pemicu.
- Klik Baru.
- Klik Pemicu Tanpa Judul untuk memasukkan nama pemicu TransactionCompleted.
- Pilih peristiwa Kustom.
- Pada Aktifkan Aktif, masukkan kondisi berikut:
- Klik Create Trigger.
2. Membuat tag transaksi Universal Analytics
Untuk membuat tag transaksi Universal Analytics yang diaktifkan oleh peristiwa transaksi:
- Login ke Google Tag Manager menggunakan akun layanan.
- Pilih penampung seluler.
- Di menu navigasi kiri, klik Tag.
- Klik Baru.
- Klik Tag Tanpa Judul untuk memasukkan nama tag Transaksi Selesai.
- Pilih produk Google Analytics.
- Masukkan ID pelacakan.
- Pilih Transaksi sebagai Jenis Pelacakan.
- Klik Setelan lainnya.
- Klik Kolom untuk Ditetapkan.
- Klik + Tambahkan Kolom berulang kali untuk menambahkan kolom berikut:
- Klik Lanjutkan.
- Di bagian Aktifkan Aktif, klik Kustom.
- Pilih pemicu kustom TransactionCompleted.
- Klik Simpan.
- Klik Buat Tag.
3. Mengirim peristiwa transaksi, transaksi, item ke lapisan data
Tulis kode untuk mengirim peristiwa transaksi, transaksi, dan peristiwa terkait item ke lapisan data. Anda harus menggunakan transaksi yang didukung dan nama variabel item untuk mengirim data transaksi dan item ke lapisan data. Contoh:
// Called when a user completes a transaction. - (void)onPurchaseCompleted:(Purchase *)purchase { TAGDataLayer *dataLayer = [TAGManager instance].dataLayer; // An array to store dictionaries of item data. NSMutableArray *purchasedItems = [NSMutableArray array]; // Push item data into dictionaries and store in the purchasedItems array. // Note that item.price and item.quantity must be of type NSString. for (id item in purchase.items) { [purchasedItems addObject:@{@"name": item.name, @"sku": item.sku, @"category": item.category, @"price": item.price, @"currency": @"USD", @"quantity": item.quantity}]; } // This call assumes the container has already been opened, otherwise events // pushed to the DataLayer will not fire tags in that container. // Note that purchase.tax, purchase.shipping, and purchase.total must be of type NSString. [dataLayer push:@{@"event": @"transaction", // Event, name of Transaction Event. @"transactionId": purchase.transactionId, // Additional fields required by the tag. @"transactionTotal": purchase.total, @"transactionAffiliation": @"In-app Store", @"transactionTax": purchase.tax, @"transactionShipping": purchase.shipping, @"transactionCurrency": @"USD", @"transactionProducts": purchasedItems}]; // Since the data layer is persistent, you should reset fields to [NSNull null] after // you are done pushing the transaction. [dataLayer push:@{@"transactionId": [NSNull null], @"transactionTotal": [NSNull null], @"transactionAffiliation": [NSNull null], @"transactionTax": [NSNull null], @"transactionShipping": [NSNull null], @"transactionCurrency": [NSNull null], @"transactionProducts": [NSNull null]}]; }