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 item berikut:

• Anda harus memiliki minimal satu properti Google Analytics dan tampilan (profil) yang akan dikirimi data dari game.
• Download paket Unity yang sesuai dari repo Google Analytics Plugin untuk Unity, lalu impor ke dalam 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 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/ (berada di direktori yang Anda pilih untuk build). Tempelkan 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 Anda 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 menambahkan library secara otomatis saat mem-build 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 pada 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 dilampirkan ke objek yang ingin dilacak, buat skrip baru menggunakan tombol Add Component di 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. Pada Tampilan Inspector 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 Anda. Inspector tidak akan diupdate jika sudah ada 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