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

Bu belgede Unity için Google Analytics Eklentisinin kullanımıyla ilgili önemli kavramlar açıklanmaktadır.

Başlamadan önce

Başlamadan önce aşağıdaki öğeleri tamamladığınızdan emin olun:

• Oyununuzdan veri göndermek için en az bir Google Analytics mülkünüz ve bir görünümünüz (profiliniz) olmalıdır.
• Google Analytics Eklenti Unity deposundan uygun Unity paketini indirin ve Unity projenize aktarın (bunu, dosyayı çift tıklayarak yapabilirsiniz).
  • Bit kodu desteği: GoogleAnalyticsV4_bitcode.unitypackage
  • Bit kodu desteği yoktur: GoogleAnalyticsV4.unitypackage

Kurulum ve yapılandırma

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

Android

1. Projenizin <PROJENİZ ROOT>/Öğeler Bunu <PROJENİZ ROT>/Assets/Plugins/Android/ konumuna yapıştırın.
2. Aşağıdaki izinleri, <PROJE ROTUNUZDA> /Assets/Plugins/Android/ içindeki AndroidManifest.xml dosyasına <application> etiketinin üst kısmına 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. Xcode projenize aşağıdaki kitaplıkları ekleyin:
   • AdSupport.framework
   • TemelVeri.çerçeve
   • 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 <PROJENİZ ROT>/Assets/Editor dizinine yerleştirin.
3. mod_pbxproj.py komut dosyasını indirin ve Düzenleyici dizinine kopyalayın. Kitaplıklar, derleme sırasında otomatik olarak eklenir.

Not: libsqlite3.dylib yalnızca Xcode'da -ObjC bağlayıcı bayrağı kullanılıyorsa gereklidir ve bu bayrağı kullanmazsanız PostProcessBuildPlayer_GA dosyasından güvenli bir şekilde kaldırılabilir.

GAv4 prefab'ını yapılandırma

GAv4 prefab'ını yapılandırmak için:

1. Proje Görünümü'ndeki Öğeler/Eklentiler/GoogleAnalyticsV4'te bulunan GAv4.prefab prefab nesnesini tıklayın. Bunu oyun hiyerarşisine sürükleyin.
2. İnceleyici görünümü, listelenen birden çok özelliğin yer aldığı önbelleğe eklenmiş bir Komut dosyası bileşeni gösterir. Bu özellikleri, projeniz için doğru değerlerle doldurun. Bu işlem, nesneyi projenizin her yerinde kullanılabilmesi için doldurur. Ö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

Not: Tüm mülkler için aynı mülk kimliğini kullanabilirsiniz. Daha fazla bilgi için Mobil Uygulama Analizi kurulumu için en iyi uygulamalar sayfasını inceleyin.

Nesne izleme

GAv4 prefabriğini yapılandırdıktan sonra, bir nesneyi Google Analytics ile izlemek için:

1. İzlemek istediğiniz GameObject öğesini tanımlayın (örneğin, bir Oyuncu nesnesi) ve Nesne Hiyerarşisi görünümünde bunu tıklayın. İzlemek istediğiniz nesneye önceden 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. Google AnalyticsV4 nesnesini tutmak için sınıfta herkese açık bir 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 İnceleyici görünümünde, oluşturduğunuz komut dosyasını ve doldurulacak bir alanı Google Analytics (veya seçtiğiniz değişken adı) olarak görürsünüz. GAv4 nesnesini Nesne Hiyerarşisi görünümünden alana sürükleyin.
   GAv4 ön ekini eklemek için bir alan görmüyorsanız komut dosyanızda derleme hatası olmadığından emin olun. Mevcut hatalar varsa İnceleyen güncellenmez.
5. Artık bu GameObject öğesini izlemeye başlayabilirsiniz. Aynı prestiji kullanarak izlemek istediğiniz diğer nesneler için 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

• Sorun giderme
• Sorun bildirin
• Yardım alın
• Değişiklik günlüğü