SDK de offerwall para React Native. Listo para Expo, con TypeScript incluido.
Abra el offerwall de Moonetix como una pantalla nativa desde React Native o Expo. El paquete incluye los SDK de Android e iOS, funciona con la New Architecture y trae sus propios tipos de TypeScript.
- 0.77+React Native
- 53+Expo SDK
- TSTipos incluidos
import { Moonetix } from '@moonetix/react-native-offerwall';
Moonetix.init('YOUR_APP_ID');
// When the user taps Earn
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 paquete
Agregue el registro de Moonetix para el scope @moonetix y luego instale el paquete y vuelva a compilar su app. En Expo, agregue el config plugin y use una development build, porque Expo Go no puede cargar código nativo.
Terminal# .npmrc, next to package.json @moonetix:registry=https://moonetix.com/npm/ npm install @moonetix/react-native-offerwall cd ios && pod installapp.json{ "expo": { "plugins": ["@moonetix/react-native-offerwall"] } }.yarnrc.ymlnpmScopes: moonetix: npmRegistryServer: "https://moonetix.com/npm" -
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. addListener devuelve una suscripción, así que elimínela cuando su pantalla desaparezca.
import { Moonetix } from '@moonetix/react-native-offerwall'; Moonetix.init('YOUR_APP_ID'); useEffect(() => { const closed = Moonetix.addListener('closed', refreshBalance); const failed = Moonetix.addListener('error', (error) => { console.warn(`${error.code}: ${error.message}`); }); return () => { closed.remove(); failed.remove(); }; }, []); async function openOfferwall() { const url = 'https://your-server.example/api/moonetix/session'; const res = await fetch(url, { method: 'POST' }); const { token } = await res.json(); 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 paquete hace por usted
- SDK nativos incluidos
Gradle en Android y CocoaPods en iOS se configuran automáticamente. Ejecute pod install y vuelva a compilar.
- Config plugin de Expo
Agregue una línea a app.json y luego ejecute prebuild o inicie un EAS Build.
- Tipos de TypeScript
init, open, eventos y códigos de error tipados, con los mismos nombres que usan los SDK nativos.
- Las ofertas se abren en el lugar correcto
Las ofertas de tiendas se abren en Google Play o la App Store, para que las instalaciones se registren correctamente.
- Ninguna clave en su bundle
Su bundle de JavaScript contiene solo el App ID. Las sesiones vienen de su servidor y funcionan una sola vez.
- Sin ID de publicidad
El SDK 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 React Native, qué lo causa y cómo solucionarlo.
INVALID_APP_IDEl 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.
INVALID_TOKENLa 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.
TOKEN_EXPIRED_OR_USEDEl 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.
NOT_INITIALIZEDSe llamó a open antes que a init.
SoluciónLlame a Moonetix.init una sola vez cuando se inicie su app.
UNSUPPORTED on a phoneLa parte nativa no está en la compilación, por ejemplo en Expo Go o antes de volver a compilar.
SoluciónVuelva a compilar la app o use una development build de Expo. Una recarga de Metro no agrega código nativo.
Gradle cannot find com.moonetixSu settings.gradle no permite que los proyectos agreguen repositorios.
SoluciónAgregue el repositorio Maven de Moonetix a settings.gradle.
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
- React Native
- 0.77 o posterior, compatible con la New Architecture
- Expo
- SDK 53 o posterior, con una development build
- Paquete
- @moonetix/react-native-offerwall 2.0.1 desde moonetix.com/npm
- Android
- Kotlin 2.0 o posterior, el predeterminado en estas versiones
- Lenguaje
- TypeScript y JavaScript
- 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 FlutterUn solo plugin de Dart para Android e iOS.
- Todas las integracionesCompárelas lado a lado.
Preguntas sobre React Native
Lo que preguntan los desarrolladores antes de agregar el SDK de React Native.
¿Se quedó atascado? Contáctenos
¿Qué versiones de React Native y Expo son compatibles?
React Native 0.77 o posterior, o Expo SDK 53 o posterior. El paquete funciona con la New Architecture y, en React Native 0.77 a 0.81, también con la arquitectura anterior.
¿Funciona en Expo Go?
No. Expo Go no puede cargar código nativo, así que ahí Moonetix.isSupported es false. Agregue el config plugin y pruebe con una development build o un EAS Build.
¿El paquete está en el registro público de npm?
Está en el registro npm de Moonetix. Agregue @moonetix:registry=https://moonetix.com/npm/ a su .npmrc, o la entrada npmScopes en Yarn 2 y posteriores, y luego instálelo como de costumbre.
¿Se incluyen los tipos de TypeScript?
Sí. El paquete incluye los tipos para init, open, los eventos y los códigos de error.
¿Cómo recompenso a los usuarios?
Su servidor recibe un postback firmado por cada recompensa y acredita al usuario una vez por ID de transacción. Los eventos de la app se pueden falsificar en un dispositivo, así que úselos solo para actualizar su UI.
¿Dónde va mi clave de API?
Solo en su servidor. Su app contiene el App ID, y su servidor crea un token de sesión de un solo uso para el usuario con sesión iniciada.
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.