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
- Z obsługą kodów bitowych:
Instalacja i konfiguracja
Wybierz platformę do szczegółów konfiguracji:
- 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/.
- 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" />
- 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>
-
Dodaj do projektu Xcode te biblioteki:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- 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.
- Pobierz skrypt_mod_pbxproj.py i skopiuj go do katalogu Edytor. Biblioteki będą teraz dodawane automatycznie podczas kompilacji.
Konfigurowanie prefabu GAv4
Aby skonfigurować prefabularną wersję GAv4:
- Kliknij wstępnie zdefiniowany obiekt
GAv4.prefab
. Znajdziesz go w sekcji Assets/Plugins/GoogleAnalyticsV4 w widoku projektu. Przeciągnij to na hierarchię gry. - 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
Śledzenie obiektu
Po skonfigurowaniu prefabu GAv4 do śledzenia obiektu za pomocą Google Analytics:
- 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.
- Utwórz w klasie zmienną publiczną, w której będzie przechowywany obiekt GoogleAnalyticsV4. Przykład:
public GoogleAnalyticsV4 googleAnalytics;
- Zapisz skrypt i wróć do okna Unity.
- 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.
- 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.