Offerwall para qualquer site. Link, iframe ou botão.
Coloque o offerwall da Moonetix em qualquer site, do WordPress a um app próprio, com um link assinado, um iframe ou um botão flutuante. Os seus usuários ganham a sua moeda, e cada recompensa chega ao seu servidor como um postback assinado.
- 3Formas de exibir
- 0SDKs para instalar
- HTTPSQualquer site, qualquer stack
<iframe title="Offerwall"
src="https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH"
style="border:0;width:100%;height:100vh"></iframe>Entre no ar em três passos.
Copie o código, substitua os placeholders pelos valores do seu painel em Offerwalls, seu offerwall, Integration, e teste antes de lançar.
-
Crie o link assinado no seu servidor
Cada link leva o ID do seu usuário logado e um hash HMAC-SHA256 feito com o seu link hash salt. O hash impede que alguém altere o ID do usuário para abrir o wall como outra pessoa, então gere-o no seu servidor e nunca coloque o salt em uma 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}" -
Mostre do jeito que combina com o seu site
Abra o link pelo seu menu, incorpore-o em uma página própria ou adicione o botão flutuante a todas as páginas. Você pode usar mais de um ao mesmo tempo: todos compartilham as mesmas recompensas e 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>Linkhttps://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}&sub1=homepage -
Credite as recompensas com o postback
Cada recompensa chega ao seu servidor como um postback assinado. Verifique o hash, adicione a recompensa uma única vez por ID de transação e retire-a se um postback posterior a estornar. Postbacks com falha são reenviados até 5 vezes.
Painel, aba 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 TownChegue ao nível 15+1,500
WPS OfficeInstalar e abrir+2,000
Bus EscapeChegue ao nível 20+450
CleanfoxSign up in the app+800
Direto na sua página
O botão flutuante abre o offerwall em um pop-up, então os usuários nunca saem da página em que estão.
Tudo o que o offerwall faz por você
- Uma página de offerwall completa
Abas Earn e My offers, busca, categorias e ordenação, com as ofertas que se encaixam no país e no dispositivo de cada usuário.
- A sua moeda
Cada recompensa aparece com o nome e o ícone da sua própria moeda, calculada com a sua taxa de conversão e a divisão com o usuário.
- A sua marca
Cores, raio dos cantos, espaçamento, tamanho da fonte e o ícone da moeda são definidos no seu painel, sem código.
- Links assinados
A segurança do link vem ativada por padrão, então ninguém consegue abrir o seu offerwall como se fosse um dos seus usuários.
- Sub IDs
Adicione até cinco valores próprios, como a página ou a campanha, e receba-os de volta em cada postback e relatório.
- Suporte ao usuário
Os usuários acompanham as ofertas em My offers e podem reportar uma recompensa que não chegou direto na oferta.
Teste e depois lance.
Tudo o que você precisa verificar antes que usuários reais vejam o seu offerwall, com as ferramentas integradas ao seu painel.
Open as a test user
Em Integration status, na aba Integration, abra o seu offerwall como o usuário owner-test. Visitas de teste não são contadas como usuários.
Verificar um link
Cole um link gerado pelo seu site ou digite um ID de usuário para ver o link exato que o seu servidor deve gerar. Os dois precisam ser idênticos.
Send a test postback
Escolha o usuário, o status e o pagamento, e veja exatamente o que o seu servidor respondeu, com o código de resposta e o tempo. Os IDs de transação de teste começam com test_.
Teste a partir de uma conexão normal
VPNs, proxies, Tor e redes de nuvem são bloqueados, então teste no Wi-Fi de casa ou nos dados móveis, em um país onde haja ofertas ativas.
Checklist de lançamento
0 de 11 prontos
Pronto para lançar. Seu progresso fica salvo neste navegador.
Erros comuns, resolvidos rápido.
O que pode aparecer enquanto você integra o offerwall ao site, a causa e a solução.
Link not validO hash não corresponde ao ID de usuário no link.
SoluçãoAssine o ID de usuário exato com o link hash salt, não com a postback secret key, em hexadecimal minúsculo.
Missing user IDO ID do usuário está vazio ou tem caracteres que não aceitamos.
SoluçãoUse de 1 a 100 caracteres entre A-Z a-z 0-9 . _ @ : + - e codifique-o para URL.
Blank iframe or pop-upA página não está no site que você cadastrou para o app, ou não é https.
SoluçãoIncorpore-o em uma página https desse domínio ou de um subdomínio. Para outro site, adicione um novo app.
No floating buttondata-button-url está ausente ou não é um link de offerwall.
SoluçãoUse o link assinado completo que começa com https://wall.moonetix.com/.
VPN or Proxy detectedVocê está testando por uma VPN, um proxy ou uma rede de nuvem.
SoluçãoTeste a partir de uma conexão residencial ou móvel normal.
Fewer offers than expectedVocê ocultou algumas ofertas, ou há menos ofertas ativas naquele país ou naquele dispositivo.
SoluçãoAbra Offers no seu painel, defina Status como Hidden e clique em Show para trazer uma oferta de volta.
Postback log shows 403 or 404O seu script rejeitou o postback, ou a URL está errada.
SoluçãoAbra a URL do log em um navegador e confira o seu código de hash.
Postback log shows a timeoutO seu script leva mais de 6 segundos para responder.
SoluçãoResponda primeiro com 200 e execute o trabalho demorado em segundo plano.
Postback log shows 301 or 302A sua URL redireciona, por exemplo de http para https.
SoluçãoUse a URL final. Os postbacks não seguem redirecionamentos.
Nenhum resultado. Veja a lista completa na documentação ou fale conosco.
Em resumo
- Funciona em
- Qualquer site https: WordPress, Next.js, Laravel, HTML puro e muito mais
- Formas de exibir
- Link, iframe, botão flutuante ou o seu próprio botão
- Regras de incorporação
- Frames e pop-ups carregam no site que você cadastrou e nos subdomínios dele
- Tamanho do script
- Um pequeno script, só para o botão e o pop-up
- Recompensas
- Postback assinado de servidor para servidor, reenviado até 5 vezes
- Preço
- Gratuito para publishers aprovados
Comece com código que funciona
- Next.jsUma página de ganhos em Next.js com um link de offerwall assinado pelo servidor e uma rota de postback verificada.
- LaravelUm app Laravel com uma página de ganhos e uma rota de postback que credita cada oferta exatamente uma vez.
- DjangoUm app Django com uma página de ganhos e uma view de postback que credita cada oferta exatamente uma vez.
- Site de recompensasUm pequeno site de recompensas com contas, saldo, uma página de ganhos, postbacks verificados e pedidos de resgate que você aprova.
Outras integrações
- Offers APIReceba as ofertas em JSON e mostre-as com o seu próprio design.
- Android SDKUma tela de offerwall nativa para apps em Kotlin e Java.
- iOS SDKUm offerwall nativo para Swift, SwiftUI e Objective-C.
- Unity SDKOfertas com recompensa para jogos Android e iOS, em C#.
- Flutter SDKUm plugin em Dart para Android e iOS.
- React Native SDKPara apps React Native e Expo, com tipos de TypeScript.
- Todas as integraçõesCompare lado a lado.
Perguntas sobre sites
O que os desenvolvedores perguntam antes de adicionar o offerwall ao site.
Travou em alguma coisa? Fale conosco
Preciso instalar algo para adicionar um offerwall ao meu site?
Não. O offerwall roda na Moonetix. Você adiciona um link assinado ao seu site, incorpora com um iframe ou carrega um pequeno script para o botão flutuante. O seu servidor só gera o link e recebe os postbacks.
Funciona com WordPress?
Sim. Gere o link assinado em um pequeno plugin ou no seu tema com o exemplo em PHP e depois incorpore-o em uma página de ganhos ou adicione o botão flutuante. A Academy tem um guia passo a passo para WordPress.
Por que o link precisa de um hash?
O hash é um HMAC-SHA256 do ID do usuário, feito com o seu link hash salt. Ele prova que o seu servidor criou o link para aquele usuário, então ninguém consegue mudar o ID do usuário na barra de endereço e ganhar se passando por outra pessoa.
Por que o offerwall não carrega no meu iframe?
Por segurança, frames e pop-ups só carregam em páginas https do site que você cadastrou para o app e nos subdomínios dele. Abrir o link diretamente em uma aba, em uma nova janela ou em um WebView mobile funciona em qualquer lugar.
Como os meus usuários recebem as recompensas?
A Moonetix envia um postback assinado ao seu servidor a cada recompensa. O seu servidor verifica o hash e credita o usuário na sua moeda. Um estorno posterior chega com o mesmo ID de transação, para que você possa retirar a recompensa.
Posso escolher quais ofertas aparecem?
Sim. Na página Offers do seu painel você pode ocultar qualquer oferta, e ela desaparece do seu offerwall, da versão incorporada, do botão flutuante e da Offers API daquele app.
Transforme o seu tráfego em ganhos.
Crie uma conta de publisher gratuita e ganhe com cada oferta que seus usuários concluírem no seu site, app, jogo ou comunidade.