Konfigurieren von In-App-Käufen

In-App-Käufe sind Upgradeoptionen, bei denen Benutzer in Ihrer App ein Upgrade von kostenlosen auf kostenpflichtige Pläne durchführen können. Microsoft Teams bietet APIs zum Implementieren von In-App-Käufen. Die In-App-Kaufoption gilt nur, wenn die App mit einem transaktionsfähigen SaaS-Angebot aktiviert ist.

Benutzer können neue kostenpflichtige Abonnements über In-App-Käufe erwerben. Sie können jedoch keine zusätzlichen oder anderen Lizenzen mit vorhandenen kostenpflichtigen Abonnements erwerben. Um Pläne zu ändern, müssen Benutzer zuerst ihr aktuelles Abonnement kündigen, bevor sie einen neuen Plan durch In-App-Käufe erwerben.

Hinweis

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

Implementieren von In-App-Käufen

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind, um Ihren App-Benutzern eine In-App-Kauferfahrung zu ermöglichen:

• Die App wird mithilfe 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.

Aktivieren des In-App-Kaufs

Sie können die In-App-Käufe auf eine der folgenden Arten aktivieren:

Update über das Entwicklerportal

1. Wechseln Sie im Teams-Entwicklerportal zu Berechtigungen.
2. Aktivieren Sie In-App-Kaufangebote anzeigen.

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. Sie ermöglicht Es Ihren App-Benutzern, ein Upgrade auf eine kostenpflichtige Version Ihrer App durchzuführen und auf neue Features zuzugreifen. Aktualisieren Sie das App-Manifest wie im folgenden Codeausschnitt angegeben:

    
    "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 den Aufruf der API aus der Teams-App, die mit TeamsJS erstellt wurde:

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>

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>

Siehe auch

• Monetarisieren Ihrer App
• App-Manifest