Offerwall para cualquier sitio web. Enlace, iframe o botón.
Ponga el offerwall de Moonetix en cualquier sitio web, desde WordPress hasta una app personalizada, con un enlace firmado, un iframe o un botón flotante. Sus usuarios ganan su moneda, y cada recompensa llega a su servidor como un postback firmado.
- 3Formas de mostrarlo
- 0SDK que instalar
- HTTPSCualquier sitio, cualquier tecnología
<iframe title="Offerwall"
src="https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH"
style="border:0;width:100%;height:100vh"></iframe>Comience en tres 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.
-
Genere el enlace firmado en su servidor
Cada enlace lleva el ID de su usuario con sesión iniciada y un hash HMAC-SHA256 creado con su link hash salt. El hash impide que alguien cambie el ID de usuario para abrir el muro como otra persona, así que genérelo en su servidor y nunca ponga el salt en una página.
offerwall.php<?php // Build the link on your server, for the signed-in user $hash = hash_hmac('sha256', $userId, $linkHashSalt); $url = 'https://wall.moonetix.com/' . $appId . '?user_id=' . rawurlencode($userId) . '&hash=' . $hash;offerwall.js// Build the link on your server, for the signed-in user const crypto = require('crypto'); const hash = crypto.createHmac('sha256', linkHashSalt) .update(String(userId)) .digest('hex'); const url = `https://wall.moonetix.com/${appId}` + `?user_id=${encodeURIComponent(userId)}&hash=${hash}`;offerwall.py# Build the link on your server, for the signed-in user import hmac, hashlib from urllib.parse import quote uid = str(user_id) hash = hmac.new(link_hash_salt.encode(), uid.encode(), hashlib.sha256).hexdigest() url = f"https://wall.moonetix.com/{app_id}?user_id={quote(uid)}&hash={hash}" -
Muéstrelo de la forma que mejor encaje con su sitio
Abra el enlace desde su menú, insértelo en su propia página o agregue el botón flotante a todas las páginas. Puede usar más de uno a la vez: todos comparten las mismas recompensas y postbacks.
earn.html<iframe title="Offerwall" src="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" style="border:0;width:100%;height:100vh"></iframe>layout.html<script src="https://wall.moonetix.com/embed.js" async data-button-url="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" data-button-text="Earn rewards" data-button-color="#004ABB" data-button-position="right"></script>menu.html<a href="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" data-moonetix-open>Earn rewards</a> <script src="https://wall.moonetix.com/embed.js" async></script>Enlacehttps://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}&sub1=homepage -
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
Directamente en su página
El botón flotante abre el offerwall en una ventana emergente, así que los usuarios nunca salen de la página en la que están.
Todo lo que el muro hace por usted
- Una página completa de offerwall
Pestañas Earn y My offers, búsqueda, categorías y orden, con las ofertas adecuadas para el país y el dispositivo de cada usuario.
- Su moneda
Cada recompensa se muestra con el nombre y el ícono de su propia moneda, calculada con su tasa de conversión y el reparto con el usuario.
- Su marca
Los colores, el radio de las esquinas, el relleno, el tamaño de fuente y el ícono de la moneda se configuran en su panel, sin código.
- Enlaces firmados
La seguridad del enlace está activada por defecto, así que nadie puede abrir su muro como si fuera uno de sus usuarios.
- Sub IDs
Agregue hasta cinco valores propios, como la página o la campaña, y recíbalos en cada postback y en cada reporte.
- Soporte para usuarios
Los usuarios siguen sus ofertas en My offers y pueden reportar una recompensa faltante directamente desde la oferta.
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.
Verificar un enlace
Pegue un enlace que generó su sitio, o escriba un ID de usuario para ver el enlace exacto que debería generar su servidor. Ambos deben ser idénticos.
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 offerwall en su sitio web, qué lo causa y cómo solucionarlo.
Link not validEl hash no coincide con el ID de usuario del enlace.
SoluciónFirme el ID de usuario exacto con el link hash salt, no con la postback secret key, en hexadecimal en minúsculas.
Missing user IDEl ID de usuario está vacío o tiene caracteres que no aceptamos.
SoluciónUse de 1 a 100 caracteres de A-Z a-z 0-9 . _ @ : + - y codifíquelo para URL.
Blank iframe or pop-upLa página no está en el sitio web que registró para la app, o no es https.
SoluciónInsértelo en una página https de ese dominio o de un subdominio. Para otro sitio, agregue una app nueva.
No floating buttonFalta data-button-url o no es un enlace del offerwall.
SoluciónUse el enlace firmado completo que empieza con https://wall.moonetix.com/.
VPN or Proxy detectedEstá haciendo pruebas a través de una VPN, un proxy o una red en la nube.
SoluciónPruebe desde una conexión normal de casa o de datos móviles.
Fewer offers than expectedOcultó algunas ofertas, o hay menos ofertas activas en ese país o en ese dispositivo.
SoluciónAbra Offers en su panel, ponga Status en Hidden y haga clic en Show para volver a mostrar una oferta.
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
- Funciona en
- Cualquier sitio web https: WordPress, Next.js, Laravel, HTML simple y más
- Formas de mostrarlo
- Enlace, iframe, botón flotante o su propio botón
- Reglas de inserción
- Los frames y las ventanas emergentes se cargan en el sitio web que registró y en sus subdominios
- Tamaño del script
- Un pequeño script, solo para el botón y la ventana emergente
- Recompensas
- Postback firmado de servidor a servidor, con hasta 5 reintentos
- Precio
- Gratuito para publishers aprobados
Empiece con código que funciona
- Next.jsUna página Earn en Next.js con un enlace al offerwall firmado por el servidor y una ruta de postback verificada.
- LaravelUna app de Laravel con una página Earn y una ruta de postback que acredita cada oferta exactamente una vez.
- DjangoUna app de Django con una página Earn y una vista de postback que acredita cada oferta exactamente una vez.
- Sitio de recompensasUn pequeño sitio de recompensas con cuentas, saldo, una página Earn, postbacks verificados y solicitudes de canje que usted aprueba.
Otras integraciones
- 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.
- SDK de React NativePara apps de React Native y Expo, con tipos de TypeScript.
- Todas las integracionesCompárelas lado a lado.
Preguntas sobre sitios web
Lo que preguntan los desarrolladores antes de agregar el offerwall a su sitio web.
¿Se quedó atascado? Contáctenos
¿Tengo que instalar algo para agregar un offerwall a mi sitio web?
No. El offerwall funciona en Moonetix. Usted agrega un enlace firmado a su sitio, lo inserta con un iframe o carga un pequeño script para el botón flotante. Su servidor solo genera el enlace y recibe los postbacks.
¿Funciona con WordPress?
Sí. Genere el enlace firmado en un pequeño plugin o en su tema con el ejemplo en PHP, y luego insértelo en una página Earn o agregue el botón flotante. La Academy tiene una guía paso a paso para WordPress.
¿Por qué el enlace necesita un hash?
El hash es un HMAC-SHA256 del ID de usuario, creado con su link hash salt. Demuestra que su servidor creó el enlace para ese usuario, así que nadie puede cambiar el ID de usuario en la barra de direcciones y ganar como si fuera otra persona.
¿Por qué el offerwall no se carga en mi iframe?
Por seguridad, los frames y las ventanas emergentes solo se cargan en páginas https del sitio web que registró para la app y en sus subdominios. Abrir el enlace directamente en una pestaña, una ventana nueva o un WebView móvil funciona en cualquier lugar.
¿Cómo reciben mis usuarios sus recompensas?
Moonetix envía un postback firmado a su servidor por cada recompensa. Su servidor verifica el hash y acredita al usuario en su moneda. Una reversión posterior llega con el mismo ID de transacción, para que pueda retirar la recompensa.
¿Puedo elegir qué ofertas aparecen?
Sí. En la página Offers de su panel puede ocultar cualquier oferta, y desaparece de su offerwall, del muro insertado, del botón flotante y de la Offers API de esa app.
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.