OneLink: o que é, tecnologia de deep linking e atribuição de instalações

O que é OneLink?

OneLink é uma tecnologia de deep links inteligentes da AppsFlyer que permite passar parâmetros de atribuição através de um link e vincular as ações do usuário a uma fonte de anúncio específica. Ela resolve o problema principal do marketing mobile: conectar um clique em um anúncio a uma instalação de aplicativo.

Um deep link comum abre o aplicativo e pode passar parâmetros básicos, mas perde as informações da fonte de tráfego ao passar pela loja de aplicativos. O OneLink usa uma combinação de parâmetros de URL, ID do dispositivo e tecnologia de fingerprinting para restaurar a atribuição após a instalação. Isso permite que os profissionais de marketing vejam qual campanha, criativo e canal geraram uma conversão — registro, compra ou outro evento alvo.

O OneLink funciona em todas as plataformas: iOS (Universal Links), Android (App Links), navegadores web e até aplicativos desktop. Os links são gerados através do painel de controle da AppsFlyer ou programaticamente via API REST, permitindo definir parâmetros dinamicamente para cada campanha em tempo real.

Como funciona o OneLink?

O princípio de funcionamento do OneLink é baseado em três etapas sequenciais: clique no link, instalação do aplicativo e correspondência de eventos. Em cada etapa, o OneLink retém e transmite dados de atribuição usando uma combinação de métodos para determinar com precisão a fonte de tráfego.

Estrutura do link OneLink

Um link OneLink tem um formato especial que inclui o domínio da AppsFlyer, o ID do aplicativo e os parâmetros da campanha. O template padrão se parece com https://app.onelink.me/{app-id}?pid={source}&c={campaign}&af_dp={deeplink}. O parâmetro pid (media source) indica a fonte de tráfego, c é o nome da campanha, af_dp é o deep link dentro do aplicativo.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        AppsFlyerLib.getInstance()
            .start(this, "YOUR_DEV_KEY")
    }

    override fun onNewIntent(intent: Intent?) {
        super.onNewIntent(intent)
        AppsFlyerLib.getInstance()
            .onNewIntent(this, intent)
    }
}

O parâmetro af_dp especifica o deep link que o usuário seguirá se o aplicativo já estiver instalado. Para novos usuários, o mecanismo de deep linking diferido é ativado: após a instalação e primeira inicialização, o SDK determina os parâmetros salvos e direciona o usuário para a tela desejada. O parâmetro af_click_lookback define a janela de atribuição — o período durante o qual um clique é considerado como tendo levado a uma instalação.

Mecanismo de atribuição

Após clicar em um link OneLink, a AppsFlyer registra o clique e o associa a um ID de clique único. Quando o usuário instala e abre o aplicativo, o SDK da AppsFlyer envia uma solicitação ao servidor com o ID do dispositivo (IDFA no iOS, GAID no Android). O servidor corresponde o ID de clique à instalação e determina a fonte de tráfego.

Se uma correspondência exata de ID não for encontrada (por exemplo, o usuário desativou o ID de publicidade), o fingerprinting é usado — análise do endereço IP, modelo do dispositivo, versão do SO e timestamp. Segundo a AppsFlyer, o fingerprinting fornece precisão de atribuição de 92–95% no iOS e 95–97% no Android mesmo sem ID de publicidade. A combinação de métodos determinísticos (IDFA/GAID) e probabilísticos (fingerprinting) fornece a imagem mais completa das fontes de tráfego.

OneLink vs deep link comum

