Sdílet prostřednictvím

App Center Analytics (Unity)

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

App Center Analytics vám pomůže pochopit chování uživatelů a zapojení zákazníků a zlepšit tak vaši aplikaci. Sada SDK automaticky zaznamenává počet relací a vlastnosti zařízení, jako je model, verze operačního systému atd. Můžete definovat vlastní události pro měření věcí, které jsou pro vás důležité. Všechny zachycené informace jsou k dispozici na portálu App Center, abyste mohli analyzovat data.

Pokud jste ještě nenastavili sadu SDK ve své aplikaci, postupujte podle pokynů v části Začínáme Unity .

Poznámka:

Pokud chcete použít níže uvedená rozhraní API, musíte do using souboru přidat následující .cs příkaz:

using Microsoft.AppCenter.Unity.Analytics;

Musíte se také ujistit, že je v nastavení herního objektu App Center zaškrtnuté políčko Použít analýzu .

Informace o relacích a zařízeních

Jakmile přidáte App Center Analytics a spustíte sadu SDK, automaticky bude sledovat relace a vlastnosti zařízení, jako je verze operačního systému, model atd. bez nutnosti dalšího kódu v aplikaci.

Vlastní události

Můžete sledovat vlastní události s až 20 vlastnostmi, abyste věděli, co se děje v aplikaci, porozumět akcím uživatelů a zobrazit agregace na portálu App Center.

Použijte metodu TrackEvent() ke sledování událostí s vlastnostmi. Můžete odeslat až 200 jedinečných názvů událostí. Maximální limit je 256 znaků na název události a 125 znaků na název a hodnotu vlastnosti události.

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

Vlastnosti událostí jsou volitelné – pokud chcete jenom sledovat událost, použijte místo toho tuto ukázku:

Analytics.TrackEvent("Video clicked");

Výstraha

Analytics.TrackEvent() bude se chovat nekonzistentně napříč platformami, pokud je volána před metodou Awake() ve skriptu AppCenterBehavior.cs. Abyste byli v bezpečí, měli byste se spoléhat pouze na události, které se mají odeslat poté, co první scéna ve vaší aplikaci probudila všechny MonoBehaviour skripty. Pokud chcete sledovat událost ve spojení s inicializací MonoBehavour, zvažte přidání rozhraní API do metody skriptu Start() místo Awake().

Povolit nebo zakázat App Center Analytics během provozu

Analýzu App Center můžete povolit a zakázat za běhu. Pokud ji zakážete, sada SDK přestane shromažďovat analytické informace pro aplikaci. Pokud chcete analýzu zakázat, použijte následující rozhraní API a předáte false ho jako parametr.

Analytics.SetEnabledAsync(false);

Pokud chcete znovu povolit funkci Analytics v App Center, použijte stejnou metodu API, ale jako parametr předejte true.

Analytics.SetEnabledAsync(true);

Stav se zachová v úložišti zařízení napříč spuštěním aplikace.

Toto rozhraní API je asynchronní, můžete si přečíst další informace v průvodci asynchronními rozhraními API služby App Center .

Kontrola, jestli je povolená analýza App Center

Můžete také zkontrolovat, jestli je povolená analýza App Center nebo ne.

bool isEnabled = await Analytics.IsEnabledAsync();

Priorita a trvalost události

Můžete sledovat důležité obchodní události, které mají vyšší důležitost než jiné události.

Vývojáři můžou nastavit trvalost událostí jako Normální (Flags.PersistenceNormal v rozhraní API) nebo Kritické (Flags.PersistenceCritical v rozhraní API).

Ke sledování události jako kritické můžete použít následující rozhraní API:

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

Jestliže používáte vlastnosti:

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

Pozastavení a obnovení odesílání protokolů

Pozastavení přenosu událostí může být užitečné ve scénářích, kdy aplikace potřebuje řídit šířku pásma sítě pro důležitější obchodní potřeby. Odesílání protokolů do back-endu App Center můžete pozastavit. Když je pozastaveno, události se stále dají sledovat a ukládat, ale neodesílají se hned. Všechny události, které vaše aplikace sleduje, zatímco je pozastavena, budou odeslány pouze, jakmile zavoláte Analytics.Resume.

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

Toto rozhraní API je asynchronní, můžete si přečíst další informace v průvodci asynchronními rozhraními API služby App Center .

Správa úvodní relace

Identifikátor relace ve výchozím nastavení závisí na životním cyklu aplikace. Pokud chcete ručně ovládat zahájení nové relace, postupujte podle následujících kroků:

Poznámka:

Věnujte pozornost tomu, že každé volání rozhraní API Analytics.StartSession() vygeneruje novou relaci. Pokud v režimu manuálního sledování relací nebude toto API voláno, všechny odesílané záznamy budou mít hodnotu relace jako null.

Poznámka:

Pamatujte, že po spuštění nové aplikace se identifikátor relace znovu vygeneruje.

  • Zrušte zaškrtnutí políčka Povolit ruční sledování relací v části Analýza herního objektu s připojenou položkou AppCenterBehavior .
  • Pak můžete použít StartSession rozhraní API po AppCenter.Start:
Analytics.StartSession();

Velikost místního úložiště

SDK ve výchozím nastavení ukládá do úložiště až 10 MB logů.

Bez přístupu k internetu

Pokud není k dispozici žádné síťové připojení, ukládá SDK do místního úložiště až 10 MB protokolů. Jakmile je úložiště plné, sada SDK začne zahodit staré protokoly, aby se uvolnilo místo pro nové protokoly. Jakmile zařízení získá přístup k internetu, sada SDK odešle protokoly v dávce 50 nebo po každých 6 sekundách.

Seskupování protokolů událostí

App Center SDK nahraje protokoly v dávce po 50 a pokud SDK nemá 50 protokolů k odeslání, protokoly budou odeslány po 6 sekundách. Paralelně se odesílají maximálně tři dávky.

Logika opakování a zpětného vypnutí

Sada App Center SDK podporuje opakované pokusy o obnovení při obnovitelných chybách sítě. Níže je logika opakování:

  • Maximálně 3 pokusy na žádost
  • Každý požadavek má svůj vlastní počítač stavu opakování.
  • Všechny přenosové kanály jsou deaktivovány (až do dalšího procesu aplikace) poté, co jeden požadavek vyčerpá všechny své opakované pokusy.

Logika ústupu

  • 50% randomizace, první opakování mezi 5 s a 10 s, druhé opakování mezi 2,5 a 5 minutami, poslední opakování mezi 10 a 20 minutami.
  • Pokud se síťový přepínač přepne ze stavu vypnuto do stavu zapnuto (nebo z wi-fi na stav mobilní zařízení), stavy opakování se resetují a žádosti se budou opakovat okamžitě.
  • Last updated on