App Center Analytics (Unity)
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 .
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.
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 MonoBehavour
inicializací, zvažte přidání rozhraní API do metody skriptu Start()
místo Awake()
do .
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 .
Můžete také zkontrolovat, jestli je služba App Center Analytics povolená nebo ne.
bool isEnabled = await Analytics.IsEnabledAsync();
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í 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 .
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();
Ve výchozím nastavení sada SDK ukládá do úložiště až 10 MB protokolů.
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.
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.
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í.