A principal diferença entre o OneLink e um deep link comum está na capacidade de preservar a atribuição ao longo de toda a jornada do usuário. Um deep link comum (por exemplo, myapp://screen) abre o aplicativo mas não pode determinar de onde o usuário veio se ele acabou de instalar o aplicativo da loja.

O OneLink usa seu próprio SDK para rastrear eventos dentro do aplicativo e vinculá-los automaticamente aos dados de atribuição. Isso permite criar relatórios em todo o funil, desde a impressão do anúncio até a compra, reembolso ou retenção do usuário no dia 7. Deep links comuns não oferecem essa capacidade — eles funcionam apenas como um mecanismo de navegação, sem uma camada de análise e atribuição de marketing.

Onde o OneLink é usado

O OneLink é usado em uma ampla variedade de cenários de marketing onde é necessário vincular com precisão as ações do usuário às fontes de anúncios. As principais áreas incluem aquisição de novos usuários, reengajamento de usuários existentes e medição da eficácia de cada canal.

Campanhas de anúncios de instalação

Ao executar anúncios de instalação (campanhas UA), os links OneLink são colocados em anúncios no Facebook Ads, Google Ads, TikTok, Snapchat e outras plataformas. O parâmetro pid identifica exclusivamente a plataforma, e o parâmetro adicional c (campaign) identifica a campanha específica. A AppsFlyer automaticamente corresponde cliques a instalações e mostra relatórios de CPI (custo por instalação), CR (taxa de conversão) e ROAS (retorno sobre gastos com anúncios) para cada fonte.

Retargeting e reengajamento

Para usuários que já têm o aplicativo instalado, o OneLink suporta campanhas de retargeting. Quando um usuário existente clica em um link, o OneLink abre o aplicativo e passa parâmetros promocionais como um desconto pessoal ou bônus. A AppsFlyer distingue novos usuários de usuários que retornam usando a flag is_retargeting e constrói relatórios separados para cada tipo de tráfego — importante para o cálculo correto do LTV (valor do tempo de vida).

Deep linking diferido para tráfego orgânico

O OneLink é usado não apenas em campanhas pagas, mas também para tráfego orgânico: links em newsletters por email, SMS, códigos QR e redes sociais. Se o usuário não instalou o aplicativo, o OneLink o direciona para a App Store ou Google Play, e após a instalação — para a tela de destino: página de produto, artigo, perfil ou oferta promocional. O deep linking diferido é crítico para a conversão, pois elimina o atrito entre o desejo do usuário de realizar uma ação e a necessidade de encontrar manualmente a seção correta.

Programas de parceiros e marketing de influenciadores

O OneLink suporta a geração de links únicos para cada parceiro ou influenciador. O parâmetro af_sub1 pode conter o ID do parceiro, af_sub2 — o nome da postagem ou vídeo. Isso permite que os profissionais de marketing vejam qual conteúdo gera mais instalações e conversões e otimizem o orçamento com base em dados, não em suposições.

Configuração do OneLink em um projeto

Para que o OneLink funcione corretamente, o SDK da AppsFlyer deve ser integrado ao aplicativo móvel. O processo inclui instalar o SDK, configurar o domínio OneLink e lidar com deep links recebidos através dos mecanismos do sistema da plataforma — Universal Links no iOS e App Links no Android.

Integração do SDK da AppsFlyer

O SDK é instalado através dos gerenciadores de dependência padrão. No Android, a dependência é adicionada no Gradle; no iOS, via CocoaPods ou Swift Package Manager. Após a instalação, o SDK é inicializado com uma chave de desenvolvedor obtida no painel de controle da AppsFlyer e começa automaticamente a rastrear instalações e eventos.

https://app.onelink.me/A1b2C3d4?pid=facebook&c=summer_campaign&af_dp=myapp://promo/summer2026&af_click_lookback=7d

No exemplo acima, o SDK é inicializado no método onCreate da Activity principal usando a chave de desenvolvedor. O método onNewIntent é obrigatório para lidar com deep links se o aplicativo já estiver em execução. Sem esta chamada, a atribuição para aberturas repetidas de links OneLink não será registrada, distorcendo as estatísticas das campanhas de retargeting.

Configuração de Universal Links (iOS)

Para iOS, é necessário configurar Universal Links: adicionar entitlements com o domínio OneLink (app.onelink.me) e colocar o arquivo apple-app-site-association no servidor. A AppsFlyer gera automaticamente este arquivo ao configurar o OneLink no painel; o desenvolvedor só precisa adicionar o entitlement e lidar com os links recebidos no AppDelegate.

import AppsFlyerLib

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        continue userActivity: NSUserActivity,
        restorationHandler: Any?
    ) -> Bool {
        AppsFlyerLib.shared()
            .continue(userActivity, restorationHandler: nil)
        return true
    }
}

O método continue userActivity é chamado pelo sistema ao seguir um Universal Link. Dentro dele, AppsFlyerLib.shared().continue é chamado, que extrai os parâmetros de atribuição do link e os envia ao servidor. Uma abordagem similar é usada no Android com Intent Filter e auto-verify para App Links.

Após a integração ser concluída, os links OneLink podem ser gerados através do painel de controle da AppsFlyer ou API para cada campanha de anúncio. É importante testar os links em todas as plataformas: em um aplicativo recém-instalado (diferido), em um já instalado (direto) e em uma página web se o aplicativo não estiver instalado. O teste é feito através da ferramenta Test Link da AppsFlyer, que simula o comportamento em todas as plataformas sem necessidade de publicar nas lojas.

Ao trabalhar com OneLink, é importante considerar as limitações das plataformas: no iOS, após a introdução do App Tracking Transparency (ATT), o acesso ao IDFA requer consentimento explícito do usuário, o que reduz a precisão da atribuição determinística. O Google também restringe o uso do GAID no Android 14+ e superior, exigindo confirmação do usuário. Nessas condições, o fingerprinting se torna o principal método de atribuição e sua precisão depende diretamente da qualidade dos dados — quanto mais sinais o SDK coleta, maior a probabilidade de corresponder corretamente um clique a uma instalação.