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
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.
-
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.swiftdependencies: [ .package(url: "https://moonetix.com/ios/moonetix-ios.git", from: "2.0.1"), ], targets: [ .target(name: "MyApp", dependencies: [ .product(name: "MoonetixOfferwall", package: "moonetix-ios"), ]), ]Podfilepod 'MoonetixOfferwall', :podspec => 'https://moonetix.com/ios/2.0.1/MoonetixOfferwall.podspec' -
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']);session.js// POST /api/moonetix/session: a fresh token for the signed-in user app.post('/api/moonetix/session', requireLogin, async (req, res) => { const r = await fetch('https://api.moonetix.com/v1/session', { method: 'POST', headers: { Authorization: `Bearer ${process.env.MOONETIX_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ user_id: String(req.user.id) }), signal: AbortSignal.timeout(10000), }); const data = await r.json().catch(() => ({})); if (r.status === 201 && data.token) { return res.json({ token: data.token }); } const status = r.status === 403 ? 403 : 503; res.status(status).json({ error: 'offerwall_unavailable' }); });session.py# POST /api/moonetix/session: a fresh token for the signed-in user @app.post("/api/moonetix/session") @login_required def moonetix_session(): key = os.environ["MOONETIX_API_KEY"] r = requests.post( "https://api.moonetix.com/v1/session", data={"user_id": str(current_user.id)}, headers={"Authorization": f"Bearer {key}"}, timeout=10, ) data = r.json() if r.status_code == 201 and data.get("token"): return {"token": data["token"]} status = 403 if r.status_code == 403 else 503 return {"error": "offerwall_unavailable"}, status -
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.swiftMoonetix.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)EarnButton.swiftButton("Earn coins") { Task { let token = try await api.fetchMoonetixToken() Moonetix.open(token: token) } }EarnViewController.m@import MoonetixOfferwall; [Moonetix configureWithAppId:@"YOUR_APP_ID"]; [Moonetix openWithToken:token from:self options:nil]; -
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.
Tableau de bord, onglet Postbackhttps://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}postback.php<?php $tx = $_GET['tx'] ?? ''; $userId = $_GET['user'] ?? ''; $reward = $_GET['reward'] ?? ''; $status = $_GET['status'] ?? ''; $secret = getenv('MOONETIX_POSTBACK_SECRET'); $expected = hash_hmac('sha256', "$tx:$userId:$reward:$status", $secret); if (!hash_equals($expected, $_GET['hash'] ?? '')) { http_response_code(403); exit; } if ($status === '1') { credit_once($userId, $tx, $reward); // once per transaction ID } elseif ($status === '2') { reverse_if_credited($userId, $tx, $reward); } http_response_code(200);postback.jsconst crypto = require('crypto'); app.get('/postback', (req, res) => { const { tx, user, reward, status, hash } = req.query; const secret = process.env.MOONETIX_POSTBACK_SECRET; const expected = crypto.createHmac('sha256', secret) .update(`${tx}:${user}:${reward}:${status}`) .digest('hex'); const valid = typeof hash === 'string' && hash.length === expected.length && crypto.timingSafeEqual(Buffer.from(hash), Buffer.from(expected)); if (!valid) return res.sendStatus(403); if (status === '1') creditOnce(user, tx, reward); // once per transaction ID if (status === '2') reverseIfCredited(user, tx, reward); res.sendStatus(200); });postback.pyimport hmac, hashlib, os from flask import request, abort @app.get("/postback") def postback(): a = request.args parts = [a.get(k, "") for k in ("tx", "user", "reward", "status")] msg = ":".join(parts) secret = os.environ["MOONETIX_POSTBACK_SECRET"].encode() expected = hmac.new(secret, msg.encode(), hashlib.sha256).hexdigest() if not hmac.compare_digest(expected, a.get("hash", "")): abort(403) if a.get("status") == "1": credit_once(a["user"], a["tx"], a["reward"]) # once per transaction ID elif a.get("status") == "2": reverse_if_credited(a["user"], a["tx"], a["reward"]) return "", 200
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
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.
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.
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.
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_.
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
Prêt pour le lancement. Votre progression est enregistrée dans ce navigateur.
Erreurs courantes, vite corrigées.
Ce que vous pouvez rencontrer en intégrant le SDK iOS, la cause et la solution.
INVALID_APP_IDLa 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_TOKENL’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_USEDLe 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_INITIALIZEDopen a été appelé avant init.
SolutionAppelez Moonetix.configure au démarrage de votre app.
UNKNOWNL’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 calledMoonetix.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/sessionapp_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 detectedL’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 404Votre 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 timeoutVotre 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 302Votre URL redirige, par exemple de http vers https.
SolutionUtilisez l’URL finale. Les postbacks ne suivent pas les redirections.
Aucun résultat. Consultez la liste complète dans la documentation ou contactez-nous.
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
Partez d’un code qui fonctionne
Autres intégrations
- Site webUn lien, un iframe ou un bouton Earn flottant. Aucun SDK nécessaire.
- Offers APIRécupérez les offres en JSON et affichez-les avec votre propre design.
- SDK AndroidUn écran d’offerwall natif pour les apps Kotlin et Java.
- SDK UnityDes offres avec récompense pour les jeux Android et iOS, depuis C#.
- SDK FlutterUn seul plugin Dart pour Android et iOS.
- SDK React NativePour les apps React Native et Expo, avec les types TypeScript.
- Toutes les intégrationsComparez-les côte à côte.
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é.