Tag Universal Analytics

Untuk mengaktifkan perubahan runtime pada penerapan Google Analytics yang tidak mengharuskan Anda membuat ulang dan mengirim ulang biner aplikasi ke marketplace, terapkan Universal Analytics (UA) di aplikasi Anda dengan Google Tag Manager (GTM).

Panduan ini menunjukkan cara menggunakan tag Universal Analytics dan Google Tag Manager SDK untuk iOS untuk:

• Mengirim tampilan layar.
• Mengirim peristiwa.
• Kirim transaksi e-commerce.
• Kirim data Enhanced E-commerce.

Catatan: Panduan ini mengasumsikan bahwa Anda telah mengikuti Panduan Memulai untuk menerapkan Google Tag Manager untuk iOS.

Kirim tampilan layar

Untuk mengirim tampilan layar setiap kali layar baru dibuka di aplikasi Anda ke Google Analytics:

1. Buat variabel nama layar.
2. Buat pemicu peristiwa layar terbuka.
3. Buat tag tampilan layar Universal Analytics.
4. Dorong peristiwa layar terbuka dan nama layar ke lapisan data.

1. Membuat variabel nama layar

Untuk membuat variabel nama layar di GTM:

1. Login ke akun Google Tag Manager.
2. Pilih penampung seluler.
3. Di menu navigasi sebelah kiri, klik Variabel.
4. Di bagian Variabel Buatan Pengguna, klik Baru.
5. Klik Variabel Tanpa Judul untuk memasukkan nama variabel nama layar.
6. Pilih Variabel Lapisan Data sebagai jenis variabel.
7. Masukkan screenName sebagai Nama Variabel Lapisan Data dan tetapkan nilai defaultnya unknown screen.

   Lihat screenshot cara membuat variabel nama layar.

   

8. Klik Buat Variabel.

2. Membuat pemicu peristiwa layar terbuka

Untuk membuat pemicu di GTM guna mengaktifkan tag tampilan layar Universal Analytics:

1. Login ke akun Google Tag Manager.
2. Pilih penampung seluler.
3. Di menu navigasi kiri, klik Pemicu.
4. Klik Baru.
5. Klik Pemicu Tanpa Judul untuk memasukkan nama pemicu OpenScreenEvent.
6. Pilih peristiwa Kustom.
7. Di bagian Aktifkan Pada, masukkan kondisi berikut:

   

8. Klik Buat trigger.

3. Membuat tag tampilan layar Universal Analytics

Untuk membuat tag tampilan layar Universal Analytics yang diaktifkan oleh peristiwa layar terbuka:

1. Login ke akun Google Tag Manager.
2. Pilih penampung seluler.
3. Di menu navigasi kiri, klik Tag.
4. Klik Baru.
5. Klik Tag Tanpa Judul untuk memasukkan nama tag Open Screen.
6. Pilih produk Google Analytics.
7. Masukkan ID pelacakan.
8. Pilih Tampilan Aplikasi sebagai Jenis Pelacakan.
9. Klik Setelan lainnya.
10. Klik Kolom untuk Ditetapkan.
11. Klik + Tambahkan Kolom berulang kali untuk menambahkan kolom berikut:

    

12. Klik Continue.
13. Di bagian Aktifkan Pada, klik Kustom.
14. Pilih pemicu kustom OpenScreenEvent.
15. Klik Simpan.
16. Klik Buat Tag.

4. Mendorong peristiwa layar terbuka dan nama layar ke lapisan data

Tambahkan kode ke aplikasi Anda untuk mengirim peristiwa openScreen dan nilai 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:

1. (Opsional) Buat variabel peristiwa.
2. Buat pemicu peristiwa.
3. Buat tag peristiwa Universal Analytics.
4. Kirim nilai variabel peristiwa dan peristiwa 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 mewakili kolom kategori, tindakan, label, atau nilainya, Anda harus membuat variabel tersebut terlebih dahulu. Dalam contoh ini, tag peristiwa pemutaran video menggunakan variabel lapisan data untuk mendapatkan nama video.

Untuk membuat variabel nama video di GTM:

1. Login ke akun Google Tag Manager.
2. Pilih penampung seluler.
3. Di menu navigasi sebelah kiri, klik Variabel.
4. Di bagian Variabel Buatan Pengguna, klik Baru.
5. Klik Variabel Tanpa Judul untuk memasukkan nama variabel nama video.
6. Pilih Variabel Lapisan Data sebagai jenis variabel.
7. Masukkan videoName sebagai Nama Variabel Lapisan Data dan tetapkan nilai defaultnya ke unknown video.

   Lihat screenshot cara membuat variabel nama video.

   

8. Klik Buat Variabel.

2. Membuat pemicu peristiwa

Untuk membuat pemicu peristiwa di GTM untuk mengaktifkan tag peristiwa Universal Analytics:

1. Login ke akun Google Tag Manager.
2. Pilih penampung seluler.
3. Di menu navigasi kiri, klik Pemicu.
4. Klik Baru.
5. Klik Pemicu Tanpa Judul untuk memasukkan nama pemicu VideoPlayEvent.
6. Pilih peristiwa Kustom.
7. Di bagian Aktifkan Pada, masukkan kondisi berikut:

   

8. Klik Buat trigger.

3. Membuat tag peristiwa Universal Analytics

Untuk membuat tag peristiwa Universal Analytics yang diaktifkan oleh peristiwa pemutaran video:

