Aktivieren von In-App-Produktkäufen

Unabhängig davon, ob Ihre App kostenlos ist oder nicht, können Sie Inhalte, andere Apps oder neue App-Funktionen (z. B. das Entsperren der nächsten Stufe eines Spiels) direkt innerhalb der App verkaufen. Hier zeigen wir Ihnen, wie Sie diese Produkte in Ihrer App aktivieren.

Voraussetzungen

• Eine Windows-App, in der Kunden Features zum Kauf hinzufügen können.
• Wenn Sie neue In-App-Produkte zum ersten Mal codieren und testen, müssen Sie das CurrentAppSimulator-Objekt anstelle des CurrentApp-Objekts verwenden. Auf diese Weise können Sie Ihre Lizenzlogik mithilfe simulierter Aufrufe an den Lizenzserver überprüfen, anstatt den Liveserver aufzurufen. Dazu müssen Sie die Datei namens WindowsStoreProxy.xml in %userprofile%\AppData\local\packages\<paketname>\LocalState\Microsoft\Windows Store\ApiData anpassen. Der Microsoft Visual Studio-Simulator erstellt diese Datei, wenn Sie Ihre App zum ersten Mal ausführen, oder Sie können auch eine benutzerdefinierte Zur Laufzeit laden. Weitere Informationen finden Sie unter Verwenden der WindowsStoreProxy.xml-Datei mit CurrentAppSimulator.
• In diesem Thema wird auch auf Codebeispiele verwiesen, die im Store-Beispiel bereitgestellt werden. Dieses Beispiel ist eine hervorragende Möglichkeit, praktische Erfahrungen mit den verschiedenen Monetarisierungsoptionen zu erhalten, die für Universelle Windows-Plattform -Apps (UWP) bereitgestellt werden.

Schritt 1: Initialisieren der Lizenzinformationen für Ihre App

Rufen Sie beim Initialisieren der App das LicenseInformation-Objekt für Ihre App ab, indem Sie " CurrentApp " oder "CurrentAppSimulator" initialisieren , um Einkäufe eines In-App-Produkts zu aktivieren.

void InitializeApp()
{
    // Some app initialization code...

    // Initialize the license info for use in the app that is uploaded to the Store.
    // Uncomment the following line in the release version of your app.
    //   licenseInformation = CurrentApp.LicenseInformation;

    // Initialize the license info for testing.
    // Comment the following line in the release version of your app.
    licenseInformation = CurrentAppSimulator.LicenseInformation;

    // Other app initialization code...
}

Schritt 2: Hinzufügen der In-App-Angebote zu Ihrer App

Erstellen Sie für jedes Feature, das Sie über ein In-App-Produkt verfügbar machen möchten, ein Angebot, und fügen Sie es Ihrer App hinzu.

1. Erstellen eines In-App-Angebotstokens

   Sie identifizieren jedes In-App-Produkt in Ihrer App anhand eines Tokens. Dieses Token ist eine Zeichenfolge, die Sie in Ihrer App und im Store definieren und verwenden, um ein bestimmtes In-App-Produkt zu identifizieren. Weisen Sie ihr einen eindeutigen (für Ihre App) und einen aussagekräftigen Namen zu, damit Sie schnell das richtige Feature identifizieren können, das sie während der Codierung darstellt. Hier sind einige Beispiele für Namen:

   • "SpaceMissionLevel4"
   • "ContosoCloudSave"
   • "RainbowThemePack"

2. Codierung des Features in einem bedingten Block

   Sie müssen den Code für jedes Feature, das einem In-App-Produkt zugeordnet ist, in einem bedingten Block platzieren, der überprüft, ob der Kunde über eine Lizenz für die Verwendung dieses Features verfügt.

   Hier ist ein Beispiel, das zeigt, wie Sie ein Produktfeature namens "featureName " in einem lizenzspezifischen bedingten Block codieren können. Die Zeichenfolge " featureName" ist das Token, das dieses Produkt innerhalb der App eindeutig identifiziert und auch verwendet wird, um es im Store zu identifizieren.

   if (licenseInformation.ProductLicenses["featureName"].IsActive)
   {
       // the customer can access this feature
   }
   else
   {
       // the customer can' t access this feature
   }
   

3. Hinzufügen der Einkaufs-UI für dieses Feature

   Ihre App muss ihren Kunden auch die Möglichkeit bieten, das Produkt oder feature des In-App-Produkts zu erwerben. Sie können sie nicht über den Store auf die gleiche Weise erwerben, wie sie die vollständige App erworben haben.

   Hier erfahren Sie, wie Sie testen, ob Ihr Kunde bereits über ein In-App-Produkt verfügt und wenn dies nicht der Fehler ist, das Kaufdialogfeld anzeigt, damit er es kaufen kann. Ersetzen Sie den Kommentar "Dialogfeld "Kauf anzeigen" durch Ihren benutzerdefinierten Code für das Kaufdialogfeld (z. B. eine Seite mit einer freundlichen Schaltfläche "Diese App kaufen!").

   async void BuyFeature()
   {
       if (!licenseInformation.ProductLicenses["featureName"].IsActive)
       {
           try
           {
               // The customer doesn't own this feature, so
               // show the purchase dialog.
               await CurrentAppSimulator.RequestProductPurchaseAsync("featureName", false);
   
               //Check the license state to determine if the in-app purchase was successful.
           }
           catch (Exception)
           {
               // The in-app purchase was not completed because
               // an error occurred.
           }
       }
       else
       {
           // The customer already owns this feature.
       }
   }
   

Schritt 3: Ändern des Testcodes in die endgültigen Aufrufe

Dies ist ein einfacher Schritt: Ändern Sie jeden Verweis auf CurrentAppSimulator in CurrentApp im App-Code. Sie müssen die WindowsStoreProxy.xml Datei nicht mehr angeben. Entfernen Sie sie daher aus dem Pfad Ihrer App (obwohl Sie sie möglicherweise zur Referenz speichern möchten, wenn Sie das In-App-Angebot im nächsten Schritt konfigurieren).

Schritt 4: Konfigurieren des In-App-Produktangebots im Store

Navigieren Sie im Partner Center zu Ihrer App, und erstellen Sie ein Add-On , das Ihrem In-App-Produktangebot entspricht. Definieren Sie die Produkt-ID, den Typ, den Preis und andere Eigenschaften für Ihr Add-On. Stellen Sie sicher, dass Sie sie identisch mit der Konfiguration konfigurieren, die Sie beim Testen in WindowsStoreProxy.xml festgelegt haben.

Hinweise

Wenn Sie Ihren Kunden konsumierbare In-App-Produktoptionen bereitstellen möchten (Artikel, die gekauft, verwendet und dann bei Bedarf erneut erworben werden können), wechseln Sie zum Thema "Konsumierbare In-App-Produktkäufe aktivieren".

Wenn Sie Bestätigungen verwenden müssen, um zu überprüfen, ob der Benutzer einen In-App-Kauf getätigt hat, überprüfen Sie die Verwendungsbestätigungen, um Produktkäufe zu überprüfen.

Zugehörige Themen

• Aktivieren von konsumierbaren In-App-Produktkäufen
• Verwalten eines großen Katalogs von In-App-Produkten
• Verwenden von Bestätigungen zum Überprüfen von Produktkäufen
• Store-Beispiel (veranschaulicht Testversionen und In-App-Käufe)