SDK de offerwall para Android. Nativo, em poucas linhas de Kotlin.

Abra o offerwall da Moonetix como uma tela nativa no seu app Android. Instale uma dependência do Gradle, crie uma sessão no seu servidor e chame open. Funciona com Kotlin, Java e Jetpack Compose.

  • 5.0+Android, API 21
  • 2.0.1Versão atual
  • 0Permissões extras
Android SDKVersão 2.0.1
EarnActivity.kt
// Once, in your Application class
Moonetix.init(applicationContext, "YOUR_APP_ID")
 
// When the user taps Earn
Moonetix.open(activity, token)

Entre no ar em quatro passos.

Copie o código, substitua os placeholders pelos valores do seu painel em Offerwalls, seu offerwall, Integration, e teste antes de lançar.

  1. Instale o SDK

    Adicione o repositório Maven da Moonetix e uma dependência. O SDK adiciona sozinho a permissão de internet e a sua tela ao manifest, e já traz as próprias regras de R8 e ProGuard.

    settings.gradle.kts
    dependencyResolutionManagement {
        repositories {
            google()
            mavenCentral()
            maven { url = uri("https://moonetix.com/maven") }
        }
    }
     
    // app/build.gradle.kts
    dependencies {
        implementation("com.moonetix:offerwall:2.0.1")
    }
  2. Adicione um endpoint de token ao seu servidor

    O seu app nunca guarda a API key. Quando um usuário toca em Earn, o seu app pede uma sessão ao seu servidor, e o seu servidor pede à Moonetix um token de uso único para aquele usuário logado. Um token funciona uma única vez, por 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']);
  3. Abra o offerwall

    Chame init uma vez com o App ID do seu painel e depois abra o offerwall com o token do seu servidor. Os erros nunca lançam exceções: eles chegam como eventos, e onClosed é um bom momento para atualizar o saldo do usuário.

    EarnActivity.kt
    Moonetix.init(applicationContext, "YOUR_APP_ID")
     
    Moonetix.setListener(object : MoonetixListener {
        override fun onClosed() {
            refreshBalance()
        }
        override fun onError(error: MoonetixError) {
            Log.w("Earn", "${error.code}: ${error.message}")
        }
    })
     
    lifecycleScope.launch {
        val token = fetchMoonetixToken(authToken)
        Moonetix.open(this@EarnActivity, token)
    }
  4. 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.

    Macros e novas tentativas de postback

    Painel, aba Postback
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Ganhe moedas12,450 moedas
GanharMinhas ofertas
  • 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
Recompensa creditadaTravel Town · +1,500 moedas
Tela nativa
Postback 200 OK

O que os seus usuários veem

Uma tela nativa sobre o seu app, com seu título e suas cores, sua moeda e cada recompensa confirmada por um postback.

O que o SDK faz por você

  • As ofertas abrem no lugar certo

    As ofertas que levam ao Google Play abrem no app da loja, e os outros sites abrem no navegador, para que as instalações sejam rastreadas corretamente.

  • Nenhuma chave dentro do seu app

    O seu app guarda apenas o App ID. As sessões são criadas no seu servidor e funcionam uma única vez, então ninguém consegue abrir o offerwall como outro usuário.

  • Uma tela protegida

    Somente páginas do offerwall carregam dentro dela, sem nenhuma ponte JavaScript para o seu app.

  • Navegação nativa

    O botão voltar navega dentro do offerwall, e a rotação da tela ou um reinício por pouca memória mantém o usuário onde ele estava.

  • O seu design, sem código extra

    A tela usa o título e as cores da aba Design do seu painel e aplica as mudanças em poucos minutos.

  • Sem ID de publicidade

    O SDK não usa o identificador de publicidade e não rastreia usuários entre apps.

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.

  1. 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.

  2. Execute em um dispositivo real

    Gere o build para Android ou iOS e abra o offerwall pelo seu botão Earn com um token novo a cada vez.

  3. 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_.

  4. 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

Erros comuns, resolvidos rápido.

