Udostępnij za pośrednictwem

App Center Analytics (Unity)

Ważne

Program Visual Studio App Center został wycofany 31 marca 2025 r. z wyjątkiem funkcji analizy i diagnostyki, które będą nadal obsługiwane do 30 czerwca 2026 r. Dowiedz się więcej.

Usługa App Center Analytics pomaga zrozumieć zachowanie użytkowników i zaangażowanie klientów w celu ulepszenia aplikacji. Zestaw SDK automatycznie przechwytuje liczbę sesji i właściwości urządzenia, takie jak model, wersja systemu operacyjnego itp. Możesz zdefiniować własne zdarzenia niestandardowe, aby mierzyć istotne elementy. Wszystkie przechwycone informacje są dostępne w portalu App Center, aby umożliwić analizę danych.

Postępuj zgodnie z instrukcjami w sekcji Rozpoczęcie pracy z Unity, jeśli zestaw SDK nie został jeszcze skonfigurowany w aplikacji.

Uwaga / Notatka

Aby użyć przedstawionych poniżej interfejsów API, należy dodać następującą using instrukcję do pliku .cs :

using Microsoft.AppCenter.Unity.Analytics;

Należy również upewnić się, że opcja Użyj analizy jest zaznaczona w ustawieniach obiektu gry centrum aplikacji.

Informacje o sesji i urządzeniu

Po dodaniu usługi App Center Analytics i uruchomieniu zestawu SDK automatycznie będzie śledzić sesje i właściwości urządzenia, takie jak wersja systemu operacyjnego, model itp., bez konieczności dodatkowego kodu w aplikacji.

Zdarzenia niestandardowe

Możesz śledzić własne zdarzenia niestandardowe z maksymalnie 20 właściwościami, aby dowiedzieć się, co dzieje się w aplikacji, zrozumieć działania użytkowników i zobaczyć zagregowane dane w portalu Centrum Aplikacji.

Użyj metody , TrackEvent() aby śledzić zdarzenia za pomocą właściwości. Możesz wysłać do 200 odrębnych nazw zdarzeń. Istnieje maksymalny limit 256 znaków na nazwę zdarzenia i 125 znaków na nazwę i wartość właściwości zdarzenia.

Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
});

Właściwości zdarzeń są opcjonalne — jeśli chcesz śledzić zdarzenie, użyj tego przykładu:

Analytics.TrackEvent("Video clicked");

Ostrzeżenie

Analytics.TrackEvent() będzie zachowywać się niespójnie na różnych platformach, jeśli zostanie wywołane przed metodą Awake() w skrypcie AppCenterBehavior.cs. Dla bezpieczeństwa, należy polegać tylko na wysyłanych zdarzeniach po tym, jak pierwsza scena w aplikacji obudziła wszystkie MonoBehaviour skrypty. Aby śledzić zdarzenie w połączeniu z MonoBehavour inicjalizacją, rozważ dodanie interfejsu API do metody skryptu Start() zamiast Awake().

Włączanie lub wyłączanie analizy usługi App Center w czasie wykonywania

Możesz włączyć i wyłączyć analizę usługi App Center w czasie wykonywania. Jeśli go wyłączysz, zestaw SDK przestanie zbierać informacje analityczne dla aplikacji. Aby wyłączyć analizę, użyj następującego interfejsu API, przekazując false jako parametr.

Analytics.SetEnabledAsync(false);

Aby ponownie włączyć usługę App Center Analytics, użyj tego samego interfejsu API, ale przekaż true jako parametr.

Analytics.SetEnabledAsync(true);

Stan jest utrwalany w magazynie urządzenia w ramach uruchamiania aplikacji.

Ten interfejs API jest asynchroniczny. Więcej informacji można uzyskać w naszym przewodniku asynchronicznych interfejsów API centrum aplikacji .

Sprawdzanie, czy usługa App Center Analytics jest włączona

Możesz również sprawdzić, czy usługa App Center Analytics jest włączona, czy nie.

bool isEnabled = await Analytics.IsEnabledAsync();

Priorytet zdarzenia i trwałość

Możesz śledzić zdarzenia krytyczne dla działania firmy, które mają większe znaczenie niż inne zdarzenia.

