Visão Geral da Integração
O Insert Affiliate rastreia indicações e compras de afiliados por meio de um processo de integração em três passos. Este guia explica cada passo e ajuda você a escolher as plataformas certas para suas necessidades.
Como o Insert Affiliate Funciona
O fluxo de rastreamento de afiliados funciona assim:
- O usuário clica no link do afiliado
- O deep linking abre seu aplicativo e identifica o afiliado
- A atribuição é armazenada quando o aplicativo é iniciado
- O usuário realiza uma compra
- A compra é verificada e rastreada
- A comissão é calculada para o afiliado
Para que isso funcione, você precisa integrar:
- Plataforma de Deep Linking - Rastreia qual afiliado indicou cada usuário
- Verificação de Compras - Valida compras e assinaturas no aplicativo
- Transações na Web (Opcional) - Rastreia compras baseadas na web, se aplicável
Passo 1: Plataforma de Deep Linking
O Que Ela Faz
O deep linking permite que links de afiliados abram seu aplicativo e rastreiem qual afiliado indicou o usuário. Quando um usuário clica no link de um afiliado, a plataforma de deep linking:
- Abre seu aplicativo (ou a App Store, se não estiver instalado)
- Passa o identificador do afiliado para seu aplicativo
- Permite que o Insert Affiliate atribua o usuário àquele afiliado
Escolha Sua Plataforma
Oferecemos suporte a várias plataformas de deep linking. Escolha com base nas suas necessidades:
| Plataforma | Ideal Para | Complexidade | Custo |
|---|---|---|---|
| Insert Links | Configuração rápida, sem necessidade de terceiros | Baixa | Incluído |
| Branch.io | Análises avançadas, usuários existentes do Branch | Média | Pago |
| AppsFlyer | Atribuição mobile, usuários existentes do AppsFlyer | Média | Camada gratuita disponível |
| RevenueCat Web Purchase Links | Assinaturas baseadas na web via RevenueCat | Média/Alta | Incluído com o RevenueCat |
| Outras Plataformas | Configuração de deep linking personalizada ou existente | Varia | Varia |
Recomendado: Insert Links
Para a maioria dos usuários, recomendamos começar com Insert Links:
- Integrado ao Insert Affiliate (sem necessidade de cadastro em terceiros)
- Mais fácil de configurar e testar
- Controle total sobre o comportamento dos links
- Sem custos adicionais
Passos de Integração
Depois de escolher uma plataforma:
- Configure a plataforma - Crie uma conta e configure seu aplicativo
- Instale nosso SDK - Adicione o SDK do Insert Affiliate ao seu aplicativo
- Configure o tratamento de deep links - Siga a documentação da sua plataforma
- Passe os links para nosso SDK - Encaminhe os dados de deep link para o Insert Affiliate
- Teste a integração - Verifique se a atribuição funciona corretamente
Instruções detalhadas para cada plataforma estão em seus respectivos guias.
Passo 2: Verificação de Compras
O Que Ela Faz
A verificação de compras valida que as compras no aplicativo são legítimas e notifica o Insert Affiliate quando um usuário atribuído realiza uma compra.
Escolha Sua Plataforma
| Plataforma | Ideal Para | Complexidade | Recursos |
|---|---|---|---|
| RevenueCat | Maioria dos usuários, apps de assinatura | Baixa | Configuração mais fácil, webhooks, multiplataforma |
| Adapty | Testes A/B de paywall, análises | Baixa | Paywalls sem código, webhooks, multiplataforma |
| Apphud | Usuários existentes do Apphud | Baixa | Semelhante ao RevenueCat |
| Iaptic | Usuários existentes do Iaptic | Baixa | Serviço de validação de recibos |
| Direct App Store | Apps iOS, controle máximo | Alta | Sem terceiros, apenas Apple |
| Direct Google Play | Apps Android, controle máximo | Alta | Sem terceiros, apenas Google |
Observação: Você pode combinar Direct App Store + Direct Google Play para aplicativos multiplataforma sem serviços de terceiros.
Recomendado: RevenueCat
Para a maioria dos usuários, recomendamos o RevenueCat:
- Integração mais simples com o Insert Affiliate
- Lida tanto com iOS quanto com Android
- Notificações automáticas por webhook
- Excelente documentação e suporte
- Camada gratuita disponível
Passos de Integração
O fluxo geral para todas as plataformas:
- Configure a plataforma escolhida - Crie a conta e configure os produtos
- Configure as opções do Insert Affiliate - Selecione seu método de verificação no painel
- Configure webhooks (RevenueCat, Apphud, Iaptic) - Conecte sua plataforma ao Insert Affiliate
- Passe o identificador do afiliado - Garanta que o código curto do afiliado seja incluído nas compras
- Teste compras - Verifique se as transações aparecem no painel do Insert Affiliate
Crítico: Passando o Identificador do Afiliado
A parte mais importante da verificação de compras é passar o identificador do afiliado quando ocorre uma compra. Cada plataforma tem um método diferente:
- RevenueCat: Defina um atributo personalizado (
insert_affiliate) - Adapty: Defina um atributo personalizado via
updateProfile - Apphud: Defina uma propriedade personalizada
- Iaptic: Inclua na solicitação de validação de compra
- Integrações diretas: Inclua nas notificações servidor a servidor
Consulte a documentação da plataforma escolhida para detalhes específicos de implementação.
Passo 3: Transações na Web (Opcional)
O Que Ela Faz
Se você vende assinaturas ou produtos pela web (não por meio das lojas de aplicativos), pode rastrear essas transações por meio do Insert Affiliate.
Escolha Sua Plataforma
| Plataforma | Ideal Para | Integração |
|---|---|---|
| Stripe Web Transactions | Integração direta com o Stripe | Stripe Connect |
| RevenueCat Stripe Billing | Uso de RevenueCat + Stripe | Stripe Connect |
| RevenueCat Web Billing | Compras na web via RevenueCat | Stripe Connect |
Quando Você Precisa Disso
Você precisa de rastreamento de transações na web se:
- Os usuários podem comprar assinaturas no seu site
- Você oferece checkout baseado na web junto com o mobile
- Você usa Stripe ou processadores de pagamento similares para vendas na web
Pule Isto Se
Você pode pular este passo se:
- Todas as compras acontecem por meio da App Store ou Google Play
- Você tem apenas um aplicativo mobile, sem presença na web
Lista de Verificação Completa da Integração
Use esta lista de verificação para garantir que você concluiu todos os passos necessários:
Configuração
- Cadastrado no Insert Affiliate e acessou o painel
- Localizou sua chave de API nas configurações do painel
Passo 1: Deep Linking
- Escolheu uma plataforma de deep linking
- Criou uma conta na plataforma escolhida (se necessário)
- Instalou o SDK do Insert Affiliate no seu aplicativo
- Configurou o tratamento de deep links no seu aplicativo
- Testou se os deep links abrem seu aplicativo corretamente
Passo 2: Verificação de Compras
- Escolheu uma plataforma de verificação de compras
- Configurou a conta da sua plataforma de verificação
- Configurou o método de verificação no painel do Insert Affiliate
- Configurou webhooks (se estiver usando RevenueCat, Apphud ou Iaptic)
- Implementou a passagem do identificador do afiliado no seu aplicativo
- Testou se as compras em sandbox aparecem no seu painel
Passo 3: Transações na Web (Opcional)
- Determinou se você precisa de rastreamento de transações na web
- Configurou a integração de transações na web (se necessário)
- Testou se as compras na web aparecem no seu painel
Testes e Lançamento
- Criou um afiliado de teste
- Testou a atribuição com códigos curtos
- Testou a atribuição com deep links
- Testou se as compras em sandbox aparecem corretamente
- Verificou se os cálculos de comissão estão corretos
- Revisou o guia Testes e Modo Sandbox
- Leu o guia de Solução de Problemas para problemas comuns
Matriz de Compatibilidade de Plataformas
Não tem certeza de quais plataformas funcionam juntas? Aqui está uma referência rápida:
Deep Linking + Verificação de Compras
Todas as plataformas de deep linking funcionam com todas as plataformas de verificação de compras. Escolha o que funciona melhor para suas necessidades.
Combinações Populares:
- Insert Links + RevenueCat (Mais fácil, recomendado para a maioria)
- Branch.io + RevenueCat (Bom para usuários existentes do Branch)
- AppsFlyer + RevenueCat (Bom para usuários existentes do AppsFlyer)
- Insert Links + Direct App Store (Controle máximo, iOS)
- Insert Links + Direct Google Play (Controle máximo, Android)
Adicionando Transações na Web
As plataformas de transações na web funcionam independentemente da sua configuração mobile:
- Você pode usar Stripe Web Transactions com qualquer integração mobile
- O RevenueCat Stripe Billing funciona melhor se você já estiver usando o RevenueCat para mobile
Precisa de Ajuda para Escolher?
Ainda não tem certeza de quais plataformas usar? Aqui estão algumas perguntas para guiar você:
"Quero a configuração mais simples possível"
→ Use Insert Links + RevenueCat
"Já uso o Branch.io para atribuição"
→ Mantenha o Branch.io + adicione o RevenueCat para verificação
"Já uso o RevenueCat"
→ Adicione o Insert Links para deep linking (ou mantenha sua plataforma existente)
"Quero controle máximo, sem terceiros"
→ Use Insert Links + Direct App Store ou Direct Google Play
"Também vendo assinaturas no meu site"
→ Siga os passos 1 e 2, depois adicione Stripe Web Transactions ou RevenueCat Web Billing
Próximos Passos
Pronto para começar a integração? Siga estes passos:
- Início Rápido - Coloque seu primeiro afiliado em funcionamento em 5 minutos
- Escolha e configure sua plataforma de deep linking
- Escolha e configure sua plataforma de verificação de compras
- Configure transações na web (se necessário)
- Teste minuciosamente no modo sandbox
- Crie seus primeiros afiliados reais e comece a rastrear vendas
Suporte
Precisa de ajuda com sua integração?
- Consulte o guia de Solução de Problemas para problemas comuns
- Revise a documentação específica de cada plataforma vinculada acima
- Entre em contato com o suporte por meio do seu painel