Unity için Google Analytics Eklentisi - Geliştirici Kılavuzu

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:

Kurulum ve yapılandırma

Yapılandırma ayrıntıları için bir platform seçin:

Android
  1. 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.
  2. <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" />
  3. 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>
iOS
  1. Aşağıdaki kitaplıkları Xcode projenize ekleyin:
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. 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.
  3. 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:

  1. 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.
  2. 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:

  1. İ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.
  2. Sınıfta, GoogleAnalyticsV4 nesnesini barındıracak bir ortak değişken oluşturun. Örneğin: 
    public GoogleAnalyticsV4 googleAnalytics;
  3. Komut dosyasını kaydedin ve Unity penceresine geri dönün.
  4. İ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.
  5. 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.

Kaynaklar