Como configurar links universais do iOS e App Links do Android

Sobre links universais e App Links

Links universais (para iOS) e App Links (para Android) direcionam seus clientes para o conteúdo dentro do seu app para dispositivos móveis ou, se o app não estiver instalado, para o mesmo conteúdo no seu site. Usar esses links em e-mails e mensagens de texto permite que você use URLs consistentes em todos os seus canais de marketing, criando uma experiência fluida para seu cliente, independentemente do dispositivo. É semelhante ao deep linking tradicional, mas com funcionalidades adicionais.

Links universais e App Links no Klaviyo são totalmente compatíveis com rastreamento de cliques e Rastreamento de UTM.

Veja como funciona

Após a configuração, quando um cliente clica em um link em uma das suas mensagens em um dispositivo móvel, a Klaviyo consegue identificar corretamente e direcioná-lo para o local correto no seu app para dispositivos móveis, se ele estiver instalado no dispositivo. Se o app não estiver instalado, o cliente será direcionado ao seu site normalmente.

Em plataformas que não são compatíveis com essa funcionalidade, o rastreamento de cliques interfere em links universais e App Links. Isso acontece porque o rastreamento de cliques usa um redirecionamento para capturar o evento de clique, o que impede que o app seja aberto diretamente.

Seu app para dispositivos móveis deve estar usando pelo menos a versão 5.1.0 do Software Development Kit (SDK) do iOS, a versão 4.1.0 do Software Development Kit (SDK) do Android ou a versão 2.1.0 do Software Development Kit (SDK) do React Native para configurar links universais em e-mails e mensagens de texto.

Antes de começar

Antes de configurar links universais e/ou App Links na Klaviyo, você precisará ter o seguinte pronto:

• Seu app para dispositivos móveis deve estar usando pelo menos a versão 5.1.0 do Software Development Kit (SDK) do iOS, a versão 4.1.0 do Software Development Kit (SDK) do Android ou a versão 2.1.0 do Software Development Kit (SDK) do React Native para configurar links universais em e-mails e mensagens de texto.
• Para links em e-mail, um domínio dedicado de rastreamento de cliques hospedado na Klaviyo. Domínios de rastreamento de cliques de terceiros (por exemplo, domínios de rastreamento hospedados no SendGrid) não são compatíveis com links universais e App Links porque a Klaviyo precisa hospedar os arquivos de configuração (AASA / assetlinks.json) no seu domínio de rastreamento. Para instruções de configuração, consulte nosso artigo sobre como configurar um domínio dedicado de rastreamento de cliques.
• Para links em mensagens de texto, use um link personalizado com marca. Para instruções de configuração, consulte nosso artigo sobre como criar um link curto com marca para SMS.
• O SDK da Klaviyo instalado no seu app para dispositivos móveis.
• Um arquivo apple-app-site-association (AASA) (para iOS) e/ou um arquivo assetlinks.json (para Android) para o seu app para dispositivos móveis. Esses arquivos são exigidos pela Apple e pelo Google, respectivamente, para associar o seu site ao seu app para dispositivos móveis. Se você só tem um app para Android, ainda assim precisa preparar um arquivo AASA para fazer upload para a Klaviyo. A Klaviyo usa os caminhos de URL para determinar quais links reescrever para deep linking.
• Seu aplicativo móvel deve ser configurado para oferecer suporte a links universais e/ou App Links.
  • Para mais informações sobre como configurar para iOS e configurar seu arquivo apple-app-site-association (AASA), consulte a documentação para desenvolvedores da Apple sobre como oferecer suporte a domínios associados.
  • Para mais informações sobre como configurar para Android e definir seu arquivo assetlinks.json, consulte a documentação para desenvolvedores do Android sobre como adicionar links do app.

Trabalhe com o desenvolvedor do seu app para garantir que ele consiga lidar corretamente com links universais enviados pela Klaviyo. Siga as instruções do Software Development Kit (SDK) do iOS, Android ou React Native para o seu app.

Como configurar links universais e App Links na Klaviyo

