Testes e Modo Sandbox

Teste sua integração com o Insert Affiliate minuciosamente antes de entrar em produção. Este guia cobre testes em sandbox, criação de afiliados de teste e depuração da sua integração.

Ambientes de Teste Suportados

Você pode testar o Insert Affiliate completamente nos seguintes ambientes:

  • Builds locais - Execute seu app diretamente do seu ambiente de desenvolvimento
  • TestFlight (iOS) - Plataforma de testes beta da Apple
  • Google Play Internal Testing - Faixas de teste fechado ou interno
  • Google Play Closed Testing - Testes beta com público limitado

A atribuição e as compras funcionam em todos esses ambientes e aparecerão no seu painel do Insert Affiliate em tempo real.

Rótulos de Transações de Sandbox

Se você usar o RevenueCat para verificação de compras, as transações de sandbox são claramente rotuladas como tais no seu painel, facilitando a distinção entre compras de teste e reais.

Criando Afiliados de Teste

Você pode criar facilmente contas de afiliado de teste usando aliases de e-mail. Isso permite testar vários afiliados sem precisar de várias contas de e-mail.

Usando Aliases de E-mail

A maioria dos provedores de e-mail suporta a sintaxe de alias com +:

Exemplo: Se o seu e-mail for michael@insertaffiliate.com

Você pode criar afiliados de teste com:

  • michael+testaffiliate1@insertaffiliate.com
  • michael+testaffiliate2@insertaffiliate.com
  • michael+ios-test@insertaffiliate.com
  • michael+android-test@insertaffiliate.com

Todos os e-mails serão entregues na sua caixa de entrada principal (michael@insertaffiliate.com), mas o Insert Affiliate trata cada um como uma conta de afiliado separada.

Criando um Afiliado de Teste

  1. Acesse Create Affiliate
  2. Selecione "Create Affiliate (Admin)"
  3. Insira seu e-mail de teste (por exemplo, yourname+test@example.com)
  4. Crie e cole um deep link de afiliado
  5. Clique em Create Affiliate

Anote o short code do afiliado - você o usará para os testes.

Métodos de Teste

Existem duas formas principais de testar sua integração:

Método 1: Teste com Short Code (Recomendado)

Testar com short codes é a forma mais rápida e confiável de verificar sua integração.

Por que usar Short Codes?

O teste com short code isola o Insert Affiliate da sua plataforma de deep linking, permitindo que você:

  • Verifique a integração com o Insert Affiliate de forma independente
  • Teste sem lidar com a complexidade do deep linking
  • Itere rapidamente durante o desenvolvimento
  • Identifique se os problemas estão no Insert Affiliate ou no deep linking

Como Testar com Short Codes

  1. Adicione um campo de short code ao seu app - Implemente uma forma de inserir short codes manualmente (veja Short Codes para detalhes de implementação)
  2. Habilite o log detalhado - Ative o logging do SDK para ver o que está acontecendo
  3. Execute seu app - Inicie em um dispositivo de teste ou simulador
  4. Insira o short code - Digite o short code do seu afiliado de teste
  5. Verifique a atribuição - Confira os logs para confirmar que o short code foi armazenado
  6. Faça uma compra de teste - Conclua uma transação de sandbox
  7. Verifique seu painel - Confirme que a transação aparece no Insert Affiliate

Interpretando os Resultados

✅ Se a atribuição funciona com short codes mas NÃO com deep links:

  • O problema está na integração da sua plataforma de deep linking
  • O Insert Affiliate está funcionando corretamente
  • Concentre a depuração no tratamento dos deep links

❌ Se a atribuição não funciona com short codes:

  • O problema está na sua configuração do Insert Affiliate ou da verificação de compras
  • Siga o guia de Solução de Problemas

Assim que o teste com short code funcionar, teste o fluxo completo com deep links.

Testando Deep Links (App Já Instalado)

  1. Compile e instale seu app em um dispositivo de teste
  2. Clique no deep link de um afiliado (envie por e-mail, mensagem ou QR code)
  3. O app deve abrir com o identificador do afiliado
  4. Verifique a atribuição - Confira os logs para confirmar que o short code foi armazenado
  5. Faça uma compra de teste - Conclua uma transação de sandbox
  6. Verifique seu painel - Confirme que a transação aparece

Testando Deep Links (App Não Instalado - "Cold Start")

Isso testa a experiência completa do usuário quando alguém clica em um link de afiliado sem ter o seu app instalado.

Método Padrão:

  1. Desinstale seu app do dispositivo de teste
  2. Clique no link do afiliado - Deve levá-lo à App Store/Play Store
  3. Instale o app pela loja
  4. Abra o app - A atribuição deve funcionar na primeira inicialização
  5. Faça uma compra de teste - Conclua uma transação de sandbox
  6. Verifique no painel - Confira se a transação aparece

Método Mais Rápido (Apenas Insert Links):

Se você estiver usando Insert Links, pode testar a atribuição de cold start sem passar pela loja de aplicativos:

  1. Desinstale seu app
  2. Toque no link do afiliado - Você será levado à página da App Store
  3. Não instale pela loja - Em vez disso, instale localmente pelo Xcode/Android Studio
  4. Inicie o app instalado localmente
  5. Se os Insert Links estiverem configurados corretamente, a atribuição funcionará exatamente como se tivesse sido instalada pela loja

