Skip to content

Guia de deep linking para iOS

Este guia ajuda você a escolher a estratégia de deep linking certa para seu app iOS, dependendo do canal de envio de mensagens que você está usando e se você usa um provedor de links terceirizado, como o Branch.

Para obter detalhes sobre a implementação, consulte deep linking. Para solucionar problemas, consulte Solução de problemas de deep linking.

Existem três maneiras de lidar com links de mensagens Braze em seu app iOS. Cada um funciona de maneira diferente e é adequado para diferentes canais e casos de uso.

Deep links personalizados (por exemplo, myapp://products/123) abrem seu app diretamente em uma tela específica. São a opção mais simples para canais em que os links não são modificados por terceiros.

Use deep links com esquema personalizado quando:

  • Envio de notificações por push, mensagens no app ou cartões de conteúdo
  • Você não precisa do link para funcionar se o app não estiver instalado.
  • Você não precisa de rastreamento de cliques (envoltório de link ESP de e-mail)

Não utilize deep links com esquema personalizado quando:

  • Envio de e-mails — os ESPs envolvem links para rastreamento de cliques, o que quebra esquemas personalizados
  • Você precisa do link para voltar a uma página da web se o app não estiver instalado.

Links universais (por exemplo, https://myapp.com/products/123) são URLs HTTPS padrão que o iOS pode encaminhar para o seu app em vez de abrir em um navegador. Eles exigem configuração no lado do servidor (um arquivo AASA) e configuração no lado do app (direito de domínios associados).

Use links universais quando:

  • Envio de e-mails. Seu ESP envolve links para rastreamento de cliques, portanto, os links devem ser HTTPS.
  • Envio de SMS ou outros canais onde os links são encurtados ou encapsulados.
  • Você precisa do link para voltar a uma página da web quando o app não estiver instalado.
  • Você está usando um provedor de links de terceiros, como Branch ou Appsflyer.

Não utilize links universais quando:

  • Você só precisa de deep links de push, mensagens no app ou cartões de conteúdo. Os esquemas personalizados são mais simples.

“Abrir URL da Web dentro do app”

Esta opção abre uma página da Web dentro de um WebView modal no seu app. É totalmente gerenciado pelo SDK Braze usandoBraze.WebViewController— você não precisa escrever nenhum código de gerenciamento de URL.

Use “Abrir URL da Web dentro do app” quando:

  • Você deseja exibir uma página da web (como uma promoção ou artigo) sem sair do seu app.
  • A URL é uma página web HTTPS padrão, não um deep link para uma tela específica do app.

Não utilize “Abrir URL da Web dentro do app” quando:

  • Você precisa navegar para uma visualização específica em seu app. Em vez disso, use um esquema personalizado ou um link universal.
  • A página da Web requer autenticação ou possui cabeçalhos de Política de Segurança de Conteúdo que bloqueiam a incorporação.

“Abrir URL da Web dentro do app”

Quando você precisa de um arquivo AASA

Um arquivo Apple App Site Association (AASA) só é necessário quando você usa links universais. Ele informa ao iOS quais URLs seu app pode processar.

Você precisa de um arquivo AASA quando:

  • Você envia deep links em campanhas de e-mail (porque os ESPs envolvem os links em URLs de rastreamento de cliques HTTPS).
  • Você envia deep links em campanhas por SMS (porque os links podem ser encurtados para URLs HTTPS).
  • Você usa o Branch, o Appsflyer ou outro provedor de links (porque eles usam seus próprios domínios HTTPS).
  • Você usa links universais de push, mensagens no app ou cartões de conteúdo (menos comum, mas possível com forwardUniversalLinks = true).

Você não precisa de um arquivo AASA quando:

  • Você só usa deep links com esquema personalizado (por exemplo, myapp://) de push, mensagens no app ou cartões de conteúdo.
  • Utilize a opção Abrir URL da Web dentro do app.

Para obter instruções de configuração da AASA, consulte Links universais e Links de apps.

Quando você precisa de código de app para lidar com links

O método delegado que você implementa depende do tipo de link que está usando:

Usando o Branch com o Braze

Se você usar o Branch como seu provedor de links, sua configuração exigirá algumas etapas adicionais além da configuração padrão de link universal:

  1. SDK da filial: Integre o SDK do Branch seguindo a documentação do Branch.
  2. Domínios associados: Adicione seu domínio Branch (por exemplo, applinks:yourapp.app.link) no Xcode em Recursos de &assinatura.
  3. BrazeDelegate: Implementebraze(_:shouldOpenURL:)para encaminhar os links do Branch para o SDK do Branch, em vez de permitir que o Braze os processe diretamente.
  4. Encaminhe links universais: Definaconfiguration.forwardUniversalLinks = truena sua configuração do SDK Braze.

Para obter detalhes sobre a implementação e orientações sobre depuração, consulte Branch para deep linking.
Github   Editar esta página no GitHub
New Stuff!