1. Navegue até Configurações na sua conta Klaviyo.
2. Click notificação push.
3. Selecione a guia Links universais e de aplicativos.
4. No cartão, revise os domínios de rastreamento. Se um canal mostrar Configuração necessária, conclua primeiro a configuração de domínio dele. Quando pelo menos 1 canal mostrar Pronto, clique em Configurar na parte superior do cartão.

1. Insira seu domínio de destino, o domínio do site usado nos links da sua mensagem. Por exemplo, para https://shop.example.com/products, insira shop.example.com sem o protocolo ou o caminho.
2. Clique em Avançar.
3. Faça upload do seu arquivo apple-app-site-association (AASA) sem extensão do arquivo. Se você tiver um app Android, também faça upload do seu arquivo assetlinks.json.
   • Se você tiver um app para iOS e outro para Android, precisará fazer upload de ambos os arquivos.
   • Se você tiver apenas um app iOS, só precisará fazer upload de um arquivo AASA.
   • Se você tiver apenas um app Android, será necessário fazer upload de ambos os arquivos. O arquivo AASA define os caminhos de URL que a Klaviyo trata como links universais para ambas as plataformas.

Se várias contas da Klaviyo compartilharem um domínio de rastreamento, salvar alterações na configuração dele afetará todas essas contas.

1. Clique em Save. A Klaviyo aplica essa configuração a todos os domínios de rastreamento qualificados na sua conta.
2. Depois de salvar, revise o status do domínio de rastreamento na página de configurações. As novas configurações são ativadas automaticamente. Se um domínio que você quer usar mostrar Pronto, clique em Ativar nessa linha. Confirme se os domínios que você quer usar mostram com atividade.

Substituição universal

Em alguns casos, talvez você queira designar um link específico para abrir no seu app, mesmo que ele não corresponda aos caminhos definidos no seu arquivo AASA. Você pode substituir o comportamento padrão adicionando o atributo universal="true" ao HTML do link.

Por exemplo: <a href="https://shop.example.com/products" universal="true">Link to your app!</a>

Como alternativa, você pode fazer o inverso adicionando o atributo universal="false" ao HTML do link.

Observação: essa funcionalidade está disponível apenas para e-mails.

Testando sua configuração

Para testar seus links universais e App Links, crie uma nova campanha ou mensagem de fluxo e inclua um link para uma página do seu site que você configurou para deep linking. Envie uma mensagem para um dispositivo com seu app instalado e outra para um dispositivo sem seu app instalado.

• No dispositivo com seu app instalado, o link deve abrir diretamente no seu app.
• No dispositivo sem o seu app instalado, o link deve abrir no navegador da web do dispositivo.

Use uma campanha ou uma mensagem de fluxo real para fazer testes. As mensagens de prévia não usam o rastreamento de cliques da Klaviyo, então os links podem ser diferentes dos links rastreados em mensagens reais.

Como visualizar seus links universais e arquivos App Links hospedados pela Klaviyo

Depois de concluir a configuração, a Klaviyo hospedará versões dos seus arquivos de configuração. Para visualizá-los, acesse as seguintes URLs no seu navegador, substituindo <YOUR_TRACKING_DOMAIN> pelo seu próprio domínio:

• iOS: https://<YOUR_TRACKING_DOMAIN>/.well-known/apple-app-site-association
• Android: https://<YOUR_TRACKING_DOMAIN>/.well-known/assetlinks.json

Perguntas frequentes

Preciso ter um domínio exclusivo para rastreamento de cliques?

É necessário ter um domínio dedicado de rastreamento de cliques para usar links universais e App Links para e-mail. Esse domínio precisa ser hospedado pela Klaviyo (KMTA). Links universais e App Links não são compatíveis com domínios de rastreamento de cliques hospedados por outros provedores (por exemplo, SendGrid) porque a Klaviyo precisa hospedar e disponibilizar os arquivos de configuração de links universais (AASA / assetlinks.json) no seu domínio de rastreamento. Para SMS, você precisa configurar um link curto personalizado com a sua marca.

O que acontece se eu tiver várias contas da Klaviyo que compartilham um único domínio de rastreamento?

Se várias contas compartilharem um único domínio de rastreamento, as alterações na configuração do domínio afetarão todas essas contas.