Para outras plataformas de deep linking, consulte a documentação delas sobre os recursos de teste de cold start.

Compras em Sandbox

Teste de Sandbox no iOS

Requisitos:

  • Apple ID de sandbox (criado no App Store Connect)
  • Logado na conta de sandbox no dispositivo de teste
  • Produtos de teste configurados no App Store Connect

Passos:

  1. Crie uma conta de testador sandbox no App Store Connect
  2. Saia da sua conta normal da App Store no dispositivo
  3. Inicie seu app e tente fazer uma compra
  4. Quando solicitado, faça login com sua conta de sandbox
  5. Conclua a compra de teste (é gratuita)
  6. Verifique se a transação aparece no seu painel do Insert Affiliate

Observação: As compras de sandbox no iOS são claramente marcadas no seu painel se você usar o RevenueCat.

Teste de Sandbox no Android

Requisitos:

  • Conta de testador de licença adicionada no Google Play Console
  • Produtos de teste configurados
  • App enviado para a faixa de teste interno (não precisa ser revisado)

Passos:

  1. Adicione seu e-mail de teste como testador de licença no Google Play Console
  2. Instale seu app pela faixa de teste interno
  3. Faça uma compra de teste (use um cartão de crédito de teste ou ela será gratuita)
  4. Conclua a compra
  5. Verifique se a transação aparece no seu painel do Insert Affiliate

Depurando Sua Integração

Habilite o Log Detalhado

Todos os SDKs do Insert Affiliate suportam log detalhado. Habilite isso nos seus builds de desenvolvimento para ver:

  • Quando deep links são recebidos
  • Quando short codes são armazenados
  • Quando compras são enviadas ao Insert Affiliate
  • Quaisquer erros ou problemas

Consulte a documentação do SDK da sua plataforma sobre como habilitar o log detalhado.

Cenários Comuns de Depuração

Cenário 1: Short Codes Funcionam, Deep Links Não

Diagnóstico: Problema na integração da plataforma de deep linking

Passos de depuração:

  1. Registre no log a URL do deep link que seu app recebe na inicialização
  2. Verifique se ela corresponde ao formato que sua plataforma de deep linking espera
  3. Confira se você está passando o link para o SDK do Insert Affiliate
  4. Revise a documentação da sua plataforma de deep linking

Cenário 2: Atribuição Funciona, Compras Não Aparecem

Diagnóstico: Problema na integração de verificação de compras

Passos de depuração:

  1. Verifique a configuração do webhook (RevenueCat/Apphud/Iaptic)
  2. Confira se o identificador do afiliado está sendo passado para a plataforma de compras
  3. Para RevenueCat: Verifique se o atributo insert_affiliate aparece no painel do RevenueCat
  4. Revise o guia de Solução de Problemas

Cenário 3: Nada Funciona

Diagnóstico: Múltiplos problemas ou erros de configuração

Passos de depuração:

  1. Comece pelo guia de Início Rápido
  2. Verifique se a chave de API está correta na inicialização do SDK
  3. Confira se as configurações do painel do Insert Affiliate estão configuradas
  4. Habilite o log detalhado
  5. Teste primeiro com short codes
  6. Siga o guia completo de Solução de Problemas

Checklist de Testes

Use este checklist para garantir testes minuciosos antes do lançamento:

Teste Básico de Integração

  • A atribuição por short code funciona
  • Compras de sandbox aparecem no painel
  • Os valores das compras estão corretos
  • O log detalhado não mostra erros
  • Deep links abrem o app quando ele está instalado
  • Deep links atribuem corretamente quando o app está instalado
  • A atribuição funciona na primeira inicialização após a instalação
  • A atribuição de cold start funciona (link → loja → instalação → inicialização)

Teste Específico por Plataforma

  • Testado no iOS (se aplicável)
  • Testado no Android (se aplicável)

Boas Práticas

Durante o Desenvolvimento

  1. Sempre teste primeiro com short codes - Isola os problemas
  2. Use o log detalhado liberalmente - Ajuda a detectar problemas cedo
  3. Teste com frequência - Não espere até o fim para testar a integração
  4. Teste em dispositivos reais - Simuladores podem se comportar de forma diferente

Antes do Lançamento

  1. Complete o checklist de testes - Garanta que todos os cenários sejam cobertos
  2. Teste a atribuição de cold start - Experiência do usuário crítica
  3. Revise seu painel - Familiarize-se com os dados

Após o Lançamento

  1. Monitore as transações iniciais - Verifique se tudo funciona em produção
  2. Mantenha o log detalhado disponível - Use builds de depuração caso surjam problemas

Obtendo Ajuda

Se você encontrar problemas durante os testes:

  1. Consulte a Solução de Problemas - Guia de depuração passo a passo
  2. Revise a documentação da plataforma - Guias de deep linking e verificação de compras
  3. Entre em contato com o suporte - Envie um e-mail para michael@insertaffiliate.com ou acesse app.insertaffiliate.com/help

Próximos Passos

Assim que os testes estiverem concluídos: