Megosztás a következőn keresztül:

App Center Analytics (Unity)

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.

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 a Unity Első lépések szakaszának utasításait.

Megjegyzés:

Az alább bemutatott API-k használatához a következő using utasítást kell hozzáadnia a .cs fájlhoz:

using Microsoft.AppCenter.Unity.Analytics;

Azt is meg kell győződnie, hogy a Use Analytics be van jelölve az App Center játékobjektumának beállításai között.

Munkamenet- és eszközinformációk

Miután hozzáadta az App Center Analyticset, és elindítja az SDK-t, 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. anélkül, hogy további kódot kellene használnia az alkalmazásban.

Egyéni események

A saját egyéni eseményeit akár 20 tulajdonsággal is nyomon követheti, hogy tudja, mi történik az alkalmazásban, megismerheti a felhasználói műveleteket, és megtekintheti az összesítéseket az App Center portálon.

Az TrackEvent() metódust használja az események tulajdonságokkal történő nyomon követésére. Legfeljebb 200 különböző eseménynevet küldhet el. Eseménynévenként legfeljebb 256 karakter, eseménytulajdonságonként 125 karakter lehet.

Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
});

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

Analytics.TrackEvent("Video clicked");

Figyelmeztetés

Analytics.TrackEvent() nem megfelelően fog viselkedni a platformokon, ha azt a Awake() szkript AppCenterBehavior.csmetódusa előtt hívják meg. A biztonság érdekében csak azokat az eseményeket érdemes használnia, amelyeket azután kell elküldeni, hogy az alkalmazás első jelenete felébresztette az MonoBehaviour összes szkriptet. Ha egy eseményt egy MonoBehavour inicializálással együtt szeretne nyomon követni, fontolja meg az API hozzáadását a Start() metódushoz a szkripthez, ahelyett hogy a Awake().

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 leállítja az alkalmazás elemzési adatainak gyűjtését. Az Analytics letiltásához használja a következő API-t, amely false paraméterként ad át.

Analytics.SetEnabledAsync(false);

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

Analytics.SetEnabledAsync(true);

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

Ez az API aszinkron, erről az App Center Aszinkron API-k útmutatójában olvashat bővebben.

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

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

bool isEnabled = await Analytics.IsEnabledAsync();

Esemény prioritása és megőrzése

Nyomon követheti az üzletileg kritikus eseményeket, amelyek nagyobb jelentőséggel bírnak, mint más események.

A fejlesztők beállíthatják az események megőrzését normálként (Flags.PersistenceNormal az API-ban) vagy kritikusként (Flags.PersistenceCritical az API-ban).

Az alábbi API-val kritikusként követheti nyomon az eseményeket:

Analytics.TrackEvent("eventName", Flags.PersistenceCritical);

Ha tulajdonságokat használ:

Analytics.TrackEvent("eventName", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
}, Flags.PersistenceCritical);

Naplók küldésének szüneteltetése és folytatása

Az eseményátvitel szüneteltetése olyan helyzetekben lehet hasznos, amikor az alkalmazásnak a hálózati sávszélességet kell szabályoznia az üzleti szempontból kritikusabb igények kielégítéséhez. Szüneteltetheti a naplók App Center-háttérrendszerbe való küldését. A szüneteltetéskor az események továbbra is nyomon követhetők és menthetők, de nem küldhetők el azonnal. Az alkalmazás által követett eseményeket, amelyek szünetelnek, csak akkor küldi el, miután a Analytics.Resume hívás megtörtént.

Analytics.Pause();
Analytics.Resume();

Ez az API aszinkron, erről az App Center Aszinkron API-k útmutatójában olvashat bővebben.

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.

  • Törölje a jelet a kézi munkamenet-követő engedélyezése jelölőnégyzetből a játékobjektum Elemzés szakaszában az AppCenterBehavior csatolásával.
  • Ezután használhatja a StartSession API-t a AppCenter.Start után.
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.
  • Last updated on