In-App-Käufe-API

Verkaufe digitale Güter und Abonnements in deiner iOS-WebView-App mit StoreKit-basierten In-App-Käufen.

Innerhalb mancher Apps kannst du zusätzliche Inhalte oder Dienste erwerben. Solche Käufe werden als "In-App-Käufe" bezeichnet. Sie können für Entwickler eine attraktive Einnahmequelle darstellen und sind für Kunden sehr komfortabel, da sie zur Abwicklung bereits vorhandene Konten und Zahlungsquellen nutzen. WebViewGold ermöglicht das Auslösen von App Store In-App-Käufen. Stelle sicher, dass du eine Extended License von WebViewGold besitzt, wenn du diese Funktion in einem Endprodukt verwenden möchtest. Möchtest du ein Upgrade durchführen? Erfahre hier, wie du ein Upgrade durchführst.

Option 1 (Standard): RevenueCat

Erstelle dein kostenloses RevenueCat-Konto, um zu beginnen. Preisinformationen sind auf deren Website verfügbar. Richte RevenueCat anschließend gemäß deren Einrichtungsassistenten und Dokumentation ein (Preisdetails findest du auf deren Website). Füge danach deine Daten in Config.swift ein. Dieser Ansatz unterstützt außerdem das 15% Service Fee Tier Program des Google Play Store und Apples Small Business Program. Wenn du an diesen Programmen mit reduzierten Gebühren teilnimmst, informiere RevenueCat über deren Seiten Apple Small Business Program oder Google 15% reduced service fee. So sieht die Einrichtung in Config.swift aus:

static let kRevenueCatEnable = true //Set to true to activate RevenueCat
static let kRevenueCatShowDefaultOfferingPaywall = true //Set to true to show the default offering paywall on app launch
static let revenueCatAPIKey = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" //Your RevenueCat API Key (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/api-key-revenuecat how to find it)
static let revenueCatProjectID = "xxxxxxxxx" //Your RevenueCat Project ID (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/project-id-revenuecat how to find it)

Stelle sicher, dass deine Bundle ID in Xcode und App Store Connect mit dem in RevenueCat konfigurierten Projekt übereinstimmt. Löse einen Kauf oder ein Abonnement wie folgt aus:

revenuecat://purchase?external_id=user_123&product=sub_30_days

external_id = Nutzerkennung, z. B. die E-Mail-Adresse deines Kunden oder die Benutzer-ID. product = ID, die in der RevenueCat-Konsole angezeigt wird.

Du kannst außerdem direkt aus deiner Web-App eine native RevenueCat-Paywall anzeigen (konfiguriert im RevenueCat-Dashboard) – erfordert iOS 15 oder höher:

revenuecat://launchPaywall?external_id=user_123&offering=CustomOfferingOne

external_id = Nutzerkennung, z. B. die E-Mail-Adresse deines Kunden oder die Benutzer-ID (erforderlich). offering = Optionale Kennung des RevenueCat-Offerings, dessen Paywall angezeigt werden soll; lasse den Parameter weg, um die Paywall des Standard-Offerings zu präsentieren.

Option 2: Manuell (ohne RevenueCat)

Füge im ersten Schritt die App Store Connect-Details deines "Shared Secret" für In-App-Käufe in die Datei Config.swift ein. Um dein "Shared Secret" in App Store Connect zu finden, musst du dich zunächst in dein App Store Connect-Konto einloggen. Gehe dann zum Abschnitt "Users and Access" und wähle den Reiter "Shared Secret". Dein generiertes "Shared Secret" wird aufgelistet, und du kannst es kopieren und in das entsprechende Feld "IAPSharedSecret" in Config.swift von WebViewGold einfügen.

Uns liegt der Erfolg unserer Kunden am Herzen, und wir sind hier, um sie in jeder Hinsicht zu unterstützen: Aus diesem Grund möchten wir hier auf das App Store Small Business Program und das 15% Service Fee Tier Program des Google Play Store hinweisen. Im Rahmen dieser Programme können sich qualifizierte Entwickler für eine reduzierte Provision von 15 % anstelle der üblichen 30 % qualifizieren. Das Ausfüllen der Formulare dauert nur wenige Minuten und kann dir potenziell 50 % der Gebühren sparen (Reduzierung der Provision von 30 % auf 15 %). Sobald du zugelassen bist, erhältst du den reduzierten Provisionssatz für alle kostenpflichtigen Apps und In-App-Käufe, die Kunden in den jeweiligen Stores tätigen. Weitere Informationen zum Apple-Programm findest du hier und zum Google Play-Programm hier.

Verlinke nach der Einrichtung für In-App-Kaufprodukte einfach auf eine URL dieser Art:

<a href="inapppurchase://?package=IN-APP_PURCHASE_PRODUCT_IDENTIFIER&disableadmob=true&successful_url=https://www.google.com">Buy In-App Purchase</a>

• Das "package" ist die Produktkennung des Artikels, den du verkaufen möchtest.
• Die "successful_url" ist die URL, die die App nach Abschluss des Kaufs laden soll.
  • Du kannst auf dieser Seite ein Cookie speichern, damit sich deine Web-App merkt, dass der Kauf getätigt wurde.
• Füge "disableadmob=true" hinzu, wenn du AdMob-Anzeigen nach dem Kauf des Produkts deaktivieren möchtest.

