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 de terceiros, como o Branch.

Para detalhes de implementação, consulte Deep linking. Para solução de problemas, consulte Solução de problemas de deep linking.

Existem três formas de lidar com links de mensagens da Braze no seu app iOS. Cada uma funciona de maneira diferente e é adequada para canais e casos de uso distintos.

Tipo de link Exemplo Melhor para Abre sem o app instalado?
Esquema personalizado myapp://products/123 Push, mensagens no app, Content Cards Não — o link falha
Link universal https://myapp.com/products/123 E-mail, SMS, canais com rastreamento de cliques Sim — abre a versão web como fallback
Abrir URL da web dentro do app Qualquer URL https:// Exibir conteúdo web em uma WebView modal N/A — exibe na WebView

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

Use deep links com esquema personalizado quando:

  • Enviar notificações por push, mensagens no app ou Content Cards
  • Você não precisa que o link funcione se o app não estiver instalado
  • Você não precisa de rastreamento de cliques (encapsulamento de links pelo provedor de serviços de e-mail)

Não use deep links com esquema personalizado quando:

  • Enviar e-mails — os provedores de serviços de e-mail encapsulam links para rastreamento de cliques, o que quebra esquemas personalizados
  • Você precisa que o link abra uma página web como fallback 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 direcionar para seu app em vez de abrir no navegador. Eles exigem configuração do lado do servidor (um arquivo AASA) e configuração do lado do app (entitlement de Associated Domains).

Use links universais quando:

  • Enviar e-mails. Seu provedor de serviços de e-mail encapsula links para rastreamento de cliques, então os links precisam ser HTTPS.
  • Enviar SMS ou outros canais onde os links são encapsulados ou encurtados.
  • Você precisa que o link abra uma página web como fallback quando o app não estiver instalado.
  • Você está usando um provedor de links de terceiros como Branch ou Appsflyer.

Não use links universais quando:

  • Você precisa apenas de deep links a partir de push, mensagens no app ou Content Cards. Esquemas personalizados são mais simples.

“Abrir URL da web dentro do app”

Essa opção abre uma página web dentro de uma WebView modal no seu app. Ela é gerenciada inteiramente pelo SDK da Braze usando Braze.WebViewController — você não precisa escrever nenhum código de tratamento de URL.

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

  • Você quer exibir uma página 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 use “Abrir URL da web dentro do app” quando:

  • Você precisa navegar para uma view específica no seu app. Em vez disso, use um esquema personalizado ou link universal.
  • A página web exige autenticação ou tem cabeçalhos de Content Security Policy que bloqueiam a incorporação.
Requisito Detalhes
Arquivo AASA Não é necessário
Info.plist Registre seu esquema em CFBundleURLTypes e adicione-o a LSApplicationQueriesSchemes
Método app delegate Implemente application(_:open:options:) para analisar a URL e navegar
Configuração do SDK da Braze Nenhuma — o SDK abre URLs de esquema personalizado por padrão
Requisito Detalhes
Arquivo AASA Necessário — hospede em https://yourdomain.com/.well-known/apple-app-site-association
Associated Domains Adicione applinks:yourdomain.com no Xcode em Signing & Capabilities
Método app delegate Implemente application(_:continue:restorationHandler:) para manipular NSUserActivity
Configuração do SDK da Braze Defina configuration.forwardUniversalLinks = true
BrazeDelegate (opcional) Implemente braze(_:shouldOpenURL:) para roteamento personalizado (por exemplo, Branch)

“Open Web URL Inside App”

Requisito Detalhes
Arquivo AASA Não é necessário
Método app delegate Não é necessário — o SDK gerencia isso automaticamente
Configuração do SDK da Braze Nenhuma — selecione Open Web URL Inside App no criador de Campaign

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 provedores de serviços de e-mail encapsulam os links em URLs de rastreamento de cliques HTTPS).
  • Você envia deep links em campanhas de SMS (porque os links podem ser encurtados para URLs HTTPS).
  • Você usa Branch, 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 Content Cards (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 Content Cards.
  • Você usa a opção Open Web URL Inside App.

Para instruções de configuração do AASA, consulte Links universais e App Links.

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

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

Método delegado Processa Quando implementar
application(_:open:options:) Deep links com esquema personalizado (myapp://) Você usa deep links com esquema personalizado de qualquer canal
application(_:continue:restorationHandler:) Links universais (https://) Você usa links universais de e-mail, SMS ou com forwardUniversalLinks = true
BrazeDelegate.braze(_:shouldOpenURL:) Todas as URLs abertas pelo SDK Você precisa de lógica de roteamento personalizada (por exemplo, Branch, tratamento condicional, análise de dados)

Usando o Branch com a 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 do Branch: Integre o SDK do Branch seguindo a documentação do Branch.
  2. Associated Domains: Adicione seu domínio do Branch (por exemplo, applinks:yourapp.app.link) no Xcode em Signing & Capabilities.
  3. BrazeDelegate: Implemente braze(_:shouldOpenURL:) para encaminhar os links do Branch para o SDK do Branch, em vez de permitir que a Braze os processe diretamente.
  4. Encaminhar links universais: Defina configuration.forwardUniversalLinks = true na configuração do SDK da Braze.

Para detalhes de implementação e orientações sobre depuração, consulte Branch para deep linking.
New Stuff!