SDK de offerwall para Android. Nativo, en unas pocas líneas de Kotlin.
Abra el offerwall de Moonetix como una pantalla nativa en su app de Android. Instale una dependencia de Gradle, cree una sesión en su servidor y llame a open. Funciona desde Kotlin, Java y Jetpack Compose.
- 5.0+Android, API 21
- 2.0.1Versión actual
- 0Permisos adicionales
// Once, in your Application class
Moonetix.init(applicationContext, "YOUR_APP_ID")
// When the user taps Earn
Moonetix.open(activity, 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 SDK
Agregue el repositorio Maven de Moonetix y una dependencia. El SDK agrega por sí solo el permiso de internet y su pantalla a su manifest, e incluye sus propias reglas de R8 y ProGuard.
settings.gradle.ktsdependencyResolutionManagement { repositories { google() mavenCentral() maven { url = uri("https://moonetix.com/maven") } } } // app/build.gradle.kts dependencies { implementation("com.moonetix:offerwall:2.0.1") }settings.gradledependencyResolutionManagement { repositories { google() mavenCentral() maven { url 'https://moonetix.com/maven' } } } // app/build.gradle dependencies { implementation 'com.moonetix:offerwall: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 abra el offerwall con el token de su servidor. Los errores nunca lanzan excepciones: llegan como eventos, y onClosed es un buen momento para actualizar el saldo del usuario.
EarnActivity.ktMoonetix.init(applicationContext, "YOUR_APP_ID") Moonetix.setListener(object : MoonetixListener { override fun onClosed() { refreshBalance() } override fun onError(error: MoonetixError) { Log.w("Earn", "${error.code}: ${error.message}") } }) lifecycleScope.launch { val token = fetchMoonetixToken(authToken) Moonetix.open(this@EarnActivity, token) }EarnActivity.javaMoonetix.init(getApplicationContext(), "YOUR_APP_ID"); // with a fresh token from your server Moonetix.open(activity, token);EarnButton.kt@Composable fun EarnButton(authToken: String) { val context = LocalContext.current val scope = rememberCoroutineScope() Button(onClick = { scope.launch { val token = runCatching { fetchMoonetixToken(authToken) } .getOrNull() ?: return@launch context.findActivity()?.let { Moonetix.open(it, token) } } }) { Text("Earn coins") } } -
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 SDK hace por usted
- Las ofertas se abren en el lugar correcto
Las ofertas que llevan a Google Play se abren en la app de la tienda y los demás sitios se abren 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 se crean en su servidor y funcionan una sola vez, así que nadie puede abrir el offerwall como si fuera otro usuario.
- Una pantalla protegida
Dentro solo se cargan páginas del offerwall, sin ningún puente de JavaScript hacia su app.
- Navegación nativa
El botón Atrás retrocede dentro del offerwall, y al girar la pantalla o al reiniciarse por falta de memoria el usuario se queda donde estaba.
- Su diseño, sin código adicional
La pantalla usa el título y los colores de la pestaña Design de su panel, y aplica los cambios en pocos minutos.
- 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 Android, 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 en Application.onCreate.
UNKNOWNAndroid System WebView falta o está desactivado, o la Activity que pasó ya se estaba cerrando.
SoluciónPida al usuario que actualice Android System WebView y pase una Activity que esté en pantalla.
onClosed never arrivesEl listener se eliminó en onStop, o pertenecía a una pantalla que ya no existe.
SoluciónAsígnelo en onCreate y bórrelo en onDestroy, o asígnelo una sola vez en su Application.
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 mínima
- Android 5.0 (API 21), con Android System WebView o Chrome
- Lenguajes
- Kotlin, Java y Jetpack Compose
- Paquete
- com.moonetix:offerwall:2.0.1 desde moonetix.com/maven
- Dependencias
- Solo la biblioteca estándar de Kotlin
- Permisos
- Solo internet, agregado por el 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 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.
- SDK de React NativePara apps de React Native y Expo, con tipos de TypeScript.
- Todas las integracionesCompárelas lado a lado.
Preguntas sobre Android
Lo que preguntan los desarrolladores antes de agregar el SDK de Android.
¿Se quedó atascado? Contáctenos
¿Qué versiones de Android admite el SDK de Moonetix?
Android 5.0 (API 21) o posterior, con Android System WebView o Chrome en el dispositivo. La única dependencia es la biblioteca estándar de Kotlin, así que funciona en apps de Kotlin y de Java.
¿Tengo que agregar reglas de ProGuard o R8?
No. El SDK incluye sus propias reglas de R8 y ProGuard, y agrega por sí solo el permiso de internet y su pantalla de offerwall a su manifest.
¿Mi clave de API va dentro de la app?
No. Su app solo contiene el App ID. Su servidor crea una sesión con la clave de API y le pasa un token a la app. Un token funciona una sola vez y durante 10 minutos, así que nada en su app puede abrir el offerwall de otro usuario.
¿El SDK usa el ID de publicidad?
No. No usa el ID de publicidad, no pide ningún permiso aparte del acceso a internet y no rastrea a los usuarios entre apps. La documentación indica qué declarar en el formulario de Data safety de Google Play.
¿Cómo recompenso a los usuarios en mi app?
Acredite las recompensas a partir del postback firmado en su servidor, nunca a partir de eventos en la app, porque los eventos se pueden falsificar en un dispositivo. Cuando el usuario cierre el offerwall, cargue su nuevo saldo desde su servidor.
¿La pantalla del offerwall puede combinar con mi app?
Sí. Usa el título y los colores de la pestaña Design de su panel. También puede pasar su propio título y el color de la barra de herramientas, u ocultar la marca con MoonetixOptions.
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.