<a href="inappsubscription://?package=IN-APP_PURCHASE_PRODUCT_IDENTIFIER&expired_url=https://www.yahoo.com&successful_url=https://www.google.com">Start In-App Subscription</a>

• Das "package" ist die Produktkennung des Abonnements, das du verkaufen möchtest.
• Die "successful_url" ist die URL, die die App nach Abschluss des Kaufs laden soll.
  • Du kannst auf dieser Seite ein Cookie speichern, damit sich deine Web-App merkt, dass das Abonnement aktiviert wurde.
• Die "expired_url" ist die URL, die die App laden soll, sobald das Abonnement nicht mehr gültig ist.
  • Du kannst auf dieser Seite ein Cookie aktualisieren/löschen, damit sich deine Web-App merkt, dass das Abonnement deaktiviert wurde.

<script>
// Utility function to wait for a variable to be defined
function waitForVariable(variableName, callback, timeout = 5000) {
    const startTime = Date.now();

    (function checkVariable() {
        if (window[variableName] !== undefined) {
            callback(window[variableName]);
        } else if (Date.now() - startTime < timeout) {
            setTimeout(checkVariable, 100);
        } else {
            console.error(`Timeout: ${variableName} was not set within ${timeout} ms`);
        }
    })();
}

// Example: Handling In-App Purchase/Subscription variables
waitForVariable("planID", function(planID) {
    console.log("planID:", planID);
    // Send the Product ID to your server
    sendToServer("planID", planID);
});

waitForVariable("transactionIdentifier", function(transactionIdentifier) {
    console.log("transactionIdentifier:", transactionIdentifier);
    // Send the Transaction ID to your server
    sendToServer("transactionIdentifier", transactionIdentifier);
});

waitForVariable("subreceipts", function(subreceipts) {
    console.log("subreceipts:", subreceipts);
    // Send Subscription Receipt IDs to your server
    sendToServer("subreceipts", subreceipts);
});

// Function to send data to your server for validation
function sendToServer(key, value) {
    fetch("https://example.com/api/validate", {
        method: "POST",
        headers: {
            "Content-Type": "application/json"
        },
        body: JSON.stringify({ [key]: value })
    })
    .then(response => response.json())
    .then(data => console.log(`Server Response for ${key}:`, data))
    .catch(error => console.error(`Error sending ${key}:`, error));
}
</script>

Käufe wiederherstellen: Ein Aufruf von restoreinapppurchases:// ermöglicht es deiner App, zuvor gekaufte Inhalte wieder zu aktivieren. Wenn ein Nutzer auf einen Link mit diesem URL-Schema tippt, startet die App einen Vorgang zur erneuten Validierung und Wiederherstellung von In-App-Käufen — ideal für Szenarien wie eine Neuinstallation der App oder einen Gerätewechsel. Füge einfach einen Link wie den folgenden hinzu, damit deine Nutzer ihre Käufe wiederherstellen können:

<a href="restoreinapppurchases://">Restore Purchases</a>

Kaufhistorie: Wie du die bisherigen Käufe des Nutzers in deiner Web-App anzeigst, erfährst du unter In-App-Purchase-History-API (getpurchasehistory://).

Abonnement kündigen: Ein Aufruf von cancelinapppurchase:// leitet Nutzer zum offiziellen Apple-Portal zur Abonnementverwaltung weiter, wo sie ihre Abonnements über die native Apple-Oberfläche kündigen können. Füge einfach einen Link wie den folgenden hinzu, um Nutzer zur Verwaltung ihrer Abonnements weiterzuleiten:

<a href="cancelinapppurchase://">Cancel Subscription</a>

• Bei Erfolg (Beispiel Vereinigte Staaten von Amerika): var storeLocation = 'US';
• Wenn kein Ländercode gefunden wird: var storeLocation = null;

Hinweis: Die Verwendung unserer API zur Bereitstellung bezahlter Inhalte für App-Nutzer birgt ein gewisses Risiko, dass technisch versierte Nutzer auf die Inhalte zugreifen, ohne dafür zu bezahlen. Dies kann auf verschiedene Weise geschehen, z. B. durch direktes Abrufen und Öffnen des Success-URL-Links, durch Kündigung von Abonnementprodukten nach Deinstallation der App oder durch die Ausübung von Widerrufsrechten und Rückbuchungsverfahren bei Kreditkarten. Es ist jedoch entscheidend zu beachten, dass bei jedem digitalen Ansatz ein gewisses Risiko besteht. Auch wenn wir weiterhin an Möglichkeiten arbeiten, diese Risiken zu reduzieren, liegt es letztlich beim WebViewGold-Nutzer/-Entwickler, das Risiko eines unbefugten/unbezahlten Zugriffs auf Inhalte zu akzeptieren, wenn er den vorgeschlagenen Ansatz nutzt, da die API ohne Gewährleistung geliefert wird. Trotz dessen überwiegen die Vorteile der Nutzung unserer API für die meisten Nutzer im Allgemeinen die Risiken. Um eine korrekte Umsatzberichterstattung sicherzustellen und potenzielle Abweichungen zu erkennen, empfehlen wir, die Verkaufsdaten von App Store Connect mit den serverseitigen Aktivierungen von In-App-Kaufprodukten zu verfolgen und zu vergleichen.