SDK de offerwall para React Native. Pronto para Expo, com TypeScript incluído.

Abra o offerwall da Moonetix como uma tela nativa a partir do React Native ou do Expo. O pacote traz os SDKs de Android e iOS, funciona com a New Architecture e já inclui os próprios tipos de TypeScript.

  • 0.77+React Native
  • 53+Expo SDK
  • TSTipos incluídos
React Native SDKVersão 2.0.1
EarnScreen.tsx
import { Moonetix } from '@moonetix/react-native-offerwall';
 
Moonetix.init('YOUR_APP_ID');
 
// When the user taps Earn
Moonetix.open(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 pacote

    Adicione o registro da Moonetix para o escopo @moonetix, depois instale o pacote e gere o build do app novamente. No Expo, adicione o config plugin e use um development build, porque o Expo Go não carrega código nativo.

    Terminal
    # .npmrc, next to package.json
    @moonetix:registry=https://moonetix.com/npm/
     
    npm install @moonetix/react-native-offerwall
    cd ios && pod install
  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 open com um token novo. addListener retorna uma subscription, então remova-a quando a sua tela sair.

    EarnScreen.tsx
    import { Moonetix } from '@moonetix/react-native-offerwall';
     
    Moonetix.init('YOUR_APP_ID');
     
    useEffect(() => {
      const closed = Moonetix.addListener('closed', refreshBalance);
      const failed = Moonetix.addListener('error', (error) => {
        console.warn(`${error.code}: ${error.message}`);
      });
      return () => {
        closed.remove();
        failed.remove();
      };
    }, []);
     
    async function openOfferwall() {
      const url = 'https://your-server.example/api/moonetix/session';
      const res = await fetch(url, { method: 'POST' });
      const { token } = await res.json();
      Moonetix.open(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 pacote faz por você

  • SDKs nativos incluídos

    O Gradle do Android e o CocoaPods do iOS são configurados para você. Execute pod install e gere o build novamente.

  • Config plugin do Expo

    Adicione uma linha ao app.json e depois rode o prebuild ou inicie um EAS Build.

  • Tipos de TypeScript

    init, open, eventos e códigos de erro tipados, com os mesmos nomes usados pelos SDKs nativos.

  • As ofertas abrem no lugar certo

    As ofertas de loja abrem no Google Play ou na App Store, para que as instalações sejam rastreadas corretamente.

  • Nenhuma chave no seu bundle

    O seu bundle JavaScript guarda apenas o App ID. As sessões vêm do seu servidor e funcionam uma única vez.

  • 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 React Native 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 uma vez quando o seu app iniciar.

  • UNSUPPORTED on a phone

    A parte nativa não está no build, por exemplo no Expo Go ou antes de um novo build.

    SoluçãoGere o build do app novamente ou use um development build do Expo. Um reload do Metro não adiciona código nativo.

  • Gradle cannot find com.moonetix

    O seu settings.gradle não permite que os projetos adicionem repositórios.

    SoluçãoAdicione o repositório Maven da Moonetix ao settings.gradle.

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

Perguntas sobre React Native

O que os desenvolvedores perguntam antes de adicionar o React Native SDK.

Travou em alguma coisa? Fale conosco

Quais versões do React Native e do Expo são suportadas?

React Native 0.77 ou mais recente, ou Expo SDK 53 ou mais recente. O pacote funciona com a New Architecture e, no React Native 0.77 a 0.81, também com a arquitetura antiga.

Funciona no Expo Go?

Não. O Expo Go não carrega código nativo, então Moonetix.isSupported é false nele. Adicione o config plugin e teste com um development build ou um EAS Build.

O pacote está no registro público do npm?

Ele está no registro npm da Moonetix. Adicione @moonetix:registry=https://moonetix.com/npm/ ao seu .npmrc, ou a entrada npmScopes no Yarn 2 e mais recentes, e depois instale normalmente.

Os tipos de TypeScript estão incluídos?

Sim. Os tipos para init, open, eventos e códigos de erro vêm junto com o pacote.

Como recompenso os usuários?

O seu servidor recebe um postback assinado a cada recompensa e credita o usuário uma única vez por ID de transação. Os eventos do app podem ser falsificados no dispositivo, então use-os apenas para atualizar a sua UI.

Onde fica a minha API key?

Apenas no seu servidor. O seu app guarda o App ID, e o seu servidor cria um token de sessão de uso único para o usuário logado.

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