SDK de offerwall para Unity. Los jugadores ganan la moneda de su juego.
Permita que los jugadores ganen la moneda de su juego completando ofertas, sin banners en su juego. Un solo paquete de Unity cubre Android e iOS, y cada recompensa llega al servidor de su juego como un postback firmado.
- 2022.3+Unity LTS o Unity 6
- 2.0.1Versión actual
- 2Plataformas, un solo paquete
using MoonetixOfferwall;
void Awake()
{
Moonetix.Init("YOUR_APP_ID");
}
public void ShowOfferwall(string token)
{
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 scoped registry de Moonetix y el paquete a Packages/manifest.json, o agregue el registro en Project Settings e instale Moonetix Offerwall desde el Package Manager. Los SDK de Android e iOS vienen incluidos.
{ "scopedRegistries": [ { "name": "Moonetix", "url": "https://moonetix.com/upm", "scopes": ["com.moonetix"] } ], "dependencies": { "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 a Open con un token nuevo. Todos los eventos llegan en el hilo principal de Unity, así que puede actualizar su UI directamente. El paquete también incluye el ejemplo Offerwall demo.
using MoonetixOfferwall; using UnityEngine; public class EarnButton : MonoBehaviour { void Awake() => Moonetix.Init("YOUR_APP_ID"); void OnEnable() { Moonetix.OnClosed += RefreshBalance; Moonetix.OnError += HandleError; } void OnDisable() { Moonetix.OnClosed -= RefreshBalance; Moonetix.OnError -= HandleError; } public void ShowOfferwall(string token) => Moonetix.Open(token); void HandleError(MoonetixError error) { Debug.LogWarning(error.CodeName + ": " + error.Message); } void RefreshBalance() { } } -
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
- Compilaciones para Android e iOS
En Android agrega el repositorio Maven, el SDK y la regla de R8 a su proyecto de Gradle. En iOS enlaza e integra el SDK de iOS en Xcode.
- Las ofertas se abren en el lugar correcto
Las ofertas que llevan a Google Play o a la App Store se abren en la app de la tienda, para que las instalaciones se registren correctamente.
- Ninguna clave dentro de su juego
Su juego contiene solo el App ID. Las sesiones vienen de su servidor y funcionan una sola vez.
- Eventos en el hilo principal
OnOpened, OnClosed y OnError se disparan en el hilo principal de Unity, listos para su UI.
- La moneda de su juego
Las recompensas se muestran y se acreditan en su propia moneda, con su tasa de cambio y su reparto con el usuario.
- Sin ID de publicidad
El SDK no usa el identificador de publicidad y no rastrea a los jugadores 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 Unity, 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 Awake de su primera escena.
UnsupportedEl juego se ejecuta en el Unity Editor, en escritorio o en WebGL.
SoluciónCompile para Android o iOS y verifique Moonetix.IsSupported antes de mostrar el botón.
iOS build stops on the iOS versionLa versión mínima de iOS objetivo en Player Settings es inferior a 13.0.
SoluciónConfigúrelo en 13.0 o superior.
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 Unity
- Unity 2022.3 LTS, o Unity 6 (6000.0) o posterior
- Plataformas
- Android e iOS 13 o posterior
- Paquete
- com.moonetix.offerwall 2.0.1 desde moonetix.com/upm
- Lenguaje
- C#
- Ejemplo
- Offerwall demo con un botón Earn, en el Package Manager
- 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 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 Unity
Lo que preguntan los desarrolladores antes de agregar el SDK de Unity.
¿Se quedó atascado? Contáctenos
¿Qué versiones de Unity son compatibles?
Unity 2022.3 LTS, o Unity 6 (6000.0) o posterior. En iOS, configure la versión mínima de iOS en 13.0 o superior en Player Settings.
¿Funciona en compilaciones para Android e iOS?
Sí. Un solo paquete cubre ambas. Unity agrega por sí solo el SDK de Android al proyecto de Gradle y el SDK de iOS al proyecto de Xcode, incluidos los proyectos exportados y las plantillas de Gradle personalizadas.
¿Cómo instalo el paquete de Unity de Moonetix?
Agregue el scoped registry de Moonetix y com.moonetix.offerwall a Packages/manifest.json, o instálelo desde My Registries en el Package Manager. También puede instalarlo desde un tarball.
¿Un offerwall es pay-to-win?
No. Los jugadores ganan la misma moneda que ganarían jugando, probando apps y juegos de los anunciantes. Les da a los jugadores que no pagan una forma de avanzar sin banners en su juego.
¿Cómo acredito a los jugadores de forma segura?
Acredite las recompensas en el servidor de su juego a partir del postback firmado, nunca a partir de eventos del cliente, porque los jugadores pueden falsificarlos. Cuando se dispare OnClosed, cargue el saldo del jugador desde su servidor.
¿Puedo probarlo en el Unity Editor?
Puede probar su flujo. En el Editor, en escritorio y en WebGL, Open verifica el App ID y el token y luego informa Unsupported, y Moonetix.IsSupported es false. Para ver el offerwall en sí, compile para Android o iOS y pruebe en un teléfono o en el simulador de iOS.
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.