Deweloperzy mogą ustawić trwałość zdarzeń na wartość Normal (Flags.PersistenceNormal w interfejsie API) lub Krytyczne (Flags.PersistenceCritical w interfejsie API).

Do śledzenia zdarzenia jako krytycznego można użyć następującego interfejsu API:

Analytics.TrackEvent("eventName", Flags.PersistenceCritical);

Jeśli używasz właściwości:

Analytics.TrackEvent("eventName", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
}, Flags.PersistenceCritical);

Wstrzymywanie i wznawianie wysyłania dzienników

Wstrzymanie transmisji zdarzeń może być przydatne w scenariuszach, gdy aplikacja musi kontrolować przepustowość sieci w celu uzyskania bardziej krytycznych potrzeb biznesowych. Możesz wstrzymać wysyłanie dzienników do zaplecza Centrum aplikacji. Po wstrzymaniu zdarzenia mogą być nadal śledzone i zapisywane, ale nie są wysyłane od razu. Wszystkie zdarzenia śledzone przez aplikację podczas wstrzymania będą wysyłane tylko po wywołaniu metody Analytics.Resume.

Analytics.Pause();
Analytics.Resume();

Ten interfejs API jest asynchroniczny. Więcej informacji można uzyskać w naszym przewodniku asynchronicznych interfejsów API centrum aplikacji .

Zarządzanie sesją początkową

Domyślnie identyfikator sesji zależy od cyklu życia aplikacji. Jeśli chcesz ręcznie kontrolować rozpoczęcie nowej sesji, wykonaj następujące kroki:

Uwaga / Notatka

Zwróć uwagę, że każde wywołanie interfejsu API Analytics.StartSession() spowoduje wygenerowanie nowej sesji. Jeśli w trybie ręcznego śledzenia sesji ten interfejs API nie zostanie wywołany, wszystkie dzienniki wysyłające będą miały wartość sesji o wartości null.

Uwaga / Notatka

Zwróć uwagę, że po uruchomieniu nowej aplikacji identyfikator sesji zostanie ponownie wygenerowany.

  • Usuń zaznaczenie pola wyboru Włącz śledzenie sesji ręcznej w sekcji Analiza obiektu gry z dołączonym elementem AppCenterBehavior .
  • Następnie możesz użyć interfejsu API po wykonaniu StartSession polecenia AppCenter.Start:
Analytics.StartSession();

Rozmiar magazynu lokalnego

Domyślnie zestaw SDK przechowuje w magazynie dzienniki o wielkości do 10 MB.

Brak dostępu do Internetu

Jeśli nie ma łączności sieciowej, SDK zapisuje dzienniki do 10 MB w pamięci lokalnej. Po zapełnieniu magazynu zestaw SDK zacznie odrzucać stare dzienniki, aby zapewnić miejsce na nowe dzienniki. Gdy urządzenie odzyska dostęp do Internetu, SDK będzie wysyłać dzienniki w partiach po 50 lub co 6 sekund.

Grupowanie logów zdarzeń

SDK App Center wysyła dzienniki w partiach po 50, a jeśli SDK nie ma 50 dzienników do wysłania, nadal wyśle dzienniki po 6 sekundach. Można wysłać maksymalnie trzy partie równolegle.

Logika ponawiania i wycofywania

Zestaw SDK usługi App Center obsługuje ponawianie prób w przypadku możliwych do odzyskania błędów sieci. Poniżej znajduje się logika ponawiania prób:

  • Maksymalnie 3 próby na każde żądanie.
  • Każde żądanie ma własny mechanizm stanu ponawiania.
  • Wszystkie kanały transmisji są wyłączone (do następnego procesu aplikacji) po wyczerpaniu wszystkich ponownych prób przez jedno żądanie.

Logika odwlekania

  • 50% losowań, najpierw ponów próbę z zakresu od 5s do 10s, drugą próbę z zakresu od 2,5 do 5 minut, ostatnia próba z zakresu od 10 do 20 minut.
  • Jeśli sieć zmienia się z wyłączonej na włączoną (lub z wi-fi na mobilną), stany ponawiania są restartowane i żądania są ponawiane natychmiast.