Início Rápido (5 Minutos)
Integre a Insert Affiliate e teste sua primeira indicação de afiliado em apenas 5 minutos. Este guia foca no caminho mais rápido para a validação.
Pré-requisitos
Antes de começar, certifique-se de ter:
- Se registrado na Insert Affiliate e ter acesso ao painel
- Acesso ao código-fonte do seu app
- Um dispositivo de teste ou simulador
Passo 1: Escolha Seu Caminho de Integração (1 minuto)
Você precisa de duas integrações para rastrear compras de afiliados:
- Plataforma de Deep Linking - Rastreia qual afiliado indicou o usuário
- Verificação de Compra - Verifica as compras no aplicativo
Caminho Recomendado de Início Rápido
Para a configuração mais rápida, recomendamos:
- Deep Linking: Insert Links (nossa solução integrada, sem necessidade de terceiros)
- Verificação de Compra: RevenueCat (verificação de compra mais fácil)
Alternativa: Se você já usa Branch.io, AppsFlyer ou outra plataforma, pode usá-las em vez disso. Consulte a Visão Geral da Integração para todas as opções.
Passo 2: Instale o SDK (2 minutos)
Escolha sua plataforma e siga as instruções de instalação:
iOS
Acesse nosso repositório do Swift SDK no GitHub e siga as instruções de instalação.
Android
Acesse nosso repositório do Android SDK no GitHub e siga as instruções de instalação.
React Native
Acesse nosso repositório do React Native SDK no GitHub e siga as instruções de instalação.
Flutter
Acesse nosso repositório do Flutter SDK no GitHub e siga as instruções de instalação.
Unity
Acesse nosso repositório do Unity SDK no GitHub e siga as instruções de instalação.
JavaScript / Capacitor
Acesse nosso repositório do JavaScript SDK no GitHub e siga as instruções de instalação.
Etapas principais que você vai completar:
- Adicione o SDK ao seu projeto
- Inicialize o SDK com sua chave de API (encontrada nas configurações do painel)
- Configure a integração de deep linking
- Configure a integração de verificação de compra
Passo 3: Crie Seu Primeiro Afiliado de Teste (1 minuto)
- Vá até a página Create Affiliate
- Selecione "Create Affiliate (Admin)"
- Insira um e-mail de teste (você pode usar um alias de e-mail como
yourname+testaffiliate@example.com) - Crie um deep link:
- Se estiver usando Insert Links: Siga o guia do Insert Links para criar um link
- Se estiver usando Branch.io: Siga o guia do Branch para criar um link rápido
- Se estiver usando AppsFlyer: Siga o guia do AppsFlyer para criar um OneLink
- Cole o deep link no campo Affiliate Deep Link
- Clique em Create Affiliate
Você verá seu afiliado no painel com o short code único dele.
Passo 4: Teste a Integração (1 minuto)
Agora teste se tudo funciona:
Opção A: Teste com Short Code (Recomendado para Validação Rápida)
A maneira mais rápida de testar é usar o short code do afiliado:
- Compile e execute seu app em um dispositivo de teste ou simulador
- Implemente uma forma de inserir manualmente o short code (consulte a documentação de Short Codes)
- Insira o short code do seu afiliado de teste
- Faça uma compra de teste (use o modo sandbox/teste)
- Verifique seu painel da Insert Affiliate - você deverá ver a transação aparecer
Opção B: Teste com Deep Link
- Clique no deep link do afiliado no seu dispositivo de teste
- Seu app deverá abrir (ou ser instalado, se estiver usando TestFlight/teste interno)
- Faça uma compra de teste (use o modo sandbox/teste)
- Verifique seu painel da Insert Affiliate - você deverá ver a transação aparecer
Resolução de Problemas
Se sua transação de teste não aparecer:
- Ative o registro detalhado (verbose logging) no SDK (consulte a documentação do SDK da sua plataforma)
- Verifique se o short code está armazenado - Registre o short code depois de defini-lo
- Verifique a configuração da verificação de compra - Certifique-se de estar passando o identificador do afiliado corretamente
- Leia nosso guia detalhado de resolução de problemas - Consulte Resolução de Problemas para depuração passo a passo
Próximos Passos
Agora que sua integração está funcionando:
- Configure os testes em sandbox - Leia Testes e Modo Sandbox
- Configure as taxas de comissão - Consulte Definindo Taxas de Comissão
- Ative o autocadastro de afiliados - Permita que os afiliados se cadastrem sem sua intervenção manual: Autocadastro de Afiliados
- Conheça os recursos avançados - Explore Recursos e Ferramentas
Precisa de Ajuda?
- Revise a Visão Geral da Integração completa para explicações detalhadas
- Consulte Problemas Comuns e Soluções para ajuda com depuração
- Entre em contato com o suporte pelo seu painel
