App Center Analytics (React Native)

  • Článek

Důležité

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

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

App Center Analytics vám pomůže porozumět chování uživatelů a zapojení zákazníků, aby se vaše aplikace zlepšila. 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 ještě sadu SDK ve své aplikaci nenastavili, postupujte podle části Začínáme .

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

Jakmile do aplikace přidáte App Center Analytics a spustí se sada SDK, automaticky sleduje relace a vlastnosti zařízení, jako je verze operačního systému, model atd.

Vlastní události

Sledujte vlastní události s až 20 vlastnostmi , abyste porozuměli interakci mezi uživateli a aplikací.

Po spuštění sady SDK použijte metodu trackEvent ke sledování událostí pomocí vlastností. Můžete odeslat až 200 jedinečných názvů událostí. Platí také maximální limit 256 znaků na název události a 125 znaků na název vlastnosti události a hodnotu vlastnosti události.

// import App Center Analytics at the top of the file.
import Analytics from 'appcenter-analytics';

Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' });

Tato funkce vrátí příslib, případ úspěchu vrátí prázdný řetězec a případ chyby vrátí chybu.

Vlastnosti pro události jsou volitelné; Pokud chcete jenom sledovat událost, použijte místo toho toto:

Analytics.trackEvent('Video clicked');

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 nebude pro aplikaci shromažďovat žádné další analytické informace.

await Analytics.setEnabled(false);

Tato funkce vrátí příslib, který se přeloží na hodnotu void.

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

await Analytics.setEnabled(true);

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

Kontrola, jestli je služba App Center Analytics povolená

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

const enabled = await Analytics.isEnabled();

Tato funkce vrátí příslib, který se přeloží na boolean.

Počkejte, až JS povolí App Center Analytics.

Pokud chcete shromažďovat analytické informace pro uživatele aplikace, ale chcete nejprve získat oprávnění uživatele, máte možnost nepovolit analýzu při spuštění, ale počkat na správnou dobu a povolit ji v JavaScriptu.

  1. Otevřete soubor projektu a nahraďte [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true]; ho ios/YourAppName/AppDelegate.m[AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];názvem .
  2. Otevřete soubor projektu a nahraďte <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string> ho android/app/src/main/res/values/strings.xml<string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>názvem .

To znamená, že aby se do App Center odesílaly jakékoli informace (i základní informace o relacích), musíte nejprve povolit App Center Analytics přidáním následujícího řádku kódu:

await Analytics.setEnabled(true);

Správa úvodní relace

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í nebude toto rozhraní API volat, budou mít všechny odesílající protokoly hodnotu relace null.

Poznámka

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

Pokud chcete sadu SDK nakonfigurovat pro sledování relací ručně, musíte použít nativní rozhraní API pro analýzu enableManualSessionTracker :

  • V iOSu volejte [MSACAnalytics enableManualSessionTracker]; před [AppCenterReactNative register]; v metodě delegáta didFinishLaunchingWithOptions aplikace v AppDelegate.m. Přidejte @import AppCenterAnalytics , pokud v souboru chybí.

  • V Androidu zavolejte Analytics.enableManualSessionTracker(); před metodou v onCreateMainApplication.java.SoLoader.init Přidejte import com.microsoft.appcenter.analytics.Analytics , pokud v souboru chybí.

Pak můžete rozhraní API použít startSession v projektu React Native:

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ů. Po zaplnění úložiště začne sada SDK zahazovat staré protokoly, aby uvolnila 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.

Dávkové protokoly 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 zpětného vypnutí

Sada App Center SDK podporuje opakované pokusy o obnovení v síti. Níže je logika opakování:

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

Logika zálohování

  • 50% randomizace, první opakování mezi 5s 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é na zapnuto (nebo z wi-fi na mobilní), stavy opakování se resetují a žádosti se okamžitě opakují.