-
OneLink™, um link de atribuição exclusivo que permite que os anunciantes utilizem três recursos principais com um único clique:
- Detecção e redirecionamento de dispositivo: o OneLink detecta o tipo de dispositivo (Android, iOS, desktop, etc.) quando clicado e redireciona o usuário para um destino correspondente.
- Links diretos: quando o aplicativo móvel anunciado já está instalado, o OneLink oferece suporte à inicialização do aplicativo após o clique e/ou oferece ao usuário conteúdo personalizado, como o envio a uma atividade/página específica no aplicativo).
- Ligação direta adiada: quando o aplicativo móvel anunciado não está instalado, o OneLink pode fornecer ao usuário conteúdo personalizado, como enviar o usuário para uma atividade/página específica no aplicativo, na primeira inicialização do aplicativo após a instalação.
- Anunciantes geralmente implantam o OneLink com:
- Suas mídias próprias, como e-mails, campanhas de SMS, banners do site, páginas iniciais, posts virais nas mídias sociais e códigos QR em cartazes físicos.
- Personalize OneLinks com o seu domínio.
Implementando links personalizados
Este guia abrange a configuração básica do OneLink, que permite detecção e redirecionamento de dispositivo.
Assim que esta configuração estiver concluída, você pode continuar no Guia de vinculação profunda passo a passo.
Exemplo
A AwesomeCom lançou um novo aplicativo para Android e iOS. Jill, comerciante de celulares, decide lançar uma campanha por SMS usando o banco de dados de números de telefones celulares dos usuários da AwesomeCom. A mensagem curta contém uma chamada à ação e um URL único do OneLink.
Todos os usuários do Android que clicarem no link são redirecionados para a página de aplicativos no Google Play. Todos os usuários de iOS que clicarem no mesmo link são redirecionados para a página de aplicativos no iTunes.
A campanha consegue converter 23,5% dos usuários cadastrados da AwesomeCom em usuários de dispositivos móveis usando o OneLink!
Fluxo de Detecção e Redirecionamento de Dispositivo
Quando você usa um dispositivo engajado e clica no OneLink, acontece o seguinte:
- Você é redirecionado para os servidores do AppsFlyer
- Lá, você clica no URL e seus parâmetros são salvos para uso posterior, para fins de atribuição e vinculação profunda, caso você decida instalar o aplicativo
- Imediatamente depois, com base no agente usuário do dispositivo, o tipo de dispositivo é detectado
- Em seguida, você é redirecionado para o destino designado de acordo com o modelo do OneLink (veja abaixo) que serve para o tipo do seu dispostivo
São necessários dois estágios para que a configuração do OneLink alcance essas etapas:
Observação
O OneLink também é compatível com as seguintes plataformas:
- Android — Smart TVs baseadas em Android
- Apple — Apple TV (tvOS)
- Amazon Fire TV — para a Amazon Fire TV use a opção URL personalizado do APK Android
- Windows — todas as Plataformas Universais do Windows, incluindo Xbox
Configuração de modelo do OneLink
O modelo do OneLink é onde todos os diferentes destinos por tipos de dispositivo são definidos.
Assim que o template básico do OneLink estiver concluído, você pode criar muitos links personalizados com diferentes parâmetros que levam aos mesmos destinos descritos no modelo do OneLink (exceto se substituídos).
Cada aplicativo móvel em uma conta da AppsFlyer pode ser definido em vários modelos do OneLink. Para obter mais detalhes sobre como atribuir um aplicativo a mais de um modelo do OneLink, clique aqui.
Importante!
Embora seja possível definir um aplicativo móvel em vários modelos do OneLink, na maioria dos casos não há nenhuma necessidade de fazer isso. Geralmente, um aplicativo só deve ser configurado uma vez no modelo do OneLink.
Use essa configuração para criar muitos links de atribuição personalizados que possuam atributos diferentes, mas levem aos mesmos destinos.
Lista de templates do OneLink
A página da lista de templates do OneLink está no nível da conta, o que significa que é comum entre todos os aplicativos e contém todos os modelos do OneLink da conta.
- No painel de qualquer um dos seus aplicativos, na seção Engajamento & Links Diretos, clique em Templates do OneLink para abrir a página:
- Cada template do OneLink tem sua própria ID de OneLink exclusiva (desde que o subdomínio do OneLink esteja definido): http://myapp.onelink.me/onelinkid.
Cada OneLink também tem seu próprio nome personalizado. - Para um novo template do OneLink, clique
. - Para trabalhar em um template do OneLink já existente, clique no respectivo nome do template.
Observação
Se necessário, você pode deletar um template do OneLink. No entanto, os links de atribuição baseados em templates deletados perdem a capacidade de atribuir usuários e até mesmo de redirecioná-los às lojas de aplicativo.
Portanto, é recomendável não excluir os templates do OneLink que foram usados pelos links de atribuição. Ao invés disso, você pode editar os templates do OneLink para atender às suas necessidades.
Depois de selecionar um template do OneLink existente ou adicionar um novo, a página de templates do OneLink é aberta.
No modelo de página do OneLink
A partir dela você pode configurar os destinos para celulares iOS, Android e Windows. Além disso, existem alguns destinos mais avançados que você pode configurar. Seguem explicações de cada uma dessas opções.
Nome do Modelo do OneLink
Configure um nome apropriado para os aplicativos participantes do template. Se você não configurar o nome, o nome padrão "Untitled OneLink" é gerado para o template.
Você pode mudar o nome do OneLink a qualquer momento.
Subdomínio
Necessário para usuários mobile de links diretos, mas não para redirecionamento básico.
Subdomínio é obrigatório para links diretos de usuários dos links universais do iOS ou Links de Aplicativos do Android.
Esquema do URI
Necessário para usuários mobile de links diretos, mas não para redirecionamento básico.
- Obrigatório para links diretos de usuários Android 6.0 ou inferior e iOS 9.0 e inferior.
- Obrigatório para usuários do Android 6.0 e superior, se os links de aplicativos para Android não estiverem implementados.
- O esquema URI serve como valor padrão para URLs do OneLink usando este modelo, mas pode ser personalizado pela URL do OneLink.
Observação
- O valor do Subdomínionão pode incluir um '.':
- myapp - é válido
- my.app - não é válido
- O valor para o Esquema URI deve seguir um padrão específico: Esquema URI deve consistir em uma sequência de caracteres começando com uma letra e seguida por qualquer combinação de letras, dígitos, mais ("+"), ponto ("."), ou hífen ("-").
- my-app:// - é válido
- my_app:// - não é válido
Configuração para o iOS
- Seu aplicativo iOS - use o menu suspenso para selecionar o aplicativo iOS para o qual você deseja redirecionar o usuário na loja de aplicativos.
- URL da página inicial (opcional) - use apenas para redirecionar usuários do iOS para um destino diferente da loja de aplicativos (saiba mais sobre gravação de instalações móveis nas páginas de destino).
-
Links diretos com links universais- selecione SOMENTE para ativar opções de links diretos para iOS.
Os seguintes campos aparecem se o botão for ativado. - ID de equipe(também conhecida como prefixo de ID da Apple) - Chave identificadora de aplicativo nos direitos do seu aplicativo. Você pode encontrá-la no Portal do desenvolvedor da Apple.
-
Aplicativos adicionais iOS(opcional) - Se estiver usando um aplicativo de teste para desenvolver seu aplicativo iOS, você pode testá-lo usando o OneLink. Preencha os valores da sua ID de equipe e agrupamento de ID de aplicativo iOS, como definido no XCode.
Observação
Ambos os valores são encontrados em developers.apple.com na seção Identificadores >> IDs de aplicativos. Clique na ID do aplicativo registrada correspondente, como mostrado abaixo.
- Versão de aplicativo para iPad(opcional) - Se você tem uma versão separada do aplicativo para iPad, selecione-a no menu suspenso do iPad para redirecionar usuários do iPad para ela. Preencha os valores da ID de equipe e doagrupaento de ID do aplicativo iOS, como definido no XCode.
Configuração para Android
- Seu aplicativo Android - use o menu suspenso para selecionar o aplicativo Android para o qual você deseja redirecionar o usuário no Google Play.
- URL de página inicial(opcional) - use este link para seu aplicativo Android, se estiver fora do Google Play, os usuários de Android serão redirecionados para este link.
- Links diretos com Links de Aplicativo Android - Links de aplicativo Android é um método avançado para realizar links direto em dispositivos Android a partir da versão 6.0 de OS e superior. Selecione SOMENTE para ativar links diretos com Links de Aplicativo Android para Android.
- Quando definir Links de Aplicativo Android na nota do template do OneLink - veja a captura de tela acima.
- Adicione a fingerprint SHA256 - Clique no botão e adicione a fingerprint SHA256 obtida anteriormente (instruções sobre como obtê-la aqui).
- Verifique se o valor Subdomínio está definido.
- Copie o fragmento XML <intent-filter> abaixo Adicione a fingerprint SHA256 e salve-a em outro lugar. O desenvolvedor precisa do fragmento XML para a etapa 2 da configuração que cabe a ele.
- No arquivo AndroidManifest.xml do seu aplicativo, adicione o fragmento XML <intent-filter> a qualquer atividade para a qual você deseja fazer um link direto.
Configuração da web para desktop
Esse campo opcional permite redirecionar os usuários da área de trabalho para uma página da web específica.
- Se não especificado, usuários de desktop que clicam nas URLs do OneLink usando este modelo são redirecionados à página do aplicativo na loja de aplicativos do iOS.
- Se o template não contiver um aplicativo iOS, os usuários serão redirecionados para a página do aplicativo no Google Play.
Configuração do Amazon Kindle Fire
Para habilitar a atribuição para aplicativos Amazon Fire:
- Ative o botão Configuração do Amazon Kindle Fire.
- Configure a URL da loja da Amazon ou da página do aplicativo.
Aplicativo de Windows Phone
Para habilitar a atribuição para aplicativos Windows Phone:
- Ative o botão Configuração do Windows Phone.
- Selecione seu aplicativo do Windows Phone.
- URL da página inicial(opcional) - use somente para redirecionar usuários do Windows Phone para um destino diferente da loja de aplicativos do Windows Phone (saiba mais sobre gravação de instalações mobile nas páginas de destino).
Criar links personalizados usando o modelo do OneLink
Agora seu modelo do OneLink está pronto, você pode criar links de atribuição de parâmetros avançados usando esse modelo. Esses links de atribuição podem diferir em valores, como os nomes de fonte de mídia e campanha (por exemplo, e-mails, sites, banners, etc.), mas os redirecionamentos básicos do OneLink são comuns para todos os links (exceto se você substituí-los).
Você pode criar links de atribuição do OneLink manualmente, usando a janela de configuração dos links de atribuição personalizados. Para mais detalhes, clique aqui.
Alternativamente, se você quiser criar links de atribuição do OneLink automaticamente ou em lote, você pode fazer isso usando a API REST do OneLink.
Testar os Redirecionamentos do OneLink
Para testar seu modelo do OneLink recém configurado, siga estas instruções:
1. Crie um link de atribuição personalizado de "teste" para Multi-plataforma
2. Selecione o template do OneLink ao qual o link de atribuição é direcionado
3. Preencha o nome da fonte de mídia e da campanha. Você pode criar links diferentes para qualquer tipo de teste que você executar. Contudo, a AppsFlyer recomenda usar o nome de fonte de mídia de teste para todos eles.
Dica
Sempre prefira usar a fonte de mídia de teste ao testar qualquer coisa com a AppsFlyer para ver todos os resultados do teste sob a fonte de mídia de teste. Adicione o tipo de teste no parâmetro nome da campanha (&c={test type}, por exemplo, &c=redirections) para diferenciar entre tipos de testes diferentes com parâmetro de nome da campanha.
4. Gere o link de atribuição e use URLs curtos e longos para o teste
Exemplo:
https://go.onelink.me/{AUTO_GENERATED}?pid=test&c=redirections
5. Para cada versão de OS configurada na página de configuração do OneLink:
-
Envie o URL de teste – para o respectivo dispositivo da lista de permissões usando e-mail, código QR etc.
Observação
No iOS, use o iMessenger ou o e-mail para enviar o link para o dispositivo. Não cole o link no aplicativo iOS Notes e clique nele, pois pode quebrar o link.
- Clique no URL de teste – verifique se o dispositivo é redirecionado para o destino configurado (Google Play, iTunes, página da web etc.)
- Instale o aplicativo móvel – no dispositivo e inicie-o
- Verifique os resultados – na página de visão geral do painel, procure um novo clique e instale na fonte de mídia "teste" e nome de campanha que você colocou no URL (ou seja, redirecionamentos)
Aviso
Completar os testes acima com sucesso significa que o seu aplicativo está pronto para realizar Somente os redirecionamentos do OneLink. Para testes de vinculação profunda, clique aqui.
Substituir os Destinos de Modelos do OneLink
Embora os redirecionamentos configurados por modelo do OneLink sejam comuns para todos os links de atribuição que o utilizarem, você pode substituí-los por parâmetros personalizados. Colocar os seguintes parâmetros de destino no link de atribuição envia os usuários que clicarem para os valores definidos no link em vez dos valores configurados no modelo.
Parâmetros de destino
| Nome do parâmetro de destino | Descrição | Dica da AppsFlyer |
|---|---|---|
| af_ios_url | Redirecionar os usuários de iOS para uma URL diferente da página do aplicativo no iTunes | Use isso para redirecionamentos de páginas de destino ou como fallback caso o link direto falhe Observação - os usuários de desktops Mac, com Safari 13.0.0 e superior, são redirecionados de acordo com af_ios_url e não com af_web_dp. |
| af_android_url | Redirecionar usuários de Android para um URL diferente da página do aplicativo no Google Play | Use isso para redirecionamentos de páginas de destino ou como fallback caso o link direto falhe |
| af_r | Redirecione os usuários para a URL especificada em todos os sistemas operacionais e plataformas | Use isso para redirecionamentos de página inicial |
| af_web_dp | Redirecionar os usuários de desktop para uma página da web diferente da configurada no modelo do OneLink |
Use isto para manter dados de atribuição de usuários de desktop em outras plataformas (por exemplo Google Analytics ou Omniture)
Observação - os usuários de desktops Mac, com Safari 13.0.0 e superior, são redirecionados de acordo com af_ios_url e não com af_web_dp. |
| af_dp | O caminho para uma atividade interna no aplicativo à qual os usuários estão sendo direcionados. | Use isso para deep links e retargeting |
| af_ios_fallback | Fornecer o URL de fallback para usuários de iOS 10.3 e superior | Use isso para melhorar o fluxo interrompido para usuários de iOS 10.3 |
| af_param_forwarding | Quando configurado como falso, nenhum dos parâmetros que estão no OneLink passa para a página redirecionada | Use isso para obter um URL mais limpo na página redirecionada ou se os parâmetros do OneLink puderem causar problemas devido à manipulação de parâmetros na página de destino |
Aviso
Não use os seguintes caracteres como parte dos valores de parâmetro de destino (nem mesmo codificados por URL). Usá-los bloqueia o redirecionamento do OneLink ou ações de links diretos.
Os caracteres são: []<>;(){}'`"
Exemplo
Usuários de Android que clicarem no seguinte link de exemplo serão redirecionados para google.com em vez da página de aplicativos para Android pré-configurada no Google Play. Os usuários de iOS que clicarem são redirecionados para apple.com:
https://go.onelink.me/{AUTO_GENERATED}pid=test&c=redirections&
af_android_url=http%3A%2F%2Fwww.google.com&
af_ios_url=http%3A%2F%2Fwww.apple.com
OneLink e Aplicativos Sociais
Os anunciantes podem querer usar o OneLink com postagens "virais" em aplicativos sociais, pois os usuários potenciais que são expostos a essas postagens não podem ser direcionados antecipadamente de acordo com seus dispositivos.
Infelizmente, as limitações definidas principalmente pelos Links Universais da Apple, em conjunto com as restrições de alguns dos aplicativos sociais, impedem o uso do OneLink para vinculação profunda, ou às vezes até mesmo para reconhecimento de dispositivo básico, redirecionamento e atribuição.
A tabela a seguir resume o que você pode fazer com o OneLink nos aplicativos sociais populares de hoje:
| Aplicativo Social | Redirecionamento do Android | Vinculação Profunda do Android | Redirecionamento do iOS | Vinculação Profunda do iOS |
|---|---|---|---|---|
| S | Y* | S | Y* | |
| Facebook Messenger | S | Y* | S | Y* |
| Snapchat | S | Y* | S | Y* |
| S | S | S | N | |
| N | N | N | N | |
| Slack | S | Y* | S | Y* |
| S | Y* | S | Y* | |
| S (Consulte a seção Perguntas frequentes do WeChat) |
N | N | N | |
| S | S | S | S |
*Y - se o esquema URI for usado no lugar do aplicativo ou link universal, ou se você definir uma página inicial.
A solução alternativa de página inicial para aplicativos sociais
Para evitar as limitações no OneLink mencionadas e ainda ativar o redirecionamento de dispositivos nas postagens de aplicativos de redes sociais, recomendamos usar a página inicial do aplicativo social.
Como alternativa, você pode criar sua própria página inicial. O fluxo é o seguinte:
- Criar uma página de destino com um botão de "Download do aplicativo", com o OneLink por trás dele
- Publicar o link para a página de destino no aplicativo de rede social
- Um usuário clica no link da página de destino na publicação no aplicativo de rede social
- O usuário é redirecionado para uma página de destino
- A página de destino contém um botão de "Download do aplicativo", com o OneLink por trás dele O usuário clica no botão
- O fluxo regular do OneLink segue, incluindo a vinculação profunda e atribuição usando fingerprinting.
Observação
As taxas de conversão para páginas de destino podem ser um pouco mais baixas do que as fontes originais, devido ao fato de ser exigido o segundo clique dos usuários.
Para saber mais sobre como atribuir usuários móveis direcionados do Facebook para páginas de destino, clique aqui.
Para executar links diretos em publicações de redes sociais com o OneLink, acesse o guia de links diretos.
Usar o OneLink com Redes Integradas
O OneLink é usado principalmente com mídias próprias e não com redes de anúncios.
É raro que as redes de anúncios exijam o OneLink, pois geralmente anunciam nos aplicativos. Isso lhes permite conhecer a plataforma, ID de dispositivo etc. do usuário, de modo que seu aplicativo e os links de atribuição específicos da plataforma sejam suficientes.
No entanto, às vezes as redes de anúncios não conhecem a plataforma de seus usuários antecipadamente, por exemplo, quando elas mesmas realizam campanhas por e-mail ou SMS.
Importante!
No OneLink com redes integradas é necessário que você use a versão longa do OneLink.
Configuração do OneLink com Redes Integradas
- Vá para Parceiros integrados no painel do seu aplicativo Android e selecione a rede de anúncios relevante.
- Copie o link de atribuição do aplicativo na janela de configuração e salve-o em um documento externo.
- Para o seu aplicativo iOS, repita as etapas 1 e 2.
Agora, crie o link de atribuição:
- Certifique-se de que o OneLink foi configurado corretamente
-
Crie um URL do OneLink básico na janela Custom Attribution Link (Link de atribuição personalizado) e salve em um documento externo. Ao criar o URL do OneLink básico, use "teste" como nome do fonte de mídia:
- Depois de clicar em Generate Link (Gerar link), você verá a seguinte tela:
- Copie o link longo.
- No link longo, substitua a fonte de mídia "teste" pelo PID exato do parceiro integrado no link https://greatapp.onelink.me/U8ru?pid=network_int&c=MyCampaign
-
Adicione TODOS os parâmetros de AMBOS os links de atribuição
Se o link de atribuição do aplicativo iOS e Android forem idênticos, simplesmente copie os parâmetros de um dos links. Caso contrário, verifique se você possui todos os parâmetros de ambos os links.
Se todos os parâmetros da rede integrada forem adicionados corretamente, assim que o OneLink for clicado e redirecionado para a plataforma certa, os parâmetros necessários são enviados à rede dentro de um postback após a instalação do usuário.
Exemplo
https://greatapp.onelink.me/3287867539?pid=network_int&c=email&
idfa{$IDFA}&gaid={$GAID}&clickid=$SITEID&
af_sub1=[pixel_code]&af_sub2=[creative]
A rede usa os parâmetros IDFA ou GAID de acordo com a plataforma do dispositivo do cliente e desconsidera o outro parâmetro.
FAQ
Sim, usar target="_blank" na marcação HTML href não resulta em redirecionamento para o Google Play ou App Store. Se a URL do OneLink for colocada dentro de uma tag html a com o atributo target="_blank", ela abrirá uma página em branco no Chrome no Android e no iOS. Isso afeta a funcionalidade do OneLink. Certifique-se de que a tag a não inclui o atributo target.
Sim, são várias as limitações para o Instagram:
- Devido à maneira pela qual o Instagram transforma o texto de uma página em postagem, os links não se tornam clicáveis quando inseridos na legenda de uma postagem.
- As descrições de perfil do Instagram não suportam links clicáveis.
- É possível vincular links do site de perfil, contudo, ele direciona para a loja de aplicativos o tempo todo, pois não há suporte para os Links Universais no Instagram (somente iOS).
Para superar isso, o OneLink pode reconhecer cliques no WeChat e carregar uma página de destino dedicada instruindo o usuário a clicar no botão de opções e depois clicar em Abrir no navegador. Isso abre a URL de redirecionamento definida na configuração do template do OneLink.
Se o idioma do WeChat do usuário estiver cadastrado como Chinês, o OneLink gera uma versão localizada da página de destino:
