SDK offerwall iOS. Swift, SwiftUI et Objective-C.

Ouvrez l’offerwall Moonetix dans votre app iPhone et iPad avec un seul package Swift. Il utilise uniquement UIKit et WebKit, n’a aucune dépendance tierce et est livré avec un privacy manifest.

  • 13+iOS et iPadOS
  • 2.0.1Version actuelle
  • 0Dépendances tierces
SDK iOSVersion 2.0.1
AppDelegate.swift
import MoonetixOfferwall
 
Moonetix.configure(appId: "YOUR_APP_ID")
 
// When the user taps Earn
Moonetix.open(token: token)

En ligne en quatre étapes.

Copiez le code, remplacez les espaces réservés par les valeurs de votre tableau de bord sous Offerwalls, votre offerwall, Intégration, et testez avant le lancement.

  1. Installer le SDK

    Ajoutez le package dans Xcode avec File, Add Package Dependencies, ou utilisez CocoaPods. Vous pouvez aussi télécharger le xcframework et l’intégrer à la main. Compilez avec Xcode 16 ou plus récent.

    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. Ajoutez un endpoint de jetons à votre serveur

    Votre app ne contient jamais la clé API. Quand un utilisateur appuie sur Earn, votre app demande une session à votre serveur, et votre serveur demande à Moonetix un jeton à usage unique pour cet utilisateur connecté. Un jeton ne fonctionne qu’une fois, pendant 10 minutes.

    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. Ouvrir l’offerwall

    Configurez une seule fois avec l’App ID de votre tableau de bord, puis ouvrez l’offerwall avec un nouveau jeton. Sans view controller, le SDK s’affiche depuis l’écran au premier plan de votre app, cela fonctionne donc aussi depuis 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. Créditez les récompenses avec le postback

    Chaque récompense arrive sur votre serveur sous forme de postback signé. Vérifiez le hash, ajoutez la récompense une seule fois par ID de transaction, et reprenez-la si un postback ultérieur l’annule. Les postbacks échoués sont relancés jusqu’à 5 fois.

    Macros de postback et nouvelles tentatives

    Tableau de bord, onglet Postback
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Gagner des pièces12,450 pièces
EarnMes offres
  • Travel TownAtteindre le niveau 15+1,500
  • WPS OfficeInstaller et ouvrir+2,000
  • Bus EscapeAtteindre le niveau 20+450
  • CapCutSign up in the app+800
Récompense créditéeTravel Town · +1,500 pièces
Écran natif
Postback 200 OK

Ce que voient vos utilisateurs

Un écran natif au-dessus de votre app, avec votre titre et vos couleurs, votre monnaie, et chaque récompense confirmée par un postback.

Ce que le SDK gère pour vous

  • Les offres s’ouvrent au bon endroit

    Les offres qui mènent à l’App Store s’ouvrent dans l’app du store, et les autres sites dans le navigateur, pour que les installations soient correctement suivies.

  • Aucune clé dans votre app

    Votre app ne contient que l’App ID. Les sessions sont créées sur votre serveur et ne fonctionnent qu’une fois, personne ne peut donc ouvrir l’offerwall à la place d’un autre utilisateur.

  • Un écran sécurisé

    Seules les pages de l’offerwall s’y chargent, sans pont JavaScript vers votre app.

  • Navigation native

    Le bouton de fermeture ramène à votre app, un balayage depuis le bord gauche revient en arrière dans l’offerwall, et il reprend là où l’utilisateur en était après un passage en arrière-plan.

  • Accessible par défaut

    Les modes clair et sombre, les grandes tailles de texte et VoiceOver fonctionnent d’emblée.

  • Privacy manifest inclus

    Le SDK est livré avec son privacy manifest, n’utilise aucune empreinte d’appareil et n’utilise pas l’identifiant publicitaire.

Testez, puis lancez.

Tout ce que vous devez vérifier avant que de vrais utilisateurs voient votre offerwall, avec les outils intégrés à votre tableau de bord.

  1. Ouvrir en tant qu’utilisateur test

    Dans "État de l’intégration" de l’onglet "Intégration", ouvrez votre offerwall en tant qu’utilisateur owner-test. Les visites de test ne sont pas comptées comme des utilisateurs.

  2. Lancez-le sur un appareil réel

    Compilez pour Android ou iOS et ouvrez l’offerwall depuis votre bouton Earn avec un nouveau jeton à chaque fois.

  3. Envoyer un postback de test

    Choisissez l’utilisateur, le statut et le paiement, et voyez exactement ce que votre serveur a répondu, avec le code de réponse et le temps. Les ID de transaction de test commencent par test_.

  4. Testez depuis une connexion normale

    Les VPN, proxys, Tor et réseaux cloud sont bloqués : testez donc en Wi-Fi domestique ou en données mobiles, dans un pays où des offres sont disponibles.

Checklist de lancement

0 sur 11 prêts

Erreurs courantes, vite corrigées.

Ce que vous pouvez rencontrer en intégrant le SDK iOS, la cause et la solution.

  • INVALID_APP_ID

    La valeur passée à init n’est pas l’App ID. Passer la clé API à cet endroit est l’erreur la plus courante.

    SolutionCopiez à nouveau l’App ID de 24 caractères depuis l’onglet "Intégration".

  • INVALID_TOKEN

    L’app a transmis autre chose que le jeton, ou un jeton créé avec la clé API d’une autre app.

    SolutionPassez uniquement le champ token, qui commence par sst_, et utilisez l’App ID et la clé API de la même app.

  • TOKEN_EXPIRED_OR_USED

    Le jeton a plus de 10 minutes ou a déjà été utilisé, par exemple conservé depuis un appui précédent.

    SolutionCréez un nouveau jeton à chaque ouverture, au moment où l’utilisateur appuie sur Earn.

  • NOT_INITIALIZED

    open a été appelé avant init.

    SolutionAppelez Moonetix.configure au démarrage de votre app.

  • UNKNOWN

    L’offerwall est déjà ouvert, ou aucun view controller n’était à l’écran pour l’afficher.

    SolutionN’ouvrez qu’un seul offerwall à la fois, et passez un view controller visible avec open(token:from:).

  • Delegate is never called

    Moonetix.delegate est une référence faible, l’objet avait donc déjà été libéré.

    SolutionGardez une référence forte à votre delegate, ou utilisez les closures.

  • 403 from /v1/session

    app_not_live signifie que l’app est en pause ou que votre compte n’est pas actif. user_blocked signifie que nous avons bloqué cet utilisateur.

    SolutionN’affichez pas l’offerwall. Pour app_not_live, consultez vos notifications.

  • VPN or Proxy detected

    L’appareil utilise un VPN, un proxy ou un réseau cloud, où les offres ne peuvent pas être suivies.

    SolutionTestez sur une connexion domestique ou mobile normale, dans un pays où des offres sont disponibles.

  • Postback log shows 403 or 404

    Votre script a rejeté le postback, ou l’URL est incorrecte.

    SolutionOuvrez l’URL du journal dans un navigateur et vérifiez votre code de hash.

  • Postback log shows a timeout

    Votre script met plus de 6 secondes à répondre.

    SolutionRépondez d’abord avec 200, et exécutez les tâches lentes en arrière-plan.

  • Postback log shows 301 or 302

    Votre URL redirige, par exemple de http vers https.

    SolutionUtilisez l’URL finale. Les postbacks ne suivent pas les redirections.

En bref

Version minimale
iOS 13, iPhone et iPad, compilé avec Xcode 16 ou plus récent
Langages
Swift, SwiftUI et Objective-C
Installation
Swift Package Manager, CocoaPods ou un xcframework
Dépendances
Uniquement UIKit et WebKit
Confidentialité
Privacy manifest inclus, pas d’identifiant publicitaire
Prix
Gratuit pour les éditeurs approuvés

Autres intégrations

Questions sur iOS

Les questions des développeurs avant d’ajouter le SDK iOS.

Un point bloquant ? Contactez-nous

Quelles versions d’iOS le SDK Moonetix prend-il en charge ?

iOS 13 ou plus récent sur iPhone et iPad, compilé avec Xcode 16 ou plus récent. Le SDK utilise uniquement UIKit et WebKit et n’a aucune dépendance tierce.

Puis-je l’utiliser avec SwiftUI ?

Oui. Appelez Moonetix.open(token:) sans view controller et le SDK s’affiche depuis l’écran au premier plan de votre app, ce qui fonctionne depuis des boutons SwiftUI.

Comment l’installer ?

Avec Swift Package Manager depuis https://moonetix.com/ios/moonetix-ios.git, avec CocoaPods depuis notre podspec, ou en intégrant le xcframework à la main.

Que dois-je déclarer dans les informations de confidentialité de l’App Store ?

User ID, Device ID, Coarse Location et Product Interaction, tous liés à l’utilisateur, non utilisés pour le suivi, pour App Functionality. Le privacy manifest du SDK liste les mêmes données.

L’offerwall enfreint-il les règles de validation de l’App Store ?

Apple a des règles pour les apps qui récompensent les utilisateurs. L’Academy propose un guide pour utiliser un offerwall dans une app iOS en respectant ces règles, y compris la façon de formuler vos récompenses.

Comment les utilisateurs sont-ils récompensés ?

Votre serveur reçoit un postback signé pour chaque récompense et crédite l’utilisateur. Ne créditez jamais à partir des événements de l’app, car ils peuvent être falsifiés sur un appareil.

Transformez votre trafic en revenus.

Créez un compte éditeur gratuit et gagnez de l’argent sur chaque offre que vos utilisateurs terminent sur votre site web, votre app, votre jeu ou votre communauté.

Ciblage mondial
Plus
Se connecter