iOS Offerwall SDK. Swift, SwiftUI und Objective-C.

Öffnen Sie die Moonetix Offerwall in Ihrer iPhone- und iPad-App mit einem einzigen Swift-Paket. Es nutzt nur UIKit und WebKit, hat keine Abhängigkeiten von Drittanbietern und enthält ein Privacy Manifest.

  • 13+iOS und iPadOS
  • 2.0.1Aktuelle Version
  • 0Abhängigkeiten von Drittanbietern
iOS SDKVersion 2.0.1
AppDelegate.swift
import MoonetixOfferwall
 
Moonetix.configure(appId: "YOUR_APP_ID")
 
// When the user taps Earn
Moonetix.open(token: token)

Live in vier Schritten.

Kopieren Sie den Code, ersetzen Sie die Platzhalter durch die Werte aus Ihrem Dashboard unter Offerwalls, Ihre Offerwall, Integration, und testen Sie vor dem Start.

  1. SDK installieren

    Fügen Sie das Paket in Xcode über File, Add Package Dependencies hinzu oder verwenden Sie CocoaPods. Sie können auch das xcframework herunterladen und manuell einbetten. Bauen Sie mit Xcode 16 oder neuer.

    Package.swift
    dependencies: [
        .package(url: "https://moonetix.com/ios/moonetix-ios.git", from: "2.0.1"),
    ],
    targets: [
        .target(name: "MyApp", dependencies: [
            .product(name: "MoonetixOfferwall", package: "moonetix-ios"),
        ]),
    ]
  2. Token-Endpunkt auf Ihrem Server hinzufügen

    Ihre App enthält nie den API-Schlüssel. Wenn ein Nutzer auf Earn tippt, fragt Ihre App Ihren Server nach einer Session, und Ihr Server fordert bei Moonetix ein einmal nutzbares Token für diesen angemeldeten Nutzer an. Ein Token funktioniert einmal, für 10 Minuten.

    session.php
    <?php
    // POST /api/moonetix/session: a fresh token for the signed-in user
    $user = current_user();
    if (!$user) {
        http_response_code(401);
        exit;
    }
     
    $key = getenv('MOONETIX_API_KEY');
    $ch  = curl_init('https://api.moonetix.com/v1/session');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query(['user_id' => (string)$user->id]),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 10,
        CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $key],
    ]);
    $data = json_decode((string)curl_exec($ch), true);
    $code = (int)curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
     
    header('Content-Type: application/json');
    if ($code === 201 && !empty($data['token'])) {
        echo json_encode(['token' => $data['token']]);
        exit;
    }
    http_response_code($code === 403 ? 403 : 503);
    echo json_encode(['error' => 'offerwall_unavailable']);
  3. Offerwall öffnen

    Konfigurieren Sie das SDK einmal mit der App ID aus Ihrem Dashboard und öffnen Sie dann die Offerwall mit einem neuen Token. Ohne View Controller zeigt das SDK die Offerwall über dem obersten Bildschirm Ihrer App an, daher funktioniert es auch mit SwiftUI.

    EarnViewController.swift
    Moonetix.configure(appId: "YOUR_APP_ID")
     
    Moonetix.onClosed = { [weak self] in
        self?.refreshBalance()
    }
    Moonetix.onError = { error in
        print(error.code.name, error.message)
    }
     
    Moonetix.open(token: token, from: self)
  4. Belohnungen per Postback gutschreiben

    Jede Belohnung erreicht Ihren Server als signierter Postback. Prüfen Sie den Hash, schreiben Sie die Belohnung pro Transaktions-ID einmal gut und nehmen Sie sie zurück, wenn ein späterer Postback sie rückbucht. Fehlgeschlagene Postbacks werden bis zu 5 Mal wiederholt.

    Postback-Makros und Wiederholungen

    Dashboard, Tab Postback
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Coins verdienen12,450 Coins
VerdienenMy offers
  • Travel TownLevel 15 erreichen+1,500
  • WPS OfficeInstallieren und öffnen+2,000
  • Bus EscapeLevel 20 erreichen+450
  • CleanfoxSign up in the app+800
