Introdução — Porque é que os Deeplinks são cruciais para campanhas de afiliados de apps
Deeplinks móveis são a espinha dorsal de qualquer campanha de afiliados para apps: determinam se um clique resulta numa atribuição fiável, numa experiência personalizada dentro da app e, finalmente, numa conversão passível de pagamento. Especialmente no caso de instalações de apps, o desafio é grande: os utilizadores clicam no browser ou em apps sociais, são encaminhados para a loja, instalam a app e só a abrem mais tarde. Os deferred‑deeplinks garantem que, no primeiro arranque, os parâmetros de tracking originais são preservados e a conversão é corretamente atribuída a um parceiro.
Como a Affilentra implementa Deeplinks e atribuição deferred — Visão geral
A Affilentra oferece uma plataforma self‑hosted com gestão de funções, que agrega geração de deeplinks, tracking, validação de conversões e faturação de comissões. Para comerciantes e operadores de rede isto significa: controlo total sobre produtos, condições e criativos; para os parceiros: links de tracking rastreáveis e histórico de pagamentos. A seguir descrevo um fluxo de implementação prático incluindo redirecionamentos click‑to‑app, preservação de parâmetros, fallbacks opcionais via SDK e reconciliação de encomendas após instalação da app.
Componentes principais
- Gerador de Deeplinks: Gera links personalizados com parâmetros de tracking e um click_id único.
- Serviço de Redirect: Responsável pelo click‑to‑app redirect, fallback para a store e definição do tracking.
- SDK opcional da App: Preserva no primeiro arranque o click_id / payload e envia isto para o servidor.
- Motor de Atribuição e Reconciliação: Liga a instalação da app e encomendas posteriores ao clique original e dispara o cálculo de comissões.
1. Geração de Deeplinks: Conteúdos e aspetos de segurança
Os deeplinks têm de transportar toda a informação relevante sem abrir portas à manipulação. Conjunto mínimo de parâmetros recomendado:
- aff_id (ID do parceiro/publisher)
- campaign (identificador da campanha)
- click_id (identificador único do clique)
- payload (parâmetros opcionais de destino para routing in‑app, codificados em Base64)
- sig (assinatura HMAC para verificação da integridade)
Procedimento: O gerador de deeplinks na Affilentra cria links como https://example.com/r?aff_id=...&click_id=... e acrescenta uma assinatura HMAC calculada no servidor. A assinatura evita manipulações posteriores dos parâmetros.
2. Click‑to‑App Redirects: Universal Links, Intent & fallback para a Store
Uma lógica de redirect adequada aumenta a probabilidade de conversão e preserva os parâmetros de tracking. A implementação consiste em três níveis:
- Universal Links / App Links: Sempre que possível, os utilizadores aterram diretamente na aplicação. O serviço de redirecionamento fornece, ao detetar o cabeçalho de dispositivo adequado, um 302 para o esquema da app/Universal‑Link.
- Intent URL (Android): Para navegadores Android, o redirecionamento devolve uma Intent‑URL que abre a app ou encaminha para a Play Store.
- Store‑Fallback: Se a abertura da app falhar, o utilizador é conduzido para a loja. Nesse processo a click_id permanece armazenada no lado do servidor e é utilizada para Deferred‑Matching.
Importante: O endpoint de redirecionamento grava, no clique, a click_id, o User‑Agent e o carimbo temporal numa base de dados de curta duração (p. ex. Redis). Esta tabela de mapeamento é a base para a atribuição deferred.
3. Preservação de parâmetros: Do clique ao primeiro arranque
Existem duas abordagens comprovadas para a preservação de parâmetros:
- Do lado do cliente via SDK: O SDK da Affilentra recebe, ao arrancar a app, a Deferred‑Payload (p. ex. através do Install‑Referrer ou de um mecanismo de pull do lado do servidor) e transmite a click_id e a payload para o servidor da Affilentra.
- Do lado do servidor via Postback/ID‑Matching: O serviço de redirecionamento armazena a click_id juntamente com identificadores do dispositivo (na medida em que seja compatível com a privacidade) e fornece uma interface de matching. No primeiro arranque da app, a app invoca um endpoint API, envia os identificadores do dispositivo e recebe os parâmetros correspondentes.
Recomendação: Combinação de ambos os caminhos. SDK para captura fiável do First‑Open; matching no servidor como fallback para browsers ou ambientes restritivos.
4. Fallbacks do SDK: Cenários de utilização e integração
A Affilentra disponibiliza um SDK opcional e de fácil integração que executa as seguintes tarefas:
- Captura do Install‑Referrer (Android) ou callbacks de Universal Link (iOS).
- Transmissão da click_id e da payload para o servidor Affilentra.
- Encaminhamento da Deferred‑Deeplink‑Payload para os componentes internos da app para deep‑routing.
Nota de integração: O SDK foi propositadamente mantido minimalista. Após a ligação inicial, a app deve, no primeiro arranque, verificar os parâmetros recebidos, inicializar a sessão e só depois disparar promoções in‑app ou fluxos de onboarding com atribuição de parceiros.
5. Reconciliamento de encomendas: Da instalação para uma conversão relevante para vendas
O objetivo do reconciliamento é transformar a atribuição garantida numa conversão passível de comissão. Fluxo:
- No primeiro arranque da app, a click_id é comunicada à Affilentra. O sistema marca a click_id como associada à instalação e liga‑a à sessão do dispositivo.
- Se mais tarde ocorrer uma encomenda in‑app, a app ou o backend do comerciante envia os dados da encomenda incluindo client_click_id para a Affilentra.
- A Affilentra verifica a correspondência (click_id presente, janela temporal, eventuais regras de anulação) e valida a encomenda (por ex., estado do pagamento). Se tudo estiver correto, a comissão para o aff_id é marcada para pagamento.
É essencial uma lógica clara de cancelamento e validação: encomendas em prazo de cancelamento ou com pagamentos falhados só devem ser incluídas nas listas de comissões após confirmação do processamento.
Exemplos práticos: Casos típicos de implementação
Caso A — Campanha social com muito tráfego direto
Distribuir deeplink através de Short‑URL para creators. O serviço de redirecionamento define a click_id e tenta o Universal Link. O SDK no bundle da app captura a click_id e o payload no primeiro arranque, encaminhando o utilizador para um onboarding especial. A encomenda é depois casada e a comissão acionada.
Caso B — Display Ads com muito tráfego para a loja
O clique no display vai para o serviço de redirecionamento, a click_id é guardada. O utilizador chega à store e instala mais tarde. O matching server‑side através do Install‑Referrer (Android) ou o SDK‑Pull (iOS) assegura a atribuição; a reconciliação de encomendas conclui a conversão.
Benefício concreto para comerciantes, operadores de rede e parceiros
- Comerciantes: Controlo total sobre tracking, condições e faturação numa plataforma self‑hosted; sem partilha de receitas com terceiros.
- Operadores de rede: Visão unificada sobre cliques, instalações e receitas; reconciliação automatizada reduz verificações manuais.
- Parceiros/Publishers: Links de tracking transparentes, histórico de pagamentos rastreável e feedback direto sobre payloads de deeplink para melhor otimização de conversão.
Checklist de implementação — Curta e orientada para ação
- Criar gerador de deeplinks: aff_id, click_id, payload, sig.
- Configurar serviço de redirecionamento: Universal Links, Intent, fallback para a store.
- Persistir o mapeamento de clique (TTL curto, armazenamento seguro).
- Integrar SDK como mecanismo primário de First‑Open; API server‑side como fallback.
- Definir regras de reconciliação (janela temporal, tratamento de cancelamentos/reembolsos).
- Configurar a lógica de comissões na Affilentra (edição PRO / NETWORK conforme necessidade como licença perpétua).
Conclusão e próximo passo
Deep links e Deferred‑Deeplinks não são uma caixa preta: com uma arquitetura clara composta por um gerador de deeplinks, redirecionamentos inteligentes, armazenamento seguro de parâmetros, um SDK opcional e uma pipeline de reconciliação bem delineada, é possível atribuir instalações de aplicações de forma fiável e convertê‑las em pagamentos de comissões. A Affilentra reúne estes componentes numa plataforma self‑hosted que oferece controlo aos comerciantes e transparência aos parceiros.
Aja agora: Se pretende implementar tracking, atribuição diferida e faturação para as suas campanhas de apps de forma organizada e centralizada, escolha o seu ponto de entrada.
Próximo passo
Experimentar a Affilentra
Plataforma unificada que integra disponibilização de produtos, tracking, validação de conversões, cálculo de comissões e pagamentos, com papéis claramente separados e transparência; opção de instalação self‑hosted com licença perpétua sem partilha de receitas; os comerciantes mantêm controlo sobre produtos, condições e criativos; os parceiros recebem links de tracking pessoais e um histórico de pagamentos auditável.