Registrare eventi personalizzati per il Centro per i partner

  • Articolo

Il rapporto sull'utilizzo nel Centro per i partner ti consente di ottenere informazioni sugli eventi personalizzati che hai definito nell'app UWP (Universal Windows Platform). Un evento personalizzato è una stringa arbitraria che rappresenta un evento o un'attività nella tua app. Ad esempio, un gioco potrebbe definire eventi personalizzati denominati firstLevelPassed, secondLevelPassed, e così via, che vengono registrati quando l'utente supera ogni livello del gioco.

Per registrare un evento personalizzato dalla tua app, passa la stringa dell'evento personalizzato al metodo Log fornito da Microsoft Store Services SDK. È possibile esaminare il numero totale di occorrenze degli eventi personalizzati nella sezione Eventi personalizzati del report sull'utilizzo nel Centro per i partner

Nota

Gli eventi personalizzati registrati nel Centro per i partner non sono correlati agli eventi Windows, e non compaiono nel visualizzatore degli eventi.

Prerequisiti

Prima di poter esaminare gli eventi di registrazione personalizzati nel report di utilizzoper la tua app nel Centro per i partner, l'app deve essere pubblicata nello Store.

Come registrare eventi personalizzati

  1. Se non lo hai già fatto, installa Microsoft Store Services SDK sul tuo computer di sviluppo.

  2. Aprire il progetto in Visual Studio.

  3. In Esplora soluzioni, fare clic con il pulsante destro del mouse su Reference nodo per il tuo progetto e fai clic Aggiungi reference.

  4. In Reference Manager, espandi Universal Windows e fai clic su Extensions.

  5. Nell'elenco degli SDK, fai clic sulla casella di controllo accanto a Microsoft Engagement Framework e fai clic su OK.

  6. Aggiungi la seguente istruzione all'inizio di ogni file di codice in cui desideri registrare gli eventi personalizzati.

    using Microsoft.Services.Store.Engagement;

  7. In ogni sezione del codice in cui desideri registrare un evento personalizzato, ottieni un oggetto StoreServicesCustomEventLogger e quindi chiama il metodoLog. Passa la stringa dell'evento personalizzata al metodo.

    StoreServicesCustomEventLogger logger = StoreServicesCustomEventLogger.GetDefault();
logger.Log("myCustomEvent");

    Nota

    Il caricamento delrapporto di utilizzo potrebbe richiedere molto tempo se l'app registra molti eventi personalizzati con nomi lunghi. Ti consigliamo di utilizzare nomi brevi per i tuoi eventi personalizzati.