Deep Linking para Atribuição de Afiliados no React Native
O deep linking é a base do rastreamento de afiliados em dispositivos móveis — ele conecta o toque no link de afiliado ao seu app, carregando os dados de atribuição que identificam qual afiliado indicou o usuário. No React Native com React Navigation, configurar deep links exige tanto a configuração nativa da plataforma quanto a configuração de roteamento em JavaScript.
Configuração da Plataforma
iOS (Universal Links)
- Adicione a capacidade Associated Domains no Xcode (applinks:yourdomain.com)
- Hospede o arquivo apple-app-site-association no seu domínio
- Configure seu AppDelegate para lidar com as URLs recebidas
Android (App Links)
- Hospede o assetlinks.json no seu domínio
- Adicione intent filters com autoVerify="true" no AndroidManifest.xml
- Configure sua MainActivity para lidar com os intents recebidos
Ambas as plataformas exigem os arquivos de configuração nativos para verificar que seu app realmente lida com links do seu domínio.
Configuração de Deep Link no React Navigation
O React Navigation oferece suporte a deep linking por meio de sua configuração de linking. Defina padrões de URL que mapeiam para as telas do seu app:
Configure a prop linking no seu NavigationContainer com os prefixes (seu domínio de afiliado) e um objeto config que mapeia caminhos de URL para nomes de telas.
No entanto, para o rastreamento de afiliados, você não necessariamente precisa que o deep link navegue até uma tela específica. O objetivo principal é capturar o identificador do afiliado a partir dos parâmetros da URL.
Capturando Dados de Atribuição
O SDK React Native da Insert Affiliate lida com a captura de atribuição quando um deep link chega:
- O app recebe o universal link / app link
- Antes de o React Navigation processar a URL para roteamento, o SDK da Insert Affiliate extrai o identificador do afiliado
- O SDK armazena a atribuição localmente e a confirma com o servidor
- Em seguida, o React Navigation lida com qualquer roteamento de navegação normalmente
Inicialize o SDK da Insert Affiliate antes de configurar o React Navigation para garantir que a atribuição seja capturada antes de a URL ser consumida pelo roteador.
Lidando com o Ciclo de Vida do Linking
Os deep links chegam em dois cenários:
App em execução (warm start): O link chega por meio da API Linking do React Native. Escute eventos de URL e passe as URLs recebidas tanto para o SDK de afiliados quanto para o seu manipulador de navegação.
App não está em execução (cold start): A URL inicial que iniciou o app está disponível por meio do Linking.getInitialURL(). Verifique isso na inicialização do app e processe quaisquer parâmetros de afiliado.
Deferred Deep Links (Novas Instalações)
Quando um usuário toca em um link de afiliado mas não tem o app instalado:
- Ele é redirecionado para a loja de apps
- Ele instala e abre o app
- Nenhuma URL de deep link chega (a instalação veio da loja)
- O SDK da Insert Affiliate verifica atribuições pendentes do lado do servidor na primeira execução
- A atribuição é resolvida por meio de correspondência de dispositivo
Chame a verificação de atribuição diferida do SDK durante a sequência de carregamento inicial do seu app.
Testando Deep Links
Teste em dispositivos reais (não em simuladores, no caso de universal links):
- Use o app Notas do iOS ou o Safari para clicar em links de afiliado de teste
- No Android, teste a partir do Chrome e de apps de mensagens
- Teste os cenários de cold start e warm start
- Verifique se a atribuição aparece no painel da Insert Affiliate
Problemas Comuns
- Universal links não disparam: Garanta que o arquivo AASA esteja acessível e válido. Teste a partir do Safari, não de navegadores internos do app.
- Conflitos de navegação: Se várias bibliotecas lidam com URLs, garanta que o SDK de afiliados processe a URL primeiro.
- Limitações do fluxo gerenciado do Expo: Use development builds para o teste completo de deep links.
O SDK React Native da Insert Affiliate se integra ao ciclo de vida do React Navigation, garantindo que a atribuição seja capturada de forma confiável, independentemente de como o usuário chega ao seu app.