Fallback de esquemas URI para iOS

Para:
Profissionais de marketing Desenvolvedores
Última atualização:

Visão geral: entenda o fluxo de usuários que usam dispositivos iOS e clicam em um link personalizado do OneLink, porém o Universal Link não consegue abrir o aplicativo.

Fallback de URI para iOS

  • A melhor forma de abrir um aplicativo em dispositivos iOS é usando Universal Links. Desde 2016, existem limitações consideráveis do sistema operacional quanto ao uso de esquemas URI como um método de fallback nos casos em que os Universal Links falham. Essas limitações não estão relacionadas com a AppsFlyer e também afetariam outros links com esquemas URI usados para abrir um aplicativo.
  • Por padrão, os esquemas URI (enviados como o valor do parâmetro af_dp) são usados apenas como um método de fallback em alguns navegadores/plataformas específicos no iOS.
  • No Safari, você pode tentar usar esquemas URI como fallback configurando os seguintes parâmetros na URL do OneLink: 
    • af_dp (que inclui o esquema URI como o valor).
    • af_force_deeplink=true (que força o aplicativo a abrir usando o esquema URI af_dp). Sem esse parâmetro, o aplicativo não abre usando esse esquema.
  • Em outros navegadores, os esquemas URI atuam de forma imprevisível e, por isso, não são compatíveis por padrão. Os usuários que clicarem no link provavelmente serão redirecionados para a App Store (ou para a URL configurada no af_ios_url parâmetro).
  • Consulte o fluxograma de cenários e os casos de uso a seguir para mais detalhes. 

Fluxograma de cenários

Copy_of_Ios_fall_back_-_scenarios_flowchart__2_.png

Casos de uso

Navegadores que podem usar esquemas URI por padrão

Às vezes, os Universal Links não conseguem abrir o aplicativo, porque ele não foi baixado ou porque o link não inclui Universal Links configurados. Nesses casos,os seguintes navegadores/plataformas podem usar esquemas URI como um método de fallback para abrir o app:

  • Chrome
  • X (antigo Twitter)
    Observação: Se o aplicativo não estiver instalado, os usuários verão uma mensagem de erro e, depois de descartar a mensagem, serão redirecionados para a App Store (ou para o destino de acordo com o parâmetro af_ios_url).
  • Kakaotalk
  • Naver
  • Never-Blog
  • Weibo

Fluxograma

Copy_of_Ios_fall_back_-_browsers_that_can_use_URI_schemes_by_default__2_.png

Safari

A seguir, descrevemos o fluxo de usuários quando os Universal Links não conseguem abrir o aplicativo e o link contém af_dp (que inclui o esquema URI como valor).

Se o aplicativo não estiver instalado:

  1. A mensagem de erro do Safari é exibida.

  2. O usuário clica em OK. Uma landing page é carregada em segundo plano e, em 1 segundo, o usuário é redirecionado automaticamente para a App Store ou para o destino desejado de acordo com o parâmetro af_ios_url.

Se o aplicativo estiver instalado: 

  • Se o link não contiver af_force_deeplink=true, o usuário será redirecionado para a App Store ou para o destino desejado de acordo com o parâmetro af_ios_url.
  • Se o link contiver af_force_deeplink=true:
    1. A notificação do Safari é exibida.

    2. Se o usuário clicar em Abrir, o aplicativo será aberto.
    3. Se o usuário clicar em Cancelar:
      • Se o parâmetro af_ios_url estiver definido, o usuário será redirecionado de acordo.
      • Se o parâmetro af_ios_url não estiver definido, a mensagem de erro do Safari será exibida em segundo plano.

    4. O usuário clica em OK e vê uma landing page com um call to action (CTA).
    5. O usuário clica no CTA e uma mensagem é exibida.

    6. Se o usuário clicar em Abrir, o aplicativo será aberto. 
    7. Se o usuário clicar em Cancelar , uma mensagem será exibida.

    8. Se o usuário clicar em OK, ele será redirecionado para a App Store. 
    9. Se o usuário clicar em Cancelar, ele permanecerá na landing page. 

Fluxograma

Copy_of_Ios_fall_back_-_safari.png

Publicação no Facebook —não paga

A seguir, descrevemos o fluxo de usuários para casos em que os Universal Links não conseguem abrir o aplicativo e o link contémaf_dp (que inclui o esquema URI como valor).

Se o aplicativo estiver instalado: 

  • O aplicativo é aberto.

Se o aplicativo não estiver instalado: 

  1. Caso não haja nenhum aplicativo de rede social configurado, ou caso o usuário clique no CTA na landing page de uma rede social, uma mensagem será exibida em segundo plano.

  2. Clique em Abrir aplicativo. Em seguida, observamos um dos seguintes resultados:
    • Se o parâmetro af_ios_url estiver configurado, o usuário será redirecionado de acordo.
    • Se o parâmetro af_ios_url não estiver configurado e se af_force_deeplink=true não estiver no link, o usuário será redirecionado de acordo.
    • Se o parâmetro af_ios_url não estiver configurado e se af_force_deeplink=true for incluído no link, a mensagem será exibida novamente sobre a landing page em segundo plano.

  3. Se o usuário clicar em Abrir, ele será enviado para a App Store.
  4. Se o usuário clicar em Fechar, a landing page será exibida.

  5. O usuário clica no selo da App Store e é redirecionado para lá.

Fluxograma

diagram-X.png