SDK offerwall per iOS. Swift, SwiftUI e Objective-C.

Apra l'offerwall Moonetix nella sua app per iPhone e iPad con un solo pacchetto Swift. Usa solo UIKit e WebKit, non ha dipendenze di terze parti e include un privacy manifest.

  • 13+iOS e iPadOS
  • 2.0.1Versione attuale
  • 0Dipendenze di terze parti
iOS SDKVersione 2.0.1
AppDelegate.swift
import MoonetixOfferwall
 
Moonetix.configure(appId: "YOUR_APP_ID")
 
// When the user taps Earn
Moonetix.open(token: token)

Vada live in quattro passaggi.

Copi il codice, sostituisca i segnaposto con i valori della sua dashboard in Offerwall, il suo offerwall, Integrazione, e faccia un test prima del lancio.

  1. Installi l'SDK

    Aggiunga il pacchetto in Xcode con File, Add Package Dependencies, oppure usi CocoaPods. Può anche scaricare l'xcframework e incorporarlo a mano. Compili con Xcode 16 o successivo.

    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. Aggiunga un endpoint token al suo server

    La sua app non contiene mai la chiave API. Quando un utente tocca Earn, l'app chiede una sessione al suo server, e il server chiede a Moonetix un token monouso per quell'utente connesso. Un token vale una sola volta, per 10 minuti.

    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. Apri l'offerwall

    Esegua configure una volta con l'App ID della sua dashboard, poi apra l'offerwall con un token nuovo. Senza un view controller, l'SDK si presenta dalla schermata in primo piano della sua app, quindi funziona anche da 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. Accrediti le ricompense con il postback

    Ogni ricompensa raggiunge il suo server come postback firmato. Verifichi l'hash, aggiunga la ricompensa una volta per ID transazione e la riprenda se un postback successivo la storna. I postback non riusciti vengono ritentati fino a 5 volte.

    Macro e nuovi tentativi dei postback

    Dashboard, scheda "Postback"
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Guadagna monete12,450 monete
EarnLe mie offerte
  • Travel TownRaggiungi il livello 15+1,500
  • WPS OfficeInstalla e apri+2,000
  • Bus EscapeRaggiungi il livello 20+450
  • CapCutSign up in the app+800
Ricompensa accreditataTravel Town · +1,500 monete
Schermata nativa
Postback 200 OK

Cosa vedono i suoi utenti

Una schermata nativa sopra la sua app, con il suo titolo e i suoi colori, la sua valuta e ogni ricompensa confermata da un postback.

Cosa gestisce l'SDK per lei

  • Le offerte si aprono nel posto giusto

    Le offerte che portano all'App Store si aprono nell'app dello store e gli altri siti nel browser, così le installazioni vengono tracciate correttamente.

  • Nessuna chiave nella sua app

    La sua app contiene solo l'App ID. Le sessioni vengono create sul suo server e valgono una sola volta, così nessuno può aprire l'offerwall al posto di un altro utente.

  • Una schermata protetta

    Al suo interno si caricano solo pagine dell'offerwall, senza alcun bridge JavaScript verso la sua app.

  • Navigazione nativa

    Il pulsante di chiusura torna alla sua app, lo swipe dal bordo sinistro torna indietro all'interno dell'offerwall, e dopo il passaggio in background riprende dove si trovava l'utente.

  • Accessibile di default

    Modalità chiara e scura, testo più grande e VoiceOver funzionano subito.

  • Privacy manifest incluso

    L'SDK include il suo privacy manifest, non usa il fingerprinting del dispositivo e non usa l'identificatore pubblicitario.

Lo testi, poi lo lanci.

Tutto ciò che deve verificare prima che utenti reali vedano il suo offerwall, con gli strumenti integrati nella sua dashboard.

  1. Apri come utente di prova

    In "Stato dell'integrazione", nella scheda "Integrazione", apra il suo offerwall come utente owner-test. Le visite di test non vengono conteggiate come utenti.

  2. Lo esegua su un dispositivo reale

    Compili per Android o iOS e apra l'offerwall dal suo pulsante Earn con un token nuovo ogni volta.

  3. Invia un postback di prova

    Scelga utente, stato e pagamento, e veda esattamente cosa ha risposto il suo server, con codice di risposta e tempo. Gli ID transazione di test iniziano con test_.

  4. Test da una connessione normale

    VPN, proxy, Tor e reti cloud sono bloccati, quindi faccia il test da Wi-Fi domestico o rete dati mobile, in un paese in cui ci sono offerte attive.

Checklist per il lancio

0 di 11 pronti

Errori comuni, risolti in fretta.

