App Center Analytics (React natív)

Fontos

A Visual Studio App Center 2025. március 31-én megszűnt, kivéve az Elemzési és diagnosztikai funkciókat, amelyek 2026. június 30-ig továbbra is támogatottak lesznek. Tudj meg többet.

• Android
• Ios
• React Native
• Windows
• MAUI/Xamarin
• Egység
• macOS
• tvOS-

Az App Center Analytics segít megérteni a felhasználói viselkedést és az ügyfelek bevonását az alkalmazás fejlesztéséhez. Az SDK automatikusan rögzíti a munkamenetek számát és az eszköz tulajdonságait, például a modellt, az operációs rendszer verzióját stb. Saját egyéni eseményeket is meghatározhat, hogy felmérje az Ön számára fontos dolgokat. Minden rögzített információ elérhető az App Center portálon az adatok elemzéséhez.

Ha még nem állította be az SDK-t az alkalmazásban, kövesse az Első lépések szakaszt .

Munkamenet- és eszközinformációk

Miután hozzáadta az App Center Analyticset az alkalmazáshoz, és az SDK elindult, automatikusan nyomon követi a munkameneteket és az eszköztulajdonságokat, például az operációs rendszer verzióját, modelljét stb.

Egyéni események

Akár 20 tulajdonsággal követheti nyomon saját egyéni eseményeit, hogy megértse a felhasználók és az alkalmazás közötti interakciót.

Miután elindította az SDK-t, a trackEvent metódussal tulajdonságokkal követheti nyomon az eseményeket. Legfeljebb 200 különböző eseménynevet küldhet el. Emellett legfeljebb 256 karakter lehet eseménynévként, eseménytulajdonság neveként és értékeként pedig 125 karakter.

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

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

Ez a függvény egy ígéretet ad vissza, a sikereset egy üres sztringet ad vissza, a hibaeset pedig a hibát.

Az események tulajdonságai nem kötelezőek; ha csak egy eseményt szeretne nyomon követni, használja inkább a következőt:

Analytics.trackEvent('Video clicked');

Az App Center Analytics engedélyezése vagy letiltása futásidőben

Az App Center Analytics futásidőben engedélyezhető és letiltható. Ha letiltja, az SDK nem gyűjt további elemzési adatokat az alkalmazáshoz.

await Analytics.setEnabled(false);

Ez a függvény egy olyan ígéretet ad vissza, amely érvénytelenné válik.

Az App Center Analytics ismételt engedélyezéséhez használja ugyanazt az API-t, de adja át true paraméterként.

await Analytics.setEnabled(true);

Az állapot megmarad az eszköz tárolójában az alkalmazásindítások során.

Ellenőrizze, hogy engedélyezve van-e az App Center Analytics

Azt is ellenőrizheti, hogy az App Center Analytics engedélyezve van-e.

const enabled = await Analytics.isEnabled();

Ez a függvény egy ígéretet (promise) ad vissza, amely egy boolean-ra oldódik fel.

Várja meg, amíg a JS engedélyezi az App Center Analyticset

Ha elemzési adatokat szeretne gyűjteni az alkalmazás felhasználói számára, de előbb felhasználói engedélyt szeretne kérni, akkor lehetősége van arra, hogy az indításkor ne engedélyezze az elemzéseket, hanem várja meg a megfelelő időpontot, és engedélyezze azt a JavaScriptben.

1. Nyissa meg a projekt ios/YourAppName/AppDelegate.m fájlját, és cserélje le a [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true];-et [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];-re.
2. Nyissa meg a projekt android/app/src/main/res/values/strings.xml fájlját, és cserélje le a <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string>-et <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>-re.

Ez azt jelenti, hogy az App Centerbe küldendő információk (akár alapszintű munkamenet-információk) esetében először engedélyeznie kell az App Center Analytics szolgáltatást a következő kódsor hozzáadásával:

await Analytics.setEnabled(true);

Indítási munkamenet kezelése

Alapértelmezés szerint a munkamenet-azonosító az alkalmazás életciklusától függ. Ha manuálisan szeretné szabályozni az új munkamenet kezdetét, kövesse a következő lépéseket:

Megjegyzés:

Figyelje meg, hogy az Analytics.StartSession() API minden egyes hívása új munkamenetet hoz létre. Ha manuális munkamenet-követő módban ez az API nem lesz meghívva, akkor az összes küldő napló null munkamenet-értékkel fog rendelkezni.

Megjegyzés:

Ügyeljen arra, hogy egy új alkalmazás elindítása után a munkamenet-azonosító újra létre lesz hozva.

Ha manuálisan szeretné konfigurálni az SDK-t a munkamenet nyomon követéséhez, a natív Analytics enableManualSessionTracker API-kat kell használnia:

• iOS-ban az alkalmazás delegate metódusában hívja meg a [MSACAnalytics enableManualSessionTracker];-t, mielőtt a [AppCenterReactNative register];-t didFinishLaunchingWithOptions. Adja hozzá @import AppCenterAnalytics , ha hiányzik a fájlból.

• Android rendszeren, a Analytics.enableManualSessionTracker(); metódusban hívja meg a SoLoader.init-t, mielőtt a onCreate hívna meg a MainApplication.java. Adja hozzá az com.microsoft.appcenter.analytics.Analytics importot, ha hiányzik a fájlból.

Ezután használhatja az startSession API-t a React natív projektjében:

Analytics.startSession();

Helyi tárterület mérete

Alapértelmezés szerint az SDK legfeljebb 10 MB naplót tárol a tárolóban.

Nincs internet-hozzáférés

Ha nincs hálózati kapcsolat, az SDK legfeljebb 10 MB naplót ment a helyi tárolóba. Miután megtelt a tárterület, az SDK elkezdi elvetni a régi naplókat, hogy helyet biztosítsunk az új naplóknak. Miután az eszköz visszakapta az internet-hozzáférést, az SDK 50 vagy 6 másodpercenként küld naplókat.

Eseménynaplók kötegelése

Az App Center SDK egy 50-ből álló kötegbe tölti fel a naplókat, és ha az SDK-nak nincs 50 elküldendő naplója, 6 másodperc után is elküldi a naplókat. Egyszerre legfeljebb három köteg küldhető el.

Újrapróbálkozási és visszalépési logika

Az App Center SDK támogatja a helyreállítható hálózati hibák visszalépési újrapróbálkozását. Az alábbiakban az újrapróbálkozás logikája látható:

• Kérésenként legfeljebb 3 próbálkozás.
• Minden kérelemnek megvan a saját újrapróbálkozási állapotgépe.
• Az összes átviteli csatorna le van tiltva (a következő alkalmazásfolyamatig), miután egy kérés kimeríti az összes újrapróbálkozást.

Visszalépési mechanizmus

• 50% véletlenszerűség, első próbálkozás 5 és 10 között, második újrapróbálkozás 2,5 és 5 perc között, utolsó próbálkozás 10 és 20 perc között.
• Ha a hálózat kikapcsolt állapotból bekapcsolt állapotba vált (vagy wi-fi-ról mobilra), az újrapróbálkozási állapotok alaphelyzetbe állítódnak, és a kérések azonnal újra megkísérelnek.