Plugin de offerwall para Flutter. Una sola API en Dart, Android e iOS.
Agregue el offerwall de Moonetix a su app de Flutter con un solo plugin. Incluye los SDK nativos de Android e iOS, así que no hay nada más que configurar en Gradle ni en Xcode.
- 3.27+Flutter
- 2.0.1Versión actual
- 2Plataformas, un solo plugin
import 'package:moonetix_offerwall/moonetix_offerwall.dart';
Moonetix.init('YOUR_APP_ID');
// When the user taps Earn
await Moonetix.open(token);Comience en cuatro pasos.
Copie el código, reemplace los marcadores con los valores de su panel en Offerwalls, su offerwall, Integration, y haga pruebas antes de lanzar.
-
Instale el plugin
Agregue el plugin desde el repositorio de paquetes de Moonetix y ejecute flutter pub get. En Android incluye el repositorio Maven, el SDK y las reglas de R8. En iOS incluye el SDK de iOS para CocoaPods y Swift Package Manager.
dependencies: moonetix_offerwall: hosted: https://moonetix.com/pub version: ^2.0.1 -
Agregue un endpoint de tokens a su servidor
Su app nunca contiene la clave de API. Cuando un usuario toca Earn, su app le pide una sesión a su servidor, y su servidor le pide a Moonetix un token de un solo uso para ese usuario con sesión iniciada. Un token funciona una sola vez, durante 10 minutos.
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 -
Abra el offerwall
Llame a init una vez con el App ID de su panel y luego a open con un token nuevo. Escuche Moonetix.events antes de llamar a open y actualice el saldo cuando el usuario cierre el 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); -
Acredite las recompensas con el postback
Cada recompensa llega a su servidor como un postback firmado. Verifique el hash, sume la recompensa una sola vez por ID de transacción y retírela si un postback posterior la revierte. Los postbacks fallidos se reintentan hasta 5 veces.
Panel, pestaña 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 TownLlegue al nivel 15+1,500
WPS OfficeInstalar y abrir+2,000
Bus EscapeLlegue al nivel 20+450
CleanfoxSign up in the app+800
Lo que ven sus usuarios
Una pantalla nativa sobre su app, con su título y sus colores, su moneda y cada recompensa confirmada por un postback.
Lo que el plugin hace por usted
- SDK nativos incluidos
El plugin incluye los SDK de Android e iOS. No hay repositorios de Gradle ni pasos de Xcode que agregar a mano.
- Las ofertas se abren en el lugar correcto
Las ofertas de tiendas se abren en Google Play o la App Store, y los demás sitios en el navegador, para que las instalaciones se registren correctamente.
- Ninguna clave dentro de su app
Su app contiene solo el App ID. Las sesiones vienen de su servidor y funcionan una sola vez.
- Eventos tipados
Un stream de difusión con MoonetixOpened, MoonetixClosed y MoonetixErrorEvent, o un listener si prefiere callbacks.
- Su diseño
La pantalla usa el título y los colores de la pestaña Design de su panel.
- Sin ID de publicidad
El plugin no usa el identificador de publicidad y no rastrea a los usuarios entre apps.
Pruébelo y luego publíquelo.
Todo lo que necesita verificar antes de que los usuarios reales vean su offerwall, con las herramientas integradas en su panel.
Open as a test user
En Integration status, en la pestaña Integration, abra su offerwall como el usuario owner-test. Las visitas de prueba no cuentan como usuarios.
Ejecútelo en un dispositivo real
Compile para Android o iOS y abra el offerwall desde su botón Earn con un token nuevo cada vez.
Send a test postback
Elija el usuario, el estado y el pago, y vea exactamente qué respondió su servidor, con el código de respuesta y el tiempo. Los ID de transacción de prueba empiezan con test_.
Pruebe desde una conexión normal
Las VPN, los proxies, Tor y las redes en la nube están bloqueados, así que pruebe con el Wi-Fi de su casa o con datos móviles, en un país donde haya ofertas activas.
Lista de verificación para el lanzamiento
0 de 11 listos
Listo para lanzar. Su progreso se guarda en este navegador.
Errores comunes, resueltos rápido.
Lo que puede encontrar al integrar el SDK de Flutter, qué lo causa y cómo solucionarlo.
invalidAppIdEl valor que se pasa a init no es el App ID. Pasar aquí la clave de API es el error más común.
SoluciónVuelva a copiar el App ID de 24 caracteres desde la pestaña Integration.
invalidTokenLa app pasó algo distinto del token, o un token creado con la clave de API de otra app.
SoluciónPase solo el campo token, que empieza con sst_, y use el App ID y la clave de API de la misma app.
tokenExpiredOrUsedEl token tiene más de 10 minutos o ya se usó, por ejemplo porque se guardó de un toque anterior.
SoluciónCree un token nuevo cada vez que se abra, justo cuando el usuario toque Earn.
notInitializedSe llamó a open antes que a init.
SoluciónLlame a Moonetix.init en main().
unsupportedLa app se ejecuta en web o escritorio, o la parte nativa del plugin todavía no está en la compilación.
SoluciónEjecútela en Android o iOS, y detenga y vuelva a compilar la app. Hot reload no agrega código nativo.
No events arriveLa app empezó a escuchar después de llamar a open.
SoluciónEscuche Moonetix.events antes de llamar a open, desde un objeto que permanezca activo.
403 from /v1/sessionapp_not_live significa que la app está en pausa o que su cuenta no está activa. user_blocked significa que bloqueamos a este usuario.
SoluciónNo muestre el offerwall. Con app_not_live, revise sus notificaciones.
VPN or Proxy detectedEl dispositivo está en una VPN, un proxy o una red en la nube, donde las ofertas no se pueden registrar.
SoluciónPruebe con una conexión normal de casa o de datos móviles, en un país donde haya ofertas activas.
Postback log shows 403 or 404Su script rechazó el postback, o la URL es incorrecta.
SoluciónAbra en un navegador la URL que aparece en el registro y revise su código de hash.
Postback log shows a timeoutSu script tarda más de 6 segundos en responder.
SoluciónResponda primero con 200 y ejecute las tareas lentas en segundo plano.
Postback log shows 301 or 302Su URL redirige, por ejemplo de http a https.
SoluciónUse la URL final. Los postbacks no siguen redirecciones.
Sin resultados. Vea la lista completa en la documentación o contáctenos.
En resumen
- Versión de Flutter
- Flutter 3.27 o posterior
- Plataformas
- Android 5.0+ e iOS 13+ compilado con Xcode 16 o posterior
- Paquete
- moonetix_offerwall ^2.0.1, alojado en moonetix.com/pub
- Lenguaje
- Dart
- Configuración nativa
- Ninguna, el plugin incluye ambos SDK
- Precio
- Gratuito para publishers aprobados
Otras integraciones
- Sitio webUn enlace, un iframe o un botón flotante Earn. No necesita SDK.
- Offers APIObtenga las ofertas en JSON y muéstrelas con su propio diseño.
- SDK de AndroidUna pantalla nativa de offerwall para apps en Kotlin y Java.
- SDK de iOSUn offerwall nativo para Swift, SwiftUI y Objective-C.
- SDK de UnityOfertas con recompensa para juegos de Android e iOS, desde C#.
- SDK de React NativePara apps de React Native y Expo, con tipos de TypeScript.
- Todas las integracionesCompárelas lado a lado.
Preguntas sobre Flutter
Lo que preguntan los desarrolladores antes de agregar el SDK de Flutter.
¿Se quedó atascado? Contáctenos
¿Qué versiones de Flutter admite el plugin?
Flutter 3.27 o posterior. En iOS, compile con Xcode 16 o posterior.
¿El plugin está en pub.dev?
Está alojado en el repositorio de paquetes de Moonetix. Agréguelo a pubspec.yaml con hosted: https://moonetix.com/pub y ejecute flutter pub get, igual que con cualquier otro paquete.
¿Tengo que cambiar la configuración de Gradle o Xcode?
Normalmente no. El plugin incluye los SDK de Android e iOS. Solo si su android/settings.gradle bloquea los repositorios del proyecto, agregue ahí el repositorio Maven de Moonetix.
¿Cómo sé cuándo el usuario cierra el offerwall?
Escuche Moonetix.events, un stream de difusión, antes de llamar a open. MoonetixClosed es un buen momento para cargar el saldo del usuario desde su servidor.
¿Cómo se acreditan las recompensas?
A partir del postback firmado en su servidor, una vez por ID de transacción. Los eventos en la app son solo para su interfaz de usuario.
¿Qué declaro en los formularios de privacidad de las tiendas?
User ID, Device ID, Coarse Location y Product Interaction, vinculados al usuario, no usados para rastreo. La documentación indica los nombres de Google Play para los mismos tipos de datos.
Convierta su tráfico en ganancias.
Cree una cuenta gratuita de publisher y gane con cada oferta que sus usuarios completen en su sitio web, app, juego o comunidad.