Protokollieren benutzerdefinierter Ereignisse im Partner Center

  • Artikel

Mit dem Nutzungsbericht in Partner Center können Sie Informationen zu benutzerdefinierten Ereignissen abrufen, 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 repräsentiert. Beispielsweise kann ein Spiel benutzerdefinierte Ereignisse mit den Bezeichnungen FirstLevelPassed, SecondLevelPassedusw. definieren, die protokolliert werden, wenn der Benutzer die einzelnen Levels des Spiels durchläuft.

Um ein benutzerdefiniertes Ereignis aus Ihrer App zu protokollieren, übergeben Sie die Zeichenfolge des benutzerdefinierten Ereignisses an die Log-Methode des Microsoft Store Services SDK. Sie können die Gesamtereignisse für Ihre benutzerdefinierten Ereignisse im Abschnitt Benutzerdefinierte Ereignisse des Berichts Nutzung in Partner Center überprüfen.

Hinweis

Benutzerdefinierte Ereignisse, die Sie bei Partner Center protokollieren, beziehen sich nicht auf Windows-Ereignisse 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.

Protokollieren von benutzerdefinierten Ereignissen

  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 im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verweise für Ihr Projekt, und wählen Sie anschließend Verweis hinzufügen aus.

  4. Erweitern Sie im Verweis-Manager die Option Universelle Windows-App, und klicken Sie auf Erweiterungen.

  5. Klicken Sie in der Liste der SDKs auf das Kontrollkästchen neben Microsoft Engagement Framework und anschließend 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 Protokoll-Methode auf. Übergeben Sie die Zeichenfolge für das benutzerdefinierte Ereignis an die Methode.

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

    Hinweis

    Das Laden des Nutzungsberichts kann lange dauern, wenn Ihre App viele benutzerdefinierte Ereignisse mit langen Namen protokolliert. Es wird empfohlen, kurze Namen für Ihre benutzerdefinierten Ereignisse zu verwenden.