App Center Analytics (Apache Cordova)

Článek
03/15/2024

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í.

Sdílet prostřednictvím