Para desarrolladores
SDK de offerwall y API para apps Android, iOS y web
Pon un offerwall con recompensas en tu app con una sola llamada. El SDK abre el muro alojado, nuestro servidor avisa al tuyo cuando un usuario gana y tu clave secreta nunca viaja dentro de la app.
Lo que suele fallar al integrar un offerwall
Secretos dentro de la app
Todo lo que va en un APK o un IPA es público. Un SDK que necesita tu clave secreta la está regalando.
Recompensas acreditadas desde el cliente
Si la app decide que un usuario ha ganado, cualquiera con un depurador puede ganar lo que quiera.
Callbacks que no puedes probar
Sin un postback de prueba, descubres que tu endpoint falla cuando los usuarios empiezan a quejarse.
Lo que obtienes
SDK para Android
Una librería en Kotlin para Android 5.0 o superior sin dependencias, más un AAR precompilado. OfferwallGG.show() abre el muro; OfferwallView lo integra en tu pantalla.
SDK para iOS
Un paquete en Swift para iOS 13 o superior sin dependencias, con un view controller y una vista de SwiftUI.
Muro web
Una URL con tu clave pública y el ID del usuario, en un iframe, una pestaña o el navegador integrado de Telegram.
API REST
Ofertas, encuestas y visitas web pagadas en JSON desde tu servidor, para construir tu propia lista.
Postbacks firmados
Cada oferta completada y cada reversión se firma con tu secreto. Verifica la firma en PHP, Node o Python con nuestros ejemplos.
Plugins
Un plugin para WordPress y addons para VieFaucet y ClaimBits, si tu sitio usa alguno de ellos.
Elige la integración que te encaja
App nativa de Android o iOS
Usa el SDK. Tu servidor firma el enlace y acredita a los usuarios desde el postback.
Sitio web o app web
Usa el enlace del muro en un iframe o en una pestaña nueva. No hay nada que instalar.
Lista de ofertas propia
Llama a la API desde tu servidor y muestra las ofertas en tu propia interfaz.
Mini app o bot de Telegram
Carga el enlace del muro dentro de la mini app o ábrelo desde un botón del bot.
De cero a la primera recompensa
-
Crea una ubicación
Recibes una clave pública para el muro y una clave secreta para tu servidor.
-
Abre el muro
Llama al SDK con la clave pública y el ID de tu usuario, o construye el enlace del muro.
-
Recibe el postback
Verifica la firma, acredita al usuario una sola vez por ID de transacción y responde 200.
-
Lanza una prueba
Envía un crédito de prueba y una reversión de prueba desde el panel y mira lo que responde tu servidor.
Preguntas frecuentes
¿El SDK de offerwall es gratuito?
Sí. Los SDK de Android e iOS, los plugins y la API no cuestan nada. Ganas con cada oferta que completan tus usuarios.
¿Por qué el SDK es una vista web y no una lista nativa?
La API necesita tu clave secreta, y cualquiera que descargue una app puede leer lo que lleva dentro. El SDK muestra el muro alojado solo con tu clave pública, y las recompensas se acreditan desde tu servidor.
¿Qué versiones de Android e iOS son compatibles?
Android 5.0 (API 21) o superior, e iOS 13 o superior. Ninguno de los dos SDK tiene dependencias de terceros.
¿Puedo usar el offerwall en una mini app de Telegram?
Sí. Carga el enlace de tu muro dentro de la mini app con el ID de tu usuario, añade el dominio de la mini app a los dominios de inserción permitidos de tu ubicación y acredita a los usuarios desde el postback.
¿Cómo verifico un postback?
Cada postback lleva una firma hecha con tu clave secreta sobre el ID de usuario, el ID de transacción y el importe tal como se envían. La documentación para desarrolladores muestra la verificación en PHP, Node y Python.
¿Necesito un SDK para un sitio web?
No. Un sitio web solo necesita el enlace del muro, en un iframe o en una pestaña nueva.
Páginas relacionadas
Consigue tus claves y el SDK
Regístrate gratis, crea una ubicación y descarga el SDK con todo lo necesario para mostrar el muro hoy mismo.
El panel, la documentación y el soporte están en inglés.