Belohnung gutgeschriebenTravel Town · +1,500 Coins
Nativer Bildschirm
Postback 200 OK

Was Ihre Nutzer sehen

Ein nativer Bildschirm über Ihrer App, mit Ihrem Titel, Ihren Farben und Ihrer Währung, und jede Belohnung wird durch einen Postback bestätigt.

Was das SDK für Sie erledigt

  • Angebote öffnen sich am richtigen Ort

    Angebote, die zum App Store führen, öffnen sich in der Store-App, andere Websites im Browser, sodass Installationen korrekt getrackt werden.

  • Kein Schlüssel in Ihrer App

    Ihre App enthält nur die App ID. Sessions werden auf Ihrem Server erstellt und funktionieren einmal, sodass niemand die Offerwall als ein anderer Nutzer öffnen kann.

  • Ein abgeschotteter Bildschirm

    Darin laden nur Offerwall-Seiten, ohne JavaScript-Brücke in Ihre App.

  • Native Navigation

    Der Schließen-Button führt zurück zu Ihrer App, ein Wischen vom linken Rand navigiert innerhalb der Offerwall zurück, und nach der Rückkehr aus dem Hintergrund geht es dort weiter, wo der Nutzer war.

  • Standardmäßig barrierefrei

    Hell- und Dunkelmodus, größere Schriftgrößen und VoiceOver funktionieren ohne weitere Einrichtung.

  • Privacy Manifest enthalten

    Das SDK enthält sein Privacy Manifest, nutzt kein Device Fingerprinting und verwendet keine Werbe-ID.

Erst testen, dann starten.

Alles, was Sie prüfen sollten, bevor echte Nutzer Ihre Offerwall sehen, mit den Tools in Ihrem Dashboard.

  1. Open as a test user

    Öffnen Sie unter Integration status im Tab Integration Ihre Offerwall als Nutzer owner-test. Testbesuche werden nicht als Nutzer gezählt.

  2. Auf einem echten Gerät ausführen

    Erstellen Sie den Build für Android oder iOS und öffnen Sie die Offerwall über Ihren Earn-Button jedes Mal mit einem neuen Token.

  3. Send a test postback

    Wählen Sie Nutzer, Status und Auszahlung und sehen Sie genau, was Ihr Server geantwortet hat, mit Antwortcode und Zeit. Test-Transaktions-IDs beginnen mit test_.

  4. Über eine normale Verbindung testen

    VPNs, Proxys, Tor und Cloud-Netzwerke werden blockiert. Testen Sie daher über Ihr WLAN zu Hause oder mobile Daten, in einem Land, in dem Angebote laufen.

Checkliste vor dem Start

0 von 11 erledigt

Häufige Fehler, schnell behoben.

