Panduan migrasi ini menjelaskan hal-hal yang baru di SDK versi 2, dan memberikan tips bagi developer untuk bermigrasi dari penerapan v1.x. Developer yang tidak perlu bermigrasi dari implementasi v1.x dapat Mulai Menggunakan Versi 2 sekarang.
Pengantar
Google Analytics baru-baru ini merilis Google Analytics SDK yang diupdate untuk Android versi 2. SDK versi 2 berisi dukungan untuk fitur baru dan antarmuka pelaporan baru yang dirancang khusus untuk developer aplikasi.
Sebaiknya semua developer Google Analytics yang ada bermigrasi ke Google Analytics SDK untuk Android versi 2 untuk memanfaatkan fitur dan laporan baru.
Yang Baru di Versi 2
Google Analytics SDK untuk Android versi 2 memperkenalkan pengalaman pelaporan baru yang dirancang untuk developer aplikasi, dimensi dan metrik baru yang canggih, dan banyak lagi. Berikut adalah hal yang didapatkan developer dengan versi 2:
- Laporan yang lebih canggih untuk developer aplikasi
- Laporan standar telah didesain ulang untuk developer aplikasi, dengan menambahkan laporan baru seperti Alur Engagement dan Sumber Google Play untuk membantu developer mendapatkan insight baru tentang akuisisi dan pengalaman pengguna. Baca Praktik Terbaik Konfigurasi Akun kami guna mempelajari lebih lanjut cara terbaik mengonfigurasi properti Anda untuk versi 2.
- Dimensi dan metrik aplikasi baru
- Dimensi dan metrik khusus aplikasi yang baru telah diperkenalkan di SDK versi 2, termasuk Nama Layar dan Tampilan Layar, Nama Aplikasi, Versi aplikasi, dan banyak lagi.
- Mengukur error dan pengecualian
- Google Analytics SDK untuk Android memperkenalkan pengukuran pengecualian dan jenis hit pengecualian. Dengan menggunakan pengukuran pengecualian, Anda dapat mengukur jumlah dan jenis error serta pengecualian non-fatal. Untuk mempelajari cara menerapkan pengukuran pengecualian, lihat Panduan Developer Pengecualian.
- Dimensi dan metrik kustom
- Buat dimensi kustom untuk menyegmentasikan data Anda dengan cara baru. Pelajari Dimensi dan Metrik Kustom lebih lanjut.
- Mengukur interaksi sosial
- Dapatkan insight baru tentang nilai sosial dalam aplikasi Anda dengan mengukur interaksi pengguna dengan widget dan plugin sosial yang disematkan. Pelajari lebih lanjut cara mengukur Interaksi Sosial.
Sebelum Memulai
Semua developer sebaiknya melakukan dua langkah ini sebelum memulai migrasi:
- Download Google Analytics SDK untuk Android v2
- Buat tampilan (profil) aplikasi yang akan digunakan untuk mengakses laporan dan data aplikasi baru.
Setelah menyelesaikan langkah-langkah di atas, ikuti langkah-langkah di bawah untuk jalur migrasi Anda.
Bermigrasi dari EasyTracker
Ada tiga langkah yang dapat Anda lakukan untuk memigrasikan aplikasi dari library EasyTracker dari v1 ke v2:
- Perbarui parameter dalam file resource GoogleAnalytics.xml Anda
- Memperbarui nama metode
- Memperbarui penerima siaran (Pelacakan Kampanye Google Play)
1. Memperbarui Parameter di GoogleAnalytics.xml
Saat bermigrasi ke versi 2, perbarui parameter di file resource GoogleAnalytics.xml, karena beberapa di antaranya telah berubah sejak v1.x dan parameter baru telah ditambahkan di versi 2.
Tabel di bawah menunjukkan parameter yang telah diupdate di versi 2:
| Nama parameter v1.x | Nama parameter v2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | tidak digunakan lagi |
Untuk mempelajari lebih lanjut, lihat Parameter EasyTracker yang baru dan diperbarui.
2. Perbarui Nama Metode
Meskipun sebagian besar sintaksisnya tetap sama di EasyTracker versi 2, ada beberapa perbedaan penting dalam nama metode dan sintaksis yang mengharuskan Anda memperbarui implementasi:
trackPageView()adalahsendView()dalam versi 2. Untuk informasi selengkapnya, lihat Panduan Developer Pelacakan Layar- Penerapan E-commerce telah disederhanakan. Pelajari cara menerapkan pengukuran E-commerce di versi 2.
- Variabel kustom telah diganti dengan Dimensi dan Metrik Kustom. Setiap
panggilan ke
setCustomVar()harus diupdate untuk memanfaatkan fitur baru ini. Pelajari cara menerapkan Dimensi dan Metrik Kustom.
3. Memperbarui Penerima Siaran (Pelacakan Kampanye Google Play)
Developer yang telah menerapkan Pelacakan Kampanye Google Play menggunakan v1.x harus memperhatikan bahwa jalur class penerima telah berubah. Lihat Panduan Pelacakan Kampanye Google Play untuk informasi selengkapnya.
Bermigrasi dari Implementasi Kustom
Jika Anda tidak menggunakan library EasyTracker di Analytics SDK v1.x untuk Android, sebaiknya mulai gunakan EasyTracker di versi 2.
Library EasyTracker kini disertakan dengan SDK dan direkomendasikan untuk semua developer. Mulai menggunakan EasyTracker di Google Analytics SDK v2.
Jika Anda memiliki kebutuhan pengumpulan data lanjutan, seperti menggunakan beberapa ID properti dalam satu penerapan, baca Panduan Konfigurasi Lanjutan untuk mempelajari lebih lanjut cara menggunakan fitur lanjutan SDK v2.x.