SDK de offerwall para iOS. Swift, SwiftUI y Objective-C.
Abra el offerwall de Moonetix en su app para iPhone y iPad con un solo paquete de Swift. Usa solo UIKit y WebKit, no tiene dependencias de terceros e incluye un privacy manifest.
- 13+iOS y iPadOS
- 2.0.1Versión actual
- 0Dependencias de terceros
import MoonetixOfferwall
Moonetix.configure(appId: "YOUR_APP_ID")
// When the user taps Earn
Moonetix.open(token: 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 paquete en Xcode con File, Add Package Dependencies, o use CocoaPods. También puede descargar el xcframework e integrarlo a mano. Compile con Xcode 16 o posterior.
Package.swiftdependencies: [ .package(url: "https://moonetix.com/ios/moonetix-ios.git", from: "2.0.1"), ], targets: [ .target(name: "MyApp", dependencies: [ .product(name: "MoonetixOfferwall", package: "moonetix-ios"), ]), ]Podfilepod 'MoonetixOfferwall', :podspec => 'https://moonetix.com/ios/2.0.1/MoonetixOfferwall.podspec' -
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
Configure una vez con el App ID de su panel y luego abra el offerwall con un token nuevo. Sin un view controller, el SDK se presenta desde la pantalla superior de su app, así que también funciona desde SwiftUI.
EarnViewController.swiftMoonetix.configure(appId: "YOUR_APP_ID") Moonetix.onClosed = { [weak self] in self?.refreshBalance() } Moonetix.onError = { error in print(error.code.name, error.message) } Moonetix.open(token: token, from: self)EarnButton.swiftButton("Earn coins") { Task { let token = try await api.fetchMoonetixToken() Moonetix.open(token: token) } }EarnViewController.m@import MoonetixOfferwall; [Moonetix configureWithAppId:@"YOUR_APP_ID"]; [Moonetix openWithToken:token from:self options:nil]; -
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 la App Store 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 de cerrar vuelve a su app, deslizar desde el borde izquierdo retrocede dentro del offerwall, y al volver del segundo plano se reanuda donde estaba el usuario.
- Accesible por defecto
El modo claro y oscuro, los tamaños de texto más grandes y VoiceOver funcionan sin configuración adicional.
- Privacy manifest incluido
El SDK incluye su privacy manifest, no usa fingerprinting del dispositivo y no usa el identificador de publicidad.
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 iOS, 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.configure cuando se inicie su app.
UNKNOWNEl offerwall ya está abierto, o no había ningún view controller en pantalla desde el cual presentarlo.
SoluciónNo lo abra más de una vez al mismo tiempo y pase un view controller visible con open(token:from:).
Delegate is never calledMoonetix.delegate es una referencia débil, así que el objeto ya se había liberado.
SoluciónMantenga una referencia fuerte a su delegate o use los closures.
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
- iOS 13, iPhone y iPad, compilado con Xcode 16 o posterior
- Lenguajes
- Swift, SwiftUI y Objective-C
- Instalación
- Swift Package Manager, CocoaPods o un xcframework
- Dependencias
- Solo UIKit y WebKit
- Privacidad
- Privacy manifest incluido, sin identificador de publicidad
- Precio
- Gratuito para publishers aprobados
Empiece con código que funciona
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 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 iOS
Lo que preguntan los desarrolladores antes de agregar el SDK de iOS.
¿Se quedó atascado? Contáctenos
¿Qué versiones de iOS admite el SDK de Moonetix?
iOS 13 o posterior en iPhone y iPad, compilado con Xcode 16 o posterior. El SDK usa solo UIKit y WebKit y no tiene dependencias de terceros.
¿Puedo usarlo con SwiftUI?
Sí. Llame a Moonetix.open(token:) sin un view controller y el SDK se presenta desde la pantalla superior de su app, lo que funciona desde botones de SwiftUI.
¿Cómo lo instalo?
Con Swift Package Manager desde https://moonetix.com/ios/moonetix-ios.git, con CocoaPods desde nuestro podspec, o integrando el xcframework a mano.
¿Qué declaro en los detalles de privacidad de la App Store?
User ID, Device ID, Coarse Location y Product Interaction, todos vinculados al usuario, no usados para rastreo, para App Functionality. El privacy manifest del SDK incluye los mismos datos.
¿El offerwall infringe las reglas de revisión de la App Store?
Apple tiene reglas para las apps que recompensan a los usuarios. La Academy tiene una guía para usar un offerwall en una app de iOS dentro de esas reglas, incluido cómo redactar sus recompensas.
¿Cómo se recompensa a los usuarios?
Su servidor recibe un postback firmado por cada recompensa y acredita al usuario. Nunca acredite a partir de eventos de la app, porque se pueden falsificar en un dispositivo.
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.