Was Ihnen bei der Integration des iOS SDK begegnen kann, woran es liegt und wie Sie es beheben.

  • INVALID_APP_ID

    Der an init übergebene Wert ist nicht die App ID. Hier den API-Schlüssel zu übergeben, ist der häufigste Fehler.

    LösungKopieren Sie die 24-stellige App ID erneut aus dem Tab Integration.

  • INVALID_TOKEN

    Die App hat etwas anderes als das Token übergeben, oder ein Token, das mit dem API-Schlüssel einer anderen App erstellt wurde.

    LösungÜbergeben Sie nur das Feld token, das mit sst_ beginnt, und verwenden Sie App ID und API-Schlüssel derselben App.

  • TOKEN_EXPIRED_OR_USED

    Das Token ist älter als 10 Minuten oder wurde bereits verwendet, zum Beispiel weil es von einem früheren Tippen stammt.

    LösungErstellen Sie für jedes Öffnen ein neues Token, genau dann, wenn der Nutzer auf Earn tippt.

  • NOT_INITIALIZED

    open wurde vor init aufgerufen.

    LösungRufen Sie Moonetix.configure beim Start Ihrer App auf.

  • UNKNOWN

    Die Offerwall ist bereits geöffnet, oder es war kein View Controller auf dem Bildschirm, von dem aus sie angezeigt werden konnte.

    LösungÖffnen Sie sie nicht mehrfach gleichzeitig und übergeben Sie mit open(token:from:) einen sichtbaren View Controller.

  • Delegate is never called

    Moonetix.delegate ist eine schwache Referenz, daher wurde das Objekt bereits freigegeben.

    LösungHalten Sie eine starke Referenz auf Ihren Delegate oder verwenden Sie die Closures.

  • 403 from /v1/session

    app_not_live bedeutet, dass die App pausiert oder Ihr Konto nicht aktiv ist. user_blocked bedeutet, dass wir diesen Nutzer gesperrt haben.

    LösungZeigen Sie die Offerwall nicht an. Prüfen Sie bei app_not_live Ihre Benachrichtigungen.

  • VPN or Proxy detected

    Das Gerät nutzt ein VPN, einen Proxy oder ein Cloud-Netzwerk, wo Angebote nicht getrackt werden können.

    LösungTesten Sie über eine normale Heim- oder Mobilfunkverbindung in einem Land, in dem Angebote laufen.

  • Postback log shows 403 or 404

    Ihr Skript hat den Postback abgelehnt, oder die URL ist falsch.

    LösungÖffnen Sie die URL aus dem Log in einem Browser und prüfen Sie Ihren Hash-Code.

  • Postback log shows a timeout

    Ihr Skript braucht länger als 6 Sekunden für die Antwort.

    LösungAntworten Sie zuerst mit 200 und erledigen Sie langsame Aufgaben im Hintergrund.

  • Postback log shows 301 or 302

    Ihre URL leitet weiter, zum Beispiel von http auf https.

    LösungVerwenden Sie die endgültige URL. Postbacks folgen keinen Weiterleitungen.

Fragen zu iOS

Was Entwickler fragen, bevor sie das iOS SDK einbinden.

Kommen Sie nicht weiter? Kontaktieren Sie uns

Welche iOS-Versionen unterstützt das Moonetix SDK?

iOS 13 oder neuer auf iPhone und iPad, gebaut mit Xcode 16 oder neuer. Das SDK nutzt nur UIKit und WebKit und hat keine Abhängigkeiten von Drittanbietern.

Kann ich es mit SwiftUI verwenden?

Ja. Rufen Sie Moonetix.open(token:) ohne View Controller auf, dann zeigt das SDK die Offerwall über dem obersten Bildschirm Ihrer App an. Das funktioniert auch mit SwiftUI-Buttons.

Wie installiere ich es?

Mit Swift Package Manager von https://moonetix.com/ios/moonetix-ios.git, mit CocoaPods über unseren Podspec oder durch manuelles Einbetten des xcframework.

Was gebe ich in den App-Store-Datenschutzangaben an?

User ID, Device ID, Coarse Location und Product Interaction, alle mit dem Nutzer verknüpft, nicht für Tracking verwendet, für App Functionality. Das Privacy Manifest des SDK listet dieselben Daten auf.

Verstößt die Offerwall gegen die Review-Regeln des App Store?

Apple hat Regeln für Apps, die Nutzer belohnen. Die Academy hat eine Anleitung, wie Sie eine Offerwall in einer iOS-App im Rahmen dieser Regeln betreiben, einschließlich der Formulierung Ihrer Belohnungen.

Wie werden Nutzer belohnt?

Ihr Server erhält für jede Belohnung einen signierten Postback und schreibt dem Nutzer gut. Schreiben Sie nie auf Basis von App-Events gut, denn diese lassen sich auf einem Gerät fälschen.

Machen Sie Ihren Traffic zu Einnahmen.

Erstellen Sie ein kostenloses Publisher-Konto und verdienen Sie an jedem Angebot, das Ihre Nutzer auf Ihrer Website, in Ihrer App, Ihrem Spiel oder Ihrer Community abschließen.

Weltweites Targeting
Mehr
Anmelden