Bu belgede, Unity için Google Analytics Eklentisi'nin kullanımıyla ilgili önemli kavramlar açıklanmaktadır.
Başlamadan önce
Başlamadan önce, aşağıdaki adımları tamamladığınızdan emin olun:
- Oyununuzdan veri göndereceğiniz en az bir Google Analytics mülkünüz ve bir görünümünüz (profiliniz) olmalıdır.
- Unity deposu için Google Analytics Eklentisi'nden uygun Unity paketini indirin ve Unity projenize aktarın (dosyayı çift tıklayarak bunu yapabilirsiniz).
- Bit kodu desteğiyle:
GoogleAnalyticsV4_bitcode.unitypackage
- Bit kodu desteği yoktur:
GoogleAnalyticsV4.unitypackage
- Bit kodu desteğiyle:
Kurulum ve yapılandırma
Yapılandırma ayrıntıları için bir platform seçin:
- Projenizin <PROJE ROOTUNUZ>/Assets/Eklentiler/Android/ dizininde AndroidManifest.xml adında bir dosya yoksa projeyi Android için oluşturun ve Temp/StagingArea/ dizininden AndroidManifest.xml dosyasını kopyalayın (dosya, derlemeyi seçtiğiniz dizinin altındadır). Kodu <PROJE KÖKÜNÜZ>/Assets/Plugins/Android/ konumuna yapıştırın.
- <PROJE ROOTUNUZ> /Assets/Plugins/Android/ konumundaki AndroidManifest.xml dosyasında
<application>
etiketinin üstüne aşağıdaki izinleri ekleyin:<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
- Kampanya İzleme'yi etkinleştirmek istiyorsanız hizmeti aşağıdaki şekilde ekleyin:
<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>
-
Aşağıdaki kitaplıkları Xcode projenize ekleyin:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- iOS için derleme yaparken kitaplıkların otomatik olarak eklenmesini tercih ederseniz iOS Extras dizininden PostProcessBuildPlayer_GA dosyasını kopyalayıp <PROJE KÖKÜMÜ>/Assets/Editor dizinine yerleştirin.
- mod_pbxproj.py komut dosyasını indirip Düzenleyici dizinine kopyalayın. Kitaplıklar artık derleme sırasında otomatik olarak eklenecek.
GAv4 prefab'ini yapılandırma
GAv4 prefab'ini yapılandırmak için:
- Proje Görünümü'ndeki Assets/Eklentiler/GoogleAnalyticsV4 bölümünde bulunan
GAv4.prefab
prefab nesnesini tıklayın. Bunu oyun hiyerarşisine sürükleyin. - Denetleyici görünümü, çeşitli özelliklerin listelendiği prefabe ekli bir Komut Dosyası bileşeni görüntüler.
Bu özellikleri projeniz için doğru değerlerle doldurun. Bu işlem, nesneyi doldurarak projenizin her yerinde kullanılabilmesini sağlar. Örneğin:
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
Nesneyi izleme
GAv4 prefab'ini yapılandırdıktan sonra, bir nesneyi Google Analytics ile izlemek için:
- İzlemek istediğiniz bir GameObject öğesini (ör. Oynatıcı nesnesi) belirleyin ve Nesne Hiyerarşisi görünümünde tıklayın. İzlemek istediğiniz nesneye eklenmiş bir komut dosyanız yoksa İnceleyici görünümündeki Bileşen Ekle düğmesini kullanarak yeni bir komut dosyası oluşturun.
- Sınıfta, GoogleAnalyticsV4 nesnesini barındıracak bir ortak değişken oluşturun. Örneğin:
public GoogleAnalyticsV4 googleAnalytics;
- Komut dosyasını kaydedin ve Unity penceresine geri dönün.
- İzlemek istediğiniz GameObject için İnceleyici görünümünde, oluşturduğunuz komut dosyasını ve doldurulacak Google Analytics adını (veya seçtiğiniz değişken adını) görürsünüz. GAv4 nesnesini Nesne Hiyerarşisi görünümünden alana sürükleyin.
- Artık GameObject öğesini izlemeye hazırsınız. Aynı prefab'ı kullanarak, izlemek istediğiniz diğer nesneler için bu işlemi tekrarlayın.
Sonraki adımlar
- Google Analytics'e ne tür isabetler gönderebileceğinizi öğrenmek için API Referansı'nı inceleyin.
- Kullanıcı etkileşimlerini ölçmek ve oyun kullanımıyla ilgili soruları yanıtlamak üzere Google Analytics'i nasıl kullanacağınızı öğrenmek için Mobil Uygulama Uygulama Kılavuzu'nu okuyun.