Protokollieren benutzerdefinierter Ereignisse im Partner Center

  • Artikel

Im Bericht "Nutzung" im Partner Center erhalten Sie Informationen zu benutzerdefinierten Ereignissen, die Sie in Ihrer Universelle Windows-Plattform -App (UWP) definiert haben. Ein benutzerdefiniertes Ereignis ist eine beliebige Zeichenfolge, die ein Ereignis oder eine Aktivität in Ihrer App darstellt. Beispielsweise kann ein Spiel benutzerdefinierte Ereignisse namens firstLevelPassed, secondLevelPassed usw. definieren, die protokolliert werden, wenn der Benutzer jedes Level im Spiel übergibt.

Um ein benutzerdefiniertes Ereignis aus Ihrer App zu protokollieren, übergeben Sie die benutzerdefinierte Ereigniszeichenfolge an die Log-Methode , die vom Microsoft Store Services SDK bereitgestellt wird. Sie können die Gesamtvorkommnisse für Ihre benutzerdefinierten Ereignisse im Abschnitt "Benutzerdefinierte Ereignisse " des Nutzungsberichts im Partner Center überprüfen.

Hinweis

Benutzerdefinierte Ereignisse, die Sie beim Partner Center protokollieren, sind nicht mit Windows-Ereignissen verknüpft und werden nicht in Ereignisanzeige angezeigt.

Voraussetzungen

Bevor Sie benutzerdefinierte Protokollierungsereignisse im Nutzungsbericht für Ihre App im Partner Center überprüfen können, muss Ihre App im Store veröffentlicht werden.

So protokollieren Sie benutzerdefinierte Ereignisse

  1. Falls noch nicht geschehen, installieren Sie das Microsoft Store Services SDK auf Ihrem Entwicklungscomputer.

  2. Öffnen Sie Ihr Projekt in Visual Studio.

  3. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf den Knoten "Verweise" für Ihr Projekt, und klicken Sie auf "Verweis hinzufügen".

  4. Erweitern Sie im Verweis-Manager universelle Windows-Geräte, und klicken Sie auf Erweiterungen.

  5. Klicken Sie in der Liste der SDKs auf das Kontrollkästchen neben Microsoft Engagement Framework , und klicken Sie auf OK.

  6. Fügen Sie die folgende Anweisung am Anfang jeder Codedatei hinzu, in der Sie benutzerdefinierte Ereignisse protokollieren möchten.

    using Microsoft.Services.Store.Engagement;

  7. Rufen Sie in jedem Abschnitt Des Codes, in dem Sie ein benutzerdefiniertes Ereignis protokollieren möchten, ein StoreServicesCustomEventLogger-Objekt ab, und rufen Sie dann die Log-Methode auf. Übergeben Sie die benutzerdefinierte Ereigniszeichenfolge an die Methode.

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

    Hinweis

    Der Verwendungsbericht kann lange dauern, bis die App viele benutzerdefinierte Ereignisse mit langen Namen protokolliert. Es wird empfohlen, kurze Namen für Ihre benutzerdefinierten Ereignisse zu verwenden.