SDK de offerwall para Unity. Os jogadores ganham a moeda do seu jogo.

Deixe os jogadores ganharem a moeda do seu jogo concluindo ofertas, sem banners no seu jogo. Um único pacote Unity cobre Android e iOS, e cada recompensa chega ao servidor do seu jogo como um postback assinado.

  • 2022.3+Unity LTS ou Unity 6
  • 2.0.1Versão atual
  • 2Plataformas, um pacote
Unity SDKVersão 2.0.1
EarnButton.cs
using MoonetixOfferwall;
 
void Awake()
{
    Moonetix.Init("YOUR_APP_ID");
}
 
public void ShowOfferwall(string token)
{
    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 scoped registry da Moonetix e o pacote ao Packages/manifest.json, ou adicione o registro em Project Settings e instale o Moonetix Offerwall pelo Package Manager. Os SDKs de Android e iOS vêm junto.

    Packages/manifest.json
    {
      "scopedRegistries": [
        {
          "name": "Moonetix",
          "url": "https://moonetix.com/upm",
          "scopes": ["com.moonetix"]
        }
      ],
      "dependencies": {
        "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 Open com um token novo. Todos os eventos chegam na main thread do Unity, então você pode atualizar a sua UI diretamente. O pacote também inclui um exemplo de demo do Offerwall.

    EarnButton.cs
    using MoonetixOfferwall;
    using UnityEngine;
     
    public class EarnButton : MonoBehaviour
    {
        void Awake() => Moonetix.Init("YOUR_APP_ID");
     
        void OnEnable()
        {
            Moonetix.OnClosed += RefreshBalance;
            Moonetix.OnError += HandleError;
        }
     
        void OnDisable()
        {
            Moonetix.OnClosed -= RefreshBalance;
            Moonetix.OnError -= HandleError;
        }
     
        public void ShowOfferwall(string token) => Moonetix.Open(token);
     
        void HandleError(MoonetixError error)
        {
            Debug.LogWarning(error.CodeName + ": " + error.Message);
        }
     
        void RefreshBalance() { }
    }
  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 gemas12,450 gemas
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 gemas
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ê

  • Builds para Android e iOS

    No Android, ele adiciona o repositório Maven, o SDK e a regra de R8 ao seu projeto Gradle. No iOS, ele vincula e incorpora o iOS SDK no Xcode.

  • As ofertas abrem no lugar certo

    As ofertas que levam ao Google Play ou à App Store abrem no app da loja, para que as instalações sejam rastreadas corretamente.

  • Nenhuma chave dentro do seu jogo

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

  • Eventos na main thread

    OnOpened, OnClosed e OnError são disparados na main thread do Unity, prontos para a sua UI.

  • A moeda do seu jogo

    As recompensas são exibidas e creditadas na sua própria moeda, com a sua taxa de câmbio e a divisão com o usuário.

  • Sem ID de publicidade

    O SDK não usa o identificador de publicidade e não rastreia jogadores 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 Unity SDK, a causa e a solução.

  • InvalidAppId

    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.

  • InvalidToken

    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.

  • TokenExpiredOrUsed

    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.

  • NotInitialized

    open foi chamado antes de init.

    SoluçãoChame Moonetix.Init no Awake da sua primeira cena.

  • Unsupported

    O jogo roda no Unity Editor, no desktop ou em WebGL.

    SoluçãoGere o build para Android ou iOS e verifique Moonetix.IsSupported antes de mostrar o botão.

  • iOS build stops on the iOS version

    O Target minimum iOS Version em Player Settings está abaixo de 13.0.

    SoluçãoDefina como 13.0 ou superior.

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

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

Travou em alguma coisa? Fale conosco

Quais versões do Unity são suportadas?

Unity 2022.3 LTS, ou Unity 6 (6000.0) ou mais recente. No iOS, defina a versão mínima do iOS como 13.0 ou superior em Player Settings.

Funciona em builds para Android e iOS?

Sim. Um único pacote cobre os dois. O Unity adiciona sozinho o Android SDK ao projeto Gradle e o iOS SDK ao projeto Xcode, incluindo projetos exportados e templates personalizados do Gradle.

Como instalo o pacote Moonetix Unity?

Adicione o scoped registry da Moonetix e com.moonetix.offerwall ao Packages/manifest.json, ou instale-o em My Registries no Package Manager. Você também pode instalá-lo a partir de um tarball.

Um offerwall é pay-to-win?

Não. Os jogadores ganham a mesma moeda que ganhariam jogando, testando apps e jogos de anunciantes. Isso dá aos jogadores que não pagam uma forma de progredir sem banners no seu jogo.

Como credito os jogadores com segurança?

Credite as recompensas no servidor do seu jogo a partir do postback assinado, nunca a partir de eventos do cliente, porque os jogadores podem falsificá-los. Quando OnClosed for disparado, carregue o saldo do jogador do seu servidor.

Posso testar no Unity Editor?

Você pode testar o seu fluxo. No Editor, no desktop e em WebGL, Open verifica o App ID e o token e depois informa Unsupported, e Moonetix.IsSupported é false. Para ver o offerwall em si, gere o build para Android ou iOS e teste em um celular ou no iOS Simulator.

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