App Center Analytics (Apache Cordova)

  • Č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.

Poznámka

Podpora aplikací Cordova skončila v dubnu 2022. Další informace najdete v blogu App Center.

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, bude automaticky sledovat relace a vlastnosti zařízení, jako je verze operačního systému, model atd.

Vlastní události

Můžete sledovat 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.

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}
AppCenter.Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' }, success, error);

Tato funkce používá třetí parametr jako úspěšné volání, který vrací prázdný řetězec a čtvrtý parametr jako zpětné volání chyby, která vrací chybu.

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

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.trackEvent('Video clicked', success, error);

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 už nebude shromažďovat analytické informace pro aplikaci.

var success = function() {
    console.log("Analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(false, success, error);

Tato funkce používá druhý parametr jako úspěšné volání, které vrací prázdný řetězec a třetí parametr jako zpětné volání chyby, která vrací chybu. Pokud chcete znovu povolit App Center Analytics, použijte stejné rozhraní API, ale předejte true ho jako parametr.

var success = function() {
    console.log("Analytics enabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

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 povolená analýza App Center.

var success = function(result) {
    console.log("analytics " + (result) ? "enabled" : "disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.isEnabled(success, error);

Tato funkce používá první parametr jako zpětné volání úspěchu, který vrací boolean a druhý parametr jako zpětné volání chyby, která vrací chybu.

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

V některých případech se aplikace může chtít zeptat uživatelů, jestli chtějí sdílet analytické informace. V takovém případě byste měli změnit předvolbu APPCENTER_ANALYTICS_ENABLE_IN_JS na true v config.xml

<preference name="APPCENTER_ANALYTICS_ENABLE_IN_JS" value="true" />

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

var success = function() {
    console.log("analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

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 3 sekundách.

Dávkové protokoly událostí

Sada App Center SDK nahraje protokoly v dávce 50, a pokud sada SDK nemá 50 protokolů k odeslání, bude protokoly odesílat i po 3 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í.