Unity v3 (Eski) 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.analytics.tracking.android.CampaignTrackingService" />
<receiver android:name="com.google.analytics.tracking.android.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.

GAv3 prefab'ı yapılandırma

GAv3 prefab'ini yapılandırmak için aşağıdaki adımlar gereklidir:

  1. Proje Görünümü'ndeki Assets/Eklentiler/GoogleAnalyticsV3 bölümünde bulunan GAv3.prefab prefab nesnesini tıklayın.
  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 Property ID: UA-XXXXXXX-1
    • iOS Property ID: UA-XXXXXXX-2
    • Other Property ID: UA-XXXXXXX-3
    • App Name: MyGame
    • Bundle ID: com.example.games
    • App Version: 1.0
    • Dispatch Period: 5
    • Sample Frequency: 100
    • Debug Mode: VERBOSE
    • Anonymize IP: false
    • Dry Run: false
  3. Doldurulan GAv3'ü Proje görünümünden Nesne Hiyerarşisi'ne sürükleyin.

Nesneyi izleme

GAv3 prefab'ini yapılandırdıktan sonra, aşağıdaki adımları uygulayarak Google Analytics'i kullanarak bir nesneyi izlemeye başlayabilirsiniz:

  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, GoogleAnalyticsV3 nesnesini barındıracak bir ortak değişken oluşturun. Örneğin: 
    public GoogleAnalyticsV3 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. GAv3 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