Para desenvolvedores
SDK de offerwall e API para apps Android, iOS e web
Coloque um offerwall com recompensas no seu app com uma única chamada. O SDK abre o offerwall hospedado, nosso servidor avisa o seu quando um usuário ganha, e sua chave secreta nunca vai dentro do app.
O que costuma dar errado em uma integração de offerwall
Segredos dentro do app
Tudo o que está em um APK ou IPA é público. Um SDK que precisa da sua chave secreta acaba entregando essa chave.
Recompensas creditadas pelo cliente
Se o app decide que um usuário ganhou, qualquer pessoa com um depurador ganha quanto quiser.
Callbacks que você não consegue testar
Sem um postback de teste, você descobre que seu endpoint está quebrado quando os usuários começam a reclamar.
O que você recebe
SDK para Android
Uma biblioteca Kotlin para Android 5.0 ou superior, sem dependências, mais um AAR pré-compilado. OfferwallGG.show() abre o offerwall; OfferwallView o incorpora.
SDK para iOS
Um pacote Swift para iOS 13 ou superior, sem dependências, com um view controller e uma view SwiftUI.
Offerwall web
Uma URL com sua chave pública e o ID do usuário, em um iframe, em uma aba ou no navegador integrado do Telegram.
API REST
Ofertas, pesquisas e visitas pagas a sites em JSON a partir do seu servidor, para montar sua própria lista.
Postbacks assinados
Cada conclusão e cada estorno é assinado com o seu segredo. Verifique em PHP, Node ou Python com nossos exemplos.
Plugins
Um plugin para WordPress e addons para VieFaucet e ClaimBits, se o seu site usa um deles.
Escolha a integração certa
App nativo Android ou iOS
Use o SDK. Seu servidor assina o link e credita os usuários a partir do postback.
Site ou web app
Use o link do offerwall em um iframe ou em uma nova aba. Nada para instalar.
Lista de ofertas personalizada
Chame a API pelo seu servidor e exiba as ofertas na sua própria interface.
Mini app ou bot do Telegram
Carregue o link do offerwall dentro do mini app ou abra-o pelo botão de um bot.
Do zero à primeira recompensa
-
Crie um placement
Você recebe uma chave pública para o offerwall e uma chave secreta para o seu servidor.
-
Abra o offerwall
Chame o SDK com a chave pública e o ID do seu usuário, ou monte o link do offerwall.
-
Receba o postback
Verifique a assinatura, credite o usuário uma vez por ID de transação e responda 200.
-
Dispare um teste
Envie um crédito de teste e um estorno de teste pelo painel e veja a resposta do seu servidor.
Perguntas frequentes
O SDK de offerwall é gratuito?
Sim. Os SDKs para Android e iOS, os plugins e a API não custam nada. Você ganha a cada oferta que seus usuários concluem.
Por que o SDK é uma web view e não uma lista nativa?
A API precisa da sua chave secreta, e qualquer coisa dentro de um app pode ser lida por quem o baixa. O SDK mostra o offerwall hospedado apenas com sua chave pública, e as recompensas são creditadas pelo seu servidor.
Quais versões do Android e do iOS são compatíveis?
Android 5.0 (API 21) ou superior e iOS 13 ou superior. Nenhum dos SDKs tem dependências de terceiros.
Posso usar o offerwall em um mini app do Telegram?
Sim. Carregue o link do seu offerwall dentro do mini app com o ID do seu usuário, adicione o domínio do mini app aos domínios de incorporação permitidos do seu placement e credite os usuários a partir do postback.
Como verifico um postback?
Cada postback traz uma assinatura feita com sua chave secreta sobre o ID do usuário, o ID da transação e o valor, exatamente como enviados. A documentação para desenvolvedores mostra a verificação em PHP, Node e Python.
Preciso de um SDK para um site?
Não. Um site só precisa do link do offerwall, em um iframe ou em uma nova aba.
Páginas relacionadas
Pegue suas chaves e o SDK
Cadastre-se grátis, crie um placement e baixe o SDK com tudo o que você precisa para exibir o offerwall hoje mesmo.
O painel, a documentação e o suporte estão em inglês.