App Center Analytics (Unity)

  • Článek

Důležité

Visual Studio App Center je naplánované k vyřazení na 31. března 2025. I když můžete Visual Studio App Center dál používat, dokud ho úplně nevyřadíte, existuje několik doporučených alternativ, na které můžete migraci zvážit.

Přečtěte si další informace o časových osách a alternativách podpory.

App Center Analytics pomáhá porozumět 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 a měřit věci, na kterých vám záleží. Všechny zachycené informace jsou k dispozici na portálu App Center, kde můžete analyzovat data.

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

Poznámka

Pokud chcete použít níže uvedená rozhraní API, musíte do souboru .cs přidat následující using 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 analýzu App Center a spustíte sadu SDK, bude se automaticky sledovat relace a vlastnosti zařízení, jako je verze operačního systému, model atd., aniž by se v aplikaci vyžadoval další kód.

Vlastní události

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

Ke sledování událostí pomocí vlastností použijte metodu TrackEvent() . Můžete odeslat až 200 různý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 událost jenom sledovat, použijte místo toho tuto ukázku:

Analytics.TrackEvent("Video clicked");

Upozornění

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

Povolení nebo zakázání App Center Analytics za běhu

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

Analytics.SetEnabledAsync(false);

Pokud chcete analýzu App Center znovu povolit, použijte stejné rozhraní API, ale předejte true ho jako parametr.

Analytics.SetEnabledAsync(true);

Stav se během spouštění aplikací zachová v úložišti zařízení.

Toto rozhraní API je asynchronní. Další informace najdete v průvodci asynchronními rozhraními API app center .

Kontrola, jestli je povolená analýza app center

Můžete také zkontrolovat, jestli je služba App Center Analytics povolená nebo ne.

bool isEnabled = await Analytics.IsEnabledAsync();

Priorita a trvalost událostí

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);

Pokud 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ž se události pozastaví, dají se dál sledovat a ukládat, ale neodesílají se hned. Všechny události, které vaše aplikace sleduje, když je pozastavená, se odešlou jenom po zavolání Analytics.Resume.

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

Toto rozhraní API je asynchronní. Další informace najdete v průvodci asynchronními rozhraními API app center .

Spravovat úvodní relaci

ID relace ve výchozím nastavení závisí na životním cyklu aplikace. Pokud chcete řídit zahájení nové relace ručně, 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 se v režimu ručního sledování relací toto rozhraní API nebude volat, budou mít všechny odesílající protokoly hodnotu relace s hodnotou null.

Poznámka

Věnujte pozornost tomu, že po spuštění nové aplikace se ID relace znovu vygeneruje.

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

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

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

Bez přístupu k internetu

Pokud není k dispozici žádné připojení k síti, sada SDK uloží do místního úložiště až 10 MB protokolů. Jakmile se úložiště zaplní, sada SDK začne zahazovat staré protokoly, aby uvolnila místo pro nové protokoly. Jakmile zařízení získá přístup k internetu, sada SDK bude odesílat protokoly v dávce 50 nebo po každých 6 sekundách.

Dávkování protokolů událostí

Sada App Center SDK nahrává protokoly v dávce 50, a pokud sada SDK nemá 50 protokolů k odeslání, bude protokoly odesílat i po 6 sekundách. Paralelně se můžou odesílat maximálně tři dávky.

Logika opakování a opakování

Sada App Center SDK podporuje opakované pokusy se zpětným ukončením při obnovitelných chybách sítě. Níže je logika opakování:

  • Maximální počet pokusů na požadavek: 3.
  • Každý požadavek má svůj vlastní počítač se stavem opakování.
  • Všechny přenosové kanály jsou zakázané (až do dalšího procesu aplikace) poté, co jeden požadavek vyčerpá všechny pokusy.

Logika zásady

  • 50% randomizace, první opakování mezi 5 a 10s, druhé opakování mezi 2,5 a 5 minutami, poslední pokus mezi 10 a 20 minutami.
  • Pokud se síť přepne z vypnutého na zapnuto (nebo z wi-fi na mobilní zařízení), stavy opakování se resetují a žádosti se okamžitě opakují.