1. Login ke akun Google Tag Manager.
2. Pilih penampung seluler.
3. Di menu navigasi kiri, klik Tag.
4. Klik Baru.
5. Klik Tag Tanpa Judul untuk memasukkan nama tag Peristiwa Pemutaran Video.
6. Pilih produk Google Analytics.
7. Masukkan ID pelacakan.
8. Pilih Peristiwa sebagai Jenis Pelacakan.
9. Masukkan parameter pelacakan peristiwa berikut:

   

10. Klik Setelan lainnya.
11. Klik Kolom untuk Ditetapkan.
12. Klik + Tambahkan Kolom berulang kali untuk menambahkan kolom berikut:

    

13. Klik Continue.
14. Di bagian Aktifkan Pada, klik Kustom.
15. Pilih pemicu kustom VideoPlayEvent.
16. Klik Simpan.
17. Klik Buat Tag.

4. Mendorong nilai variabel peristiwa dan peristiwa ke lapisan data

Tulis kode untuk mengirim peristiwa videoPlay dan nilai 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

Mengirim transaksi e-commerce

Penting: Pelacakan e-commerce mengharuskan Anda untuk menggunakan jenis transaksi dan pelacakan item. Anda tidak boleh menggunakan fitur di Enhanced E-commerce untuk pelacakan e-commerce standar.

Saat pengguna menyelesaikan pembelian dalam aplikasi, untuk mengirim transaksi dan item terkait ke Google Analytics:

1. Buat pemicu transaksi.
2. Buat tag transaksi Universal Analytics.
3. Mendorong peristiwa transaksi, transaksi, dan item ke lapisan data.

Untuk mengetahui daftar nama variabel item dan transaksi yang didukung, lihat Variabel lapisan data e-commerce yang didukung.

1. Membuat pemicu transaksi

Untuk membuat pemicu transaksi di GTM guna mengaktifkan tag transaksi Universal Analytics:

1. Login ke akun Google Tag Manager.
2. Pilih penampung seluler.
3. Di menu navigasi kiri, klik Pemicu.
4. Klik Baru.
5. Klik Untitled Trigger untuk memasukkan nama pemicu TransactionCompleted.
6. Pilih peristiwa Kustom.
7. Di bagian Aktifkan Pada, masukkan kondisi berikut:

   

8. Klik Buat trigger.

2. Membuat tag transaksi Universal Analytics

Untuk membuat tag transaksi Universal Analytics yang diaktifkan oleh peristiwa transaksi:

1. Login ke akun Google Tag Manager.
2. Pilih penampung seluler.
3. Di menu navigasi kiri, klik Tag.
4. Klik Baru.
5. Klik Tag Tanpa Judul untuk memasukkan nama tag Transaction Completed.
6. Pilih produk Google Analytics.
7. Masukkan ID pelacakan.
8. Pilih Transaksi sebagai Jenis Pelacakan.
9. Klik Setelan lainnya.
10. Klik Kolom untuk Ditetapkan.
11. Klik + Tambahkan Kolom berulang kali untuk menambahkan kolom berikut:

    

12. Klik Continue.
13. Di bagian Aktifkan Pada, klik Kustom.
14. Pilih pemicu kustom TransactionCompleted.
15. Klik Simpan.
16. Klik Buat Tag.

3. Mendorong peristiwa transaksi, transaksi, dan item ke lapisan data

Tulis kode untuk mengirim peristiwa transaksi, transaksi, dan item terkait ke lapisan data. Anda harus menggunakan nama variabel transaksi dan item yang didukung 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]}];
}

Untuk informasi selengkapnya tentang penggunaan Google Tag Manager SDK untuk Android guna menerapkan fitur Enhanced E-commerce Universal Analytics, lihat Enhanced E-commerce.

Variabel lapisan data e-commerce yang didukung

Tag transaksi universal mendukung nama variabel transaksi dan item berikut.

Perhatian: Karena lapisan data bersifat persisten, reset nilai variabel transaksi dan item ke null setelah Anda mengirim transaksi ke lapisan data.

Variabel transaksi

Nama Variabel	Deskripsi	Jenis	Wajib
transactionId	Pengenal unik transaksi	string	Ya
transactionAffiliation	Mitra atau toko	string	Tidak
transactionTotal	Nilai total transaksi	string	Tidak
transactionTax	Jumlah pajak untuk transaksi	string	Tidak
transactionShipping	Biaya pengiriman untuk transaksi	string	Tidak
transactionCurrency	Mata uang transaksi	string	Tidak
transactionProducts	Daftar item yang dibeli dalam transaksi	array variabel item.	Tidak

Variabel item

Nama Variabel	Deskripsi	Jenis	Wajib
name	Nama produk	string	Ya
sku	SKU Produk	string	Tidak
category	Kategori produk	string	Tidak
price	Harga produk	string	Tidak
currency	Jenis mata uang price	string	Tidak
quantity	Jumlah item	string	Tidak

Mengirim data Enhanced E-commerce

Penting: Enhanced E-commerce hanya tersedia untuk tampilan layar (tampilan aplikasi) dan jenis jalur peristiwa. Anda tidak boleh menggunakan jenis pelacakan transaksi dan item, yang ditujukan untuk Pelacakan E-commerce standar.

Untuk mempelajari cara mengirim data Enhanced E-commerce, lihat Panduan Developer Enhanced E-commerce.