Plugin Google Analytics untuk Unity - Panduan Developer

Dokumen ini menjelaskan konsep penting tentang penggunaan Plugin Google Analytics untuk Unity.

Sebelum memulai

Sebelum mulai, pastikan Anda telah menyelesaikan hal-hal berikut:

• Anda harus memiliki minimal satu properti Google Analytics dan tampilan (profil) yang akan digunakan untuk mengirim data dari game Anda.
• Download paket Unity yang sesuai dari repo Plugin Google Analytics untuk Unity dan impor ke project Unity Anda (Anda dapat melakukannya dengan mengklik dua kali pada file).
  • Dengan dukungan bitcode: GoogleAnalyticsV4_bitcode.unitypackage
  • Tidak ada dukungan bitcode: GoogleAnalyticsV4.unitypackage

Penyiapan dan konfigurasi

Pilih platform untuk mengetahui detail konfigurasi:

Android

1. Jika project Anda belum memiliki file bernama AndroidManifest.xml di direktori <YOUR PROJECT ROOT>/Assets/Plugins/Android/, buat project untuk Android, lalu salin AndroidManifest.xml dari direktori Temp/StagingArea/ (file akan berada di direktori yang Anda pilih untuk build). Tempel ke <YOUR PROJECT ROOT>/Assets/Plugins/Android/.
2. Tambahkan izin berikut ke AndroidManifest.xml di <YOUR PROJECT ROOT> /Assets/Plugins/Android/ di atas tag <application>:

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
         

3. Jika ingin mengaktifkan Pelacakan Kampanye, tambahkan layanan sebagai berikut:

   <service android:name="com.google.android.gms.analytics.CampaignTrackingService" />
   <receiver android:name="com.google.android.gms.analytics.CampaignTrackingReceiver"
             android:exported="true" >
     <intent-filter>
       <action android:name="com.android.vending.INSTALL_REFERRER" />
     </intent-filter>
   </receiver>
         

iOS

1. Tambahkan library berikut ke project Xcode Anda:
   • AdSupport.framework
   • CoreData.framework
   • SystemConfiguration.framework
   • libz.dylib
   • libsqlite3.dylib
2. Jika Anda ingin agar library ditambahkan secara otomatis saat membuat aplikasi untuk iOS, salin file PostProcessBuildPlayer_GA dari direktori iOS Extras dan letakkan di direktori <YOUR PROJECT ROOT>/Assets/Editor.
3. Download mod_pbxproj.py skrip dan salin ke direktori Editor. Library kini akan otomatis ditambahkan selama proses build.

Catatan: libsqlite3.dylib hanya diperlukan jika menggunakan flag penaut -ObjC di Xcode dan dapat dihapus dengan aman dari file PostProcessBuildPlayer_GA jika Anda tidak menggunakan flag ini.

Mengonfigurasi prefab GAv4

Untuk mengonfigurasi prefab GAv4:

1. Klik objek prefab GAv4.prefab, yang dapat ditemukan di Assets/Plugins/GoogleAnalyticsV4 dalam Project View. Tarik ini ke hierarki game.
2. Tampilan Inspector akan menampilkan komponen Skrip yang terpasang ke prefab dengan beberapa properti yang tercantum. Isi properti ini dengan nilai yang benar untuk project Anda. Ini akan mengisi objek sehingga dapat digunakan di mana saja dalam project Anda. Contoh:
   • Android Tracking Code: UA-XXXXXXX-1
   • iOS Tracking Code: UA-XXXXXXX-2
   • Other Tracking Code: UA-XXXXXXX-3
   • Product Name: MyGame
   • Bundle Identifier: com.example.games
   • Bundle Version: 1.0
   • Dispatch Period: 5
   • Sample Frequency: 100
   • Log Level: VERBOSE
   • Anonymize IP: false
   • Uncaught Exception Reporting: false
   • Send Launch Event: false
   • Session Timeout: 1800
   • Dry Run: false
   • Advertiser Id Support - Send IDFA/AdID: false

Catatan: Anda dapat menggunakan ID properti yang sama untuk semua platform. Lihat Praktik Terbaik untuk penyiapan Analisis Aplikasi Seluler untuk mengetahui informasi tambahan.

Melacak objek

Setelah mengonfigurasi prefab GAv4, untuk melacak objek dengan Google Analytics:

1. Identifikasi GameObject yang ingin Anda lacak (misalnya, objek Pemain) lalu klik di tampilan Object Hierarchy. Jika Anda belum memiliki skrip yang dikaitkan ke objek yang ingin dilacak, buat skrip baru menggunakan tombol Add Component dalam Inspector view.
2. Buat variabel publik di class untuk menyimpan objek GoogleAnalyticsV4. Contoh:

   public GoogleAnalyticsV4 googleAnalytics;

3. Simpan skrip dan kembali ke jendela Unity.
4. Di tampilan Inspeksi untuk GameObject yang ingin Anda lacak, Anda akan melihat skrip yang dibuat dan kolom untuk diisi yang disebut Google Analytics (atau nama variabel yang Anda pilih). Tarik objek GAv4 dari tampilan Object Hierarchy ke kolom.
   Jika Anda tidak melihat kolom untuk menambahkan prefab GAv4, periksa untuk memastikan tidak ada error kompilasi dalam skrip. Inspector tidak akan diupdate jika sudah terdapat error.
5. Sekarang Anda siap untuk mulai melacak GameObject tersebut. Ulangi proses tersebut untuk objek lain yang ingin Anda lacak menggunakan prefab yang sama.

Langkah berikutnya

• Tinjau Referensi API untuk mempelajari jenis hit yang dapat Anda kirim ke Google Analytics.
• Baca Panduan Penerapan Aplikasi Seluler untuk mempelajari cara menggunakan Google Analytics untuk mengukur interaksi pengguna dan menjawab pertanyaan tentang penggunaan game.

Referensi

• Pemecahan masalah
• Laporkan masalah
• Dapatkan bantuan
• Log perubahan