Wtyczka Google Analytics do Unity – przewodnik dla programistów

Ten dokument zawiera ważne pojęcia związane z korzystaniem z wtyczki Google Analytics dla Unity.

Zanim zaczniesz

Zanim zaczniesz, wykonaj te czynności:

• Musisz mieć co najmniej jedną usługę Google Analytics i widok (profil), do których chcesz wysyłać dane z gry.
• Pobierz odpowiedni pakiet Unity z repozytorium wtyczki Google Analytics do Unity i zaimportuj go do swojego projektu Unity (powinno to być możliwe po dwukrotnym kliknięciu pliku).
  • Z obsługą kodów bitowych: GoogleAnalyticsV4_bitcode.unitypackage
  • Brak obsługi kodów bitowych: GoogleAnalyticsV4.unitypackage

Instalacja i konfiguracja

Wybierz platformę do szczegółów konfiguracji:

Android

1. Jeśli w Twoim projekcie nie ma pliku o nazwie AndroidManifest.xml w katalogu <YOUR PROJECT ROOT>/Assets/Plugins/Android/, utwórz projekt dla Androida, a następnie skopiuj AndroidManifest.xml z katalogu Temp/StagingArea/ (znajduje się on w katalogu wybranym przez Ciebie do kompilacji). Wklej go do sekcji <ROOT TWOJEGO PROJEKTU>/Assets/Plugins/Android/.
2. Dodaj do pliku AndroidManifest.xml w sekcji <TWOJE ROOT PROJEKTU> /Assets/Plugins/Android/ nad tagiem <application>:

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
         

3. Jeśli chcesz włączyć śledzenie kampanii, dodaj usługę w ten sposób:

   <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. Dodaj do projektu Xcode te biblioteki:
   • AdSupport.framework
   • CoreData.framework
   • SystemConfiguration.framework
   • libz.dylib
   • libsqlite3.dylib
2. Jeśli wolisz, aby biblioteki były automatycznie dodawane podczas kompilowania aplikacji na iOS, skopiuj plik PostProcessBuildPlayer_GA z katalogu iOS Extras i umieść go w katalogu <YOUR PROJECT ROOT>/Assets/Editor.
3. Pobierz skrypt_mod_pbxproj.py i skopiuj go do katalogu Edytor. Biblioteki będą teraz dodawane automatycznie podczas kompilacji.

Uwaga: parametr libsqlite3.dylib jest wymagany tylko wtedy, gdy używasz flagi łączącej -ObjC w Xcode. Jeśli nie używasz tej flagi, można ją bezpiecznie usunąć z pliku PostProcessBuildPlayer_GA.

Konfigurowanie prefabu GAv4

Aby skonfigurować prefabularną wersję GAv4:

1. Kliknij wstępnie zdefiniowany obiekt GAv4.prefab. Znajdziesz go w sekcji Assets/Plugins/GoogleAnalyticsV4 w widoku projektu. Przeciągnij to na hierarchię gry.
2. W widoku Inspektora wyświetli się komponent skryptu dołączony do prefabu z kilkoma wymienionymi właściwościami. Wypełnij te właściwości wartościami odpowiednimi dla Twojego projektu. Obiekt zostanie wypełniony, dzięki czemu będzie można go używać wszędzie w projekcie. Na przykład:
   • 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

Uwaga: tego samego identyfikatora usługi możesz używać na wszystkich platformach. Więcej informacji znajdziesz w artykule Sprawdzone metody konfiguracji Analytics dla aplikacji mobilnych.

Śledzenie obiektu

Po skonfigurowaniu prefabu GAv4 do śledzenia obiektu za pomocą Google Analytics:

1. Znajdź GameObject, który chcesz śledzić (np. obiekt odtwarzacza), i kliknij go w widoku Hierarchia obiektów. Jeśli nie masz jeszcze skryptu dołączonego do obiektu, który chcesz śledzić, utwórz nowy skrypt, klikając przycisk Dodaj komponent w widoku inspektora.
2. Utwórz w klasie zmienną publiczną, w której będzie przechowywany obiekt GoogleAnalyticsV4. Przykład:

   public GoogleAnalyticsV4 googleAnalytics;

3. Zapisz skrypt i wróć do okna Unity.
4. W widoku inspektora obiektu GameObject, który chcesz śledzić, zobaczysz utworzony skrypt i pole do wypełniania o nazwie Google Analytics (lub wybranej przez Ciebie nazwie zmiennej). Przeciągnij obiekt GAv4 z widoku Hierarchia obiektów do tego pola.
   Jeśli nie widzisz pola umożliwiającego dodanie prefabu GAv4, sprawdź, czy w skrypcie nie ma błędów kompilacji. Inspektor nie zaktualizuje się, jeśli wystąpią błędy.
5. Możesz teraz zacząć śledzić ten GameObject. Powtórz te czynności dla innych obiektów, które chcesz śledzić za pomocą tego samego prefabu.

Dalsze kroki

• Zajrzyj do dokumentacji API, aby dowiedzieć się, jakiego rodzaju działania możesz wysyłać do Google Analytics.
• Przeczytaj Przewodnik po implementacji aplikacji mobilnych, aby dowiedzieć się, jak za pomocą Google Analytics mierzyć interakcje użytkowników i uzyskiwać odpowiedzi na pytania dotyczące korzystania z gier.

Zasoby

• Rozwiązywanie problemów
• Zgłoś problem
• Uzyskaj pomoc
• Historia zmian