O que pode aparecer enquanto você integra o Android SDK, a causa e a solução.

  • INVALID_APP_ID

    O valor passado para init não é o App ID. Passar a API key aqui é o erro mais comum.

    SoluçãoCopie novamente o App ID de 24 caracteres na aba Integration.

  • INVALID_TOKEN

    O app passou algo diferente do token, ou um token criado com a API key de outro app.

    SoluçãoPasse apenas o campo token, que começa com sst_, e use o App ID e a API key do mesmo app.

  • TOKEN_EXPIRED_OR_USED

    O token tem mais de 10 minutos ou já foi usado, por exemplo guardado de um toque anterior.

    SoluçãoCrie um novo token a cada abertura, logo quando o usuário tocar em Earn.

  • NOT_INITIALIZED

    open foi chamado antes de init.

    SoluçãoChame Moonetix.init em Application.onCreate.

  • UNKNOWN

    O Android System WebView está ausente ou desativado, ou a Activity que você passou já estava fechando.

    SoluçãoPeça ao usuário para atualizar o Android System WebView e passe uma Activity que esteja na tela.

  • onClosed never arrives

    O listener foi limpo no onStop, ou pertencia a uma tela que não existe mais.

    SoluçãoDefina-o no onCreate e limpe-o no onDestroy, ou defina-o uma vez na sua Application.

  • 403 from /v1/session

    app_not_live significa que o app está pausado ou que a sua conta não está ativa. user_blocked significa que bloqueamos esse usuário.

    SoluçãoNão mostre o offerwall. Para app_not_live, confira suas notificações.

  • VPN or Proxy detected

    O dispositivo está em uma VPN, um proxy ou uma rede de nuvem, onde as ofertas não podem ser rastreadas.

    SoluçãoTeste em uma conexão residencial ou móvel normal, em um país onde haja ofertas ativas.

  • Postback log shows 403 or 404

    O 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 timeout

    O 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 302

    A sua URL redireciona, por exemplo de http para https.

    SoluçãoUse a URL final. Os postbacks não seguem redirecionamentos.

Em resumo

Versão mínima
Android 5.0 (API 21), com Android System WebView ou Chrome
Linguagens
Kotlin, Java e Jetpack Compose
Pacote
com.moonetix:offerwall:2.0.1 de moonetix.com/maven
Dependências
Apenas a biblioteca padrão do Kotlin
Permissões
Apenas internet, adicionada pelo SDK
Preço
Gratuito para publishers aprovados

Outras integrações

Perguntas sobre Android

O que os desenvolvedores perguntam antes de adicionar o Android SDK.

Travou em alguma coisa? Fale conosco

Quais versões do Android o SDK da Moonetix suporta?

Android 5.0 (API 21) ou mais recente, com Android System WebView ou Chrome no dispositivo. A única dependência é a biblioteca padrão do Kotlin, então funciona em apps Kotlin e Java.

Preciso adicionar regras de ProGuard ou R8?

Não. O SDK traz as próprias regras de R8 e ProGuard e adiciona sozinho a permissão de internet e a tela do offerwall ao seu manifest.

A minha API key vai dentro do app?

Não. O seu app guarda apenas o App ID. O seu servidor cria uma sessão com a API key e passa um token para o app. Um token funciona uma única vez e por 10 minutos, então nada no seu app consegue abrir o offerwall de outro usuário.

O SDK usa o ID de publicidade?

Não. Ele não usa o ID de publicidade, não pede nenhuma permissão além do acesso à internet e não rastreia usuários entre apps. A documentação lista o que declarar no formulário Data safety do Google Play.

Como recompenso os usuários no meu app?

Credite as recompensas a partir do postback assinado no seu servidor, nunca a partir de eventos no app, porque eventos podem ser falsificados no dispositivo. Quando o usuário fechar o offerwall, carregue o novo saldo dele do seu servidor.

A tela do offerwall pode combinar com o meu app?

Sim. Ela usa o título e as cores da aba Design do seu painel. Você também pode passar o seu próprio título e a cor da toolbar, ou ocultar a marca com MoonetixOptions.

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.

Segmentação mundial
Mais
Entrar