In-App-Käufe

Microsoft Teams stellt APIs zur Verfügung, mit denen Sie die In-App-Käufe implementieren können, um ein Upgrade von kostenlosen auf kostenpflichtige Teams-Apps durchzuführen. Mit In-App-Käufen können Sie Benutzer direkt aus Ihrer App von kostenlosen in kostenpflichtige Pläne konvertieren.

In-App-Käufe ermöglichen Es Benutzern, ein neues kostenpflichtiges Abonnement zu erwerben, und sie ermöglichen es den Benutzern nicht, zusätzliche oder andere Lizenzen mit vorhandenen kostenpflichtigen Abonnements zu erwerben. Um zwischen Plänen zu wechseln, muss ein vorhandenes Benutzerabonnement gekündigt werden, bevor ein neues Abonnement über In-App-Käufe erworben werden kann.

Hinweis

In-App-Käufe werden nur in persönlichen App-Kontexten unterstützt.

Implementieren von In-App-Käufen

Um den Benutzern Ihrer App eine In-App-Kauferfahrung zu bieten, stellen Sie Folgendes sicher:

• Die App wird mit der Microsoft Teams JavaScript-Clientbibliothek (TeamsJS) erstellt.

• Die App ist mit einem transaktionsfähigen SaaS-Angebot aktiviert.

• Die App ist mit RSC-Berechtigungen aktiviert.

• Die App wird mit der openPurchaseExperience-API aufgerufen.

Die In-App-Kauferfahrung kann entweder durch Aktualisieren der Datei manifest.json oder durch Aktivieren von In-App-Kaufangebote anzeigen im Abschnitt Berechtigungen Ihres Entwicklerportals aktiviert werden.

Aktualisieren des Manifests

Um die In-App-Kauferfahrung zu aktivieren, aktualisieren Sie Ihre Teams-App-Datei manifest.json, indem Sie die RSC-Berechtigungen hinzufügen. Dies ermöglicht Ihren App-Benutzern, ein Upgrade auf eine kostenpflichtige Version Ihrer App durchzuführen und neue Funktionalitäten zu verwenden. Das Update für das App-Manifest lautet wie folgt:

"authorization": {
    "permissions": {
        "resourceSpecific": [
            {
                "name": "InAppPurchase.Allow.User",
                "type": "Delegated"
            }
        ]
    }
}

Kauferfahrungs-API

Rufen Sie die openPurchaseExperience-API über Ihre Web-App auf, um In-App-Käufe für die App auszulösen.

Der folgende Codeausschnitt ist ein Beispiel für das Aufrufen der API aus der Teams-App, die mithilfe der Microsoft Teams JavaScript-Clientbibliothek erstellt wurde:

TeamsJS v1

<div> 
<div class="sectionTitle">openPurchaseExperience</div>
<button onclick="openPurchaseExperience()">openPurchaseExperience</button>
</div>
</body>
<script>
   function openPurchaseExperience()
      microsoftTeams.initialize();
      let callbackcalled = false;
      microsoftTeams.monetization.openPurchaseExperience((e) => {
            console.log("callback is being called");
            console.log(e);
            if (!!e && typeof e !== "string") {
                  alert(JSON.stringify(e));
              }
              return;
            });
      console.log("after callback: ",callbackcalled);
    }
</script>

TeamsJS v2

<div>
<div class="sectionTitle">openPurchaseExperience</div>
<button onclick="openPurchaseExperience()">openPurchaseExperience</button>
</div>
</body>
<script>
    function openPurchaseExperience() {
      micorosftTeams.app.initialize();
      var planInfo = {
          planId: "<Plan id>", // Plan Id of the published SAAS Offer
          term: "<Plan Term>" // Term of the plan.
      }
      monetization.openPurchaseExperience(planInfo);
    }
</script>

Nächster Schritt

Testvorschau für monetarisierte Apps