Wtyczka Google Analytics do Unity v3 (starsza wersja) – 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:

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.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. 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.

Konfigurowanie prefabu GAv3

Aby skonfigurować prefabularną wersję GAv3, musisz wykonać te czynności:

  1. Kliknij prefabowy obiekt GAv3.prefab. Znajdziesz go w sekcji Assets/Plugins/GoogleAnalyticsV3 w widoku projektu.
  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 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. Przeciągnij wypełnioną zawartość GAv3 z widoku projektu do hierarchii obiektów.

Śledzenie obiektu

Po skonfigurowaniu prefabu GAv3 możesz zacząć śledzić obiekt za pomocą Google Analytics. Aby to zrobić:

  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 GoogleAnalyticsV3. Przykład: 
    public GoogleAnalyticsV3 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 GAv3 z widoku Hierarchia obiektów do tego pola.
  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