Cosa potrebbe incontrare durante l'integrazione dell'SDK iOS, la causa e la soluzione.

  • INVALID_APP_ID

    Il valore passato a init non è l'App ID. Passare qui la chiave API è l'errore più comune.

    SoluzioneCopi di nuovo l'App ID di 24 caratteri dalla scheda "Integrazione".

  • INVALID_TOKEN

    L'app ha passato qualcosa di diverso dal token, oppure un token creato con la chiave API di un'altra app.

    SoluzionePassi solo il campo token, che inizia con sst_, e usi App ID e chiave API della stessa app.

  • TOKEN_EXPIRED_OR_USED

    Il token ha più di 10 minuti o è già stato usato, ad esempio perché conservato da un tocco precedente.

    SoluzioneCrei un nuovo token per ogni apertura, nel momento in cui l'utente tocca Earn.

  • NOT_INITIALIZED

    open è stato chiamato prima di init.

    SoluzioneChiami Moonetix.configure all'avvio dell'app.

  • UNKNOWN

    L'offerwall è già aperto, oppure sullo schermo non c'era alcun view controller da cui presentarlo.

    SoluzioneLo apra una volta sola alla volta e passi un view controller visibile con open(token:from:).

  • Delegate is never called

    Moonetix.delegate è un riferimento weak, quindi l'oggetto era già stato rilasciato.

    SoluzioneMantenga un riferimento forte al suo delegate, oppure usi le closure.

  • 403 from /v1/session

    app_not_live significa che l'app è in pausa o che il suo account non è attivo. user_blocked significa che abbiamo bloccato questo utente.

    SoluzioneNon mostri l'offerwall. Per app_not_live, controlli le sue notifiche.

  • VPN or Proxy detected

    Il dispositivo usa una VPN, un proxy o una rete cloud, dove le offerte non possono essere tracciate.

    SoluzioneEsegua il test da una normale connessione domestica o mobile, in un paese in cui ci sono offerte attive.

  • Postback log shows 403 or 404

    Il suo script ha rifiutato il postback, oppure l'URL è errato.

    SoluzioneApra in un browser l'URL presente nel log e controlli il suo codice hash.

  • Postback log shows a timeout

    Il suo script impiega più di 6 secondi a rispondere.

    SoluzioneRisponda prima con 200 ed esegua le operazioni lente in background.

  • Postback log shows 301 or 302

    Il suo URL reindirizza, ad esempio da http a https.

    SoluzioneUsi l'URL finale. I postback non seguono i reindirizzamenti.

In sintesi

Versione minima
iOS 13, iPhone e iPad, compilato con Xcode 16 o successivo
Lingue
Swift, SwiftUI e Objective-C
Installa
Swift Package Manager, CocoaPods o un xcframework
Dipendenze
Solo UIKit e WebKit
Privacy
Privacy manifest incluso, nessun identificatore pubblicitario
Prezzo
Gratuito per i publisher approvati

Altre integrazioni

Domande su iOS

Cosa chiedono gli sviluppatori prima di aggiungere l'SDK iOS.

Bloccato su qualcosa? Ci contatti

Quali versioni di iOS supporta l'SDK Moonetix?

iOS 13 o successivo su iPhone e iPad, compilato con Xcode 16 o successivo. L'SDK usa solo UIKit e WebKit e non ha dipendenze di terze parti.

Posso usarlo con SwiftUI?

Sì. Chiami Moonetix.open(token:) senza un view controller e l'SDK si presenta dalla schermata in primo piano della sua app, il che funziona dai pulsanti SwiftUI.

Come lo installo?

Con Swift Package Manager da https://moonetix.com/ios/moonetix-ios.git, con CocoaPods dal nostro podspec, oppure incorporando a mano l'xcframework.

Cosa devo dichiarare nei dettagli sulla privacy dell'App Store?

User ID, Device ID, Coarse Location e Product Interaction, tutti collegati all'utente, non usati per il tracciamento, per App Functionality. Il privacy manifest dell'SDK elenca gli stessi dati.

L'offerwall viola le regole di revisione dell'App Store?

Apple ha regole per le app che premiano gli utenti. L'Academy ha una guida su come gestire un offerwall in un'app iOS nel rispetto di queste regole, compreso come formulare le ricompense.

Come vengono ricompensati gli utenti?

Il suo server riceve un postback firmato per ogni ricompensa e accredita l'utente. Non accrediti mai dagli eventi dell'app, perché possono essere falsificati su un dispositivo.

Trasformi il suo traffico in guadagni.

Crei un account publisher gratuito e guadagni da ogni offerta che i suoi utenti completano sul suo sito web, app, gioco o community.

Targeting in tutto il mondo
Altro
Accedi