Plugin offerwall Flutter. Une seule API Dart, Android et iOS.
Ajoutez l’offerwall Moonetix à votre app Flutter avec un seul plugin. Il inclut les SDK natifs Android et iOS, il n’y a donc rien d’autre à configurer dans Gradle ou Xcode.
- 3.27+Flutter
- 2.0.1Version actuelle
- 2Plateformes, un seul plugin
import 'package:moonetix_offerwall/moonetix_offerwall.dart';
Moonetix.init('YOUR_APP_ID');
// When the user taps Earn
await Moonetix.open(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 plugin
Ajoutez le plugin depuis le dépôt de packages Moonetix et lancez flutter pub get. Sur Android, il apporte le dépôt Maven, le SDK et les règles R8. Sur iOS, il apporte le SDK iOS pour CocoaPods et Swift Package Manager.
dependencies: moonetix_offerwall: hosted: https://moonetix.com/pub version: ^2.0.1 -
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
Appelez init une seule fois avec l’App ID de votre tableau de bord, puis open avec un nouveau jeton. Écoutez Moonetix.events avant d’appeler open, et actualisez le solde quand l’utilisateur ferme l’offerwall.
void main() { WidgetsFlutterBinding.ensureInitialized(); Moonetix.init('YOUR_APP_ID'); runApp(const MyApp()); } Moonetix.events.listen((MoonetixEvent event) { switch (event) { case MoonetixOpened(): break; case MoonetixClosed(): refreshBalance(); case MoonetixErrorEvent(:final MoonetixError error): debugPrint('${error.code.name}: ${error.message}'); } }); await Moonetix.open(token); -
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 plugin gère pour vous
- SDK natifs inclus
Le plugin inclut les SDK Android et iOS. Aucun dépôt Gradle ni aucune étape Xcode à ajouter à la main.
- Les offres s’ouvrent au bon endroit
Les offres des stores s’ouvrent dans Google Play ou l’App 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 viennent de votre serveur et ne fonctionnent qu’une fois.
- Événements typés
Un flux broadcast de MoonetixOpened, MoonetixClosed et MoonetixErrorEvent, ou un listener si vous préférez les callbacks.
- Votre design
L’écran utilise le titre et les couleurs de l’onglet "Design" de votre tableau de bord.
- Pas d’identifiant publicitaire
Le plugin n’utilise pas l’identifiant publicitaire et ne suit pas les utilisateurs d’une app à l’autre.
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 Flutter, la cause et la solution.
invalidAppIdLa 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".
invalidTokenL’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.
tokenExpiredOrUsedLe 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.
notInitializedopen a été appelé avant init.
SolutionAppelez Moonetix.init dans main().
unsupportedL’app tourne sur le web ou sur ordinateur, ou la partie native du plugin n’est pas encore dans le build.
SolutionLancez l’app sur Android ou iOS, puis arrêtez-la et recompilez-la. Le hot reload n’ajoute pas de code natif.
No events arriveL’app a commencé à écouter après avoir appelé open.
SolutionÉcoutez Moonetix.events avant d’appeler open, depuis un objet qui reste actif.
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 de Flutter
- Flutter 3.27 ou plus récent
- Plateformes
- Android 5.0+, et iOS 13+ compilé avec Xcode 16 ou plus récent
- Package
- moonetix_offerwall ^2.0.1, hébergé sur moonetix.com/pub
- Langage
- Dart
- Configuration native
- Aucune, le plugin apporte les deux SDK
- Prix
- Gratuit pour les éditeurs approuvés
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 iOSUn offerwall natif pour Swift, SwiftUI et Objective-C.
- SDK UnityDes offres avec récompense pour les jeux Android et iOS, depuis C#.
- SDK React NativePour les apps React Native et Expo, avec les types TypeScript.
- Toutes les intégrationsComparez-les côte à côte.
Questions sur Flutter
Les questions des développeurs avant d’ajouter le SDK Flutter.
Un point bloquant ? Contactez-nous
Quelles versions de Flutter le plugin prend-il en charge ?
Flutter 3.27 ou plus récent. Sur iOS, compilez avec Xcode 16 ou plus récent.
Le plugin est-il sur pub.dev ?
Il est hébergé dans le dépôt de packages Moonetix. Ajoutez-le à pubspec.yaml avec hosted: https://moonetix.com/pub et lancez flutter pub get, comme pour n’importe quel package.
Dois-je modifier les réglages Gradle ou Xcode ?
En général, non. Le plugin inclut les SDK Android et iOS. Ajoutez le dépôt Maven de Moonetix dans votre android/settings.gradle uniquement si ce fichier bloque les dépôts au niveau du projet.
Comment savoir quand l’utilisateur ferme l’offerwall ?
Écoutez Moonetix.events, un flux broadcast, avant d’appeler open. MoonetixClosed est le bon moment pour charger le solde de l’utilisateur depuis votre serveur.
Comment les récompenses sont-elles créditées ?
À partir du postback signé sur votre serveur, une fois par ID de transaction. Les événements dans l’app servent uniquement à votre interface utilisateur.
Que dois-je déclarer dans les formulaires de confidentialité des stores ?
User ID, Device ID, Coarse Location et Product Interaction, liés à l’utilisateur, non utilisés pour le suivi. La documentation indique les noms Google Play pour les mêmes types de données.
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é.