Configuração inicial do iOS

Visão geral: a configuração inicial do aplicativo permite que o profissional de marketing crie links que enviam os usuários do aplicativo existentes diretamente para o aplicativo. A configuração inicial também é um pré-requisito para deep linking e o deferred deep linking.

Métodos de abertura de aplicativo

Há dois métodos de abertura de aplicativos que precisam ser implementados para cobrir toda a sua base de usuários. O método usado depende da versão da plataforma mobile.

Os dois métodos e instruções para implementação são descritos em detalhes nas seções a seguir.

MétodoDescriçãoVersões do iOSProcedimento
links universaisAbre diretamente o aplicativo móvel na atividade padrão. Os links universais assumem o formato de links regulares da web (ex.: https://yourbrand.onelink.me ou https://www.yourbrand.com)iOS 9 e superior
  1. Obtenha a ID do pacote de aplicativos e a ID do prefixo.
  2. Ative domínios associados.
Esquema do URIAbre diretamente o aplicativo com base no caminho de atividade especificado no esquema de URI.iOS todas as versões
  1. Decida sobre um esquema de URI com o profissional de marketing.
  2. Ative domínios associados.
  3. Testes

Procedimentos para links universais do iOS

Getting the app bundle ID and prefix ID

  1. Faça login na sua conta de desenvolvedor da Apple.
  2. No menu à esquerda, selecione Certificados, Identificadores e Perfis.
  3. Em Identificadores, selecione IDs de aplicativos.
  4. Clique no aplicativo relevante.
  5. Copie a ID do prefixo e a ID do pacote do aplicativo.
  6. Dê a ID do prefixo e a ID do pacote do aplicativo ao profissional de marketing.
    O profissional de marketing o usará no painel da AppsFlyer para registrar o aplicativo.
    certs_apple_info!

Enabling associated domains

Para oferecer suporte a domínios associados em seu aplicativo:

Siga as instruções do iOS para domínios associados.

Configuring mobile apps to register approved domains

A configuração de aplicativos móveis para registrar domínios aprovados ocorre dentro do Xcode. Ele requer o subdomínio OneLink que seu profissional de marketing gera.

Para configurar aplicativos móveis para registrar domínios aprovados:

  1. Obtenha o subdomínio OneLink do seu profissional de marketing.
  2. No Xcode, clique em seu projeto.
  3. Clique no alvo do projeto (veja a captura de tela a seguir).
  4. Alterne para a guia Recursos.
  5. Ative Domínio Associado.
  6. Adicione o subdomínio que você recebeu de seu profissional de marketing.
    O formato é applinks:subdomain.onelink.me.

xcode-associated-domains!

📘

To associate a domain with your app, you need to have the associated domain file on your domain and the appropriate entitlement in your app. Once the OneLink is created, AppsFlyer hosts the apple-app-site-association file. Você pode testar a configuração dos links universais usando o [validador de link da AppsFlyer](https://www.appsflyer.com/tools/link-validator/).
Quando um usuário instala seu aplicativo, o sistema tenta baixar o arquivo de domínio associado e verificar os domínios em seu Associated Domains Entitlement.

Universal Link limitations

Abrir aplicativos em navegadores

Os links universais só funcionam quando clicados. Por exemplo, ao clicar em um link em uma página da web ou e-mail. Colar o link na barra de endereços do navegador não gera o link direto ao aplicativo.

Subdomínio do OneLink

Embora o subdomínio possa ser alterado a qualquer momento, ele faz com que todos os URLs do OneLink existentes que usam o subdomínio original parem de funcionar.

OneLink em aplicativos de redes sociais

Nem todos os aplicativos, incluindo aplicativos de redes sociais, oferecem suporte completo aos links universais. Para mais detalhes, consulte este guia.

Outras limitações e problemas

É possível que haja outras limitações com os links universais. Visite a identificação e solução de problemas do OneLink para obter mais detalhes.

Procedimentos para esquema de URI

Esquema de URI é uma URL que leva os usuários diretamente ao aplicativo móvel.

Quando um usuário do aplicativo insere um esquema de URI em uma caixa de barra de endereços do navegador ou clica em um link com base em um esquema de URI, o aplicativo é iniciado e o usuário é vinculado.

Sempre que um link universal não abrir o aplicativo, o esquema de URI pode ser usado como um fallback para abrir o aplicativo.

Deciding on a URI scheme

Para decidir sobre um esquema de URI:

  1. Entre em contato com o profissional de marketing e o desenvolvedor Android.
  2. Escolha um esquema de URI. Por exemplo: yourappname://

📘

  • Use um esquema de URI que seja o mais exclusivo possível para seu aplicativo e marca para evitar sobreposições coincidentes com outros aplicativos no ecossistema. A sobreposição com outros aplicativos é um problema inerente à natureza do protocolo de esquema de URI.
  • O esquema URI não deve começar com http ou https .
  • O esquema de URI deve ser definido de forma semelhante no Android e no iOS.
  1. Envie o esquema de URI para o profissional de marketing, por exemplo afshopapp://mainactivity.

Adding URI scheme

Para adicionar o esquema de URI:

  1. No Xcode, abra o arquivo da lista de informações do aplicativo.
  2. Adicione uma entrada de tipos de URL.
  3. Expanda as linhas tipo de URL e Item 0.
  4. Adicione um identificador exclusivo para o aplicativo para o identificador de URL como um valor.
    É melhor selecionar um identificador exclusivo improvável de ser usado por outros aplicativos.
  5. Clique com o botão direito do mouse em Identificador de URL e selecione Adicionar linha > Esquemas de URI.
  6. Configure o valor do Item 0 para seu esquema único.

info_list_uri_schemes!

Prerequisites:

Um dispositivo iOS com o aplicativo instalado. Certifique-se de que é a fonte e a versão do aplicativo em que você fez alterações e implementou links universais e esquemas de URI.

Testing the URI scheme:

  1. Entre em contato com o profissional de marketing e obtenha o link personalizado que ele criou.
  2. Envie a URL curta ou longa fornecida pelo profissional de marketing para seu telefone. Você tem duas opções:
    • Digitalizar o código QR com sua câmera do telefone ou aplicativo de scanner QR.
    • Mandar o link por e-mail ou WhatsApp e abri-lo em seu telefone.
  3. Clique no link em seu dispositivo móvel.
    O aplicativo deve abrir em sua tela inicial.

Se o link não abrir o aplicativo, adicione o parâmetro af_force_deeplink=true ao link de atribuição personalizada. Por exemplo:

https://demo.onelink.me/1aBC/123ab45c?af_force_deeplink=true

URI scheme limitations

Nem a Apple nem o Google aplicam nomes exclusivos para esquemas de aplicativos. Escolha um nome de esquema exclusivo para sua marca para evitar esquemas conflitantes em diferentes aplicativos. Um bom nome de esquema pode ser o ID do pacote de aplicativos, por exemplo: com.empresa.app.

Para habilitar o OneLink para servir tanto para o iOS como para o Android, é importante que o mesmo esquema seja definido para ambas as plataformas.

When a OneLink that has af_force_deeplink=true is opened in iOS 12.3.1, the following logic applies:

  • Uma caixa de diálogo é exibida perguntando ao usuário se o aplicativo foi instalado:
    • Se o usuário escolher OK (o aplicativo está instalado), a AppsFlyer tenta abrir o aplicativo usando o esquema de URI.
    • Se o usuário escolher Cancelar (o aplicativo não está instalado), a AppsFlyer redireciona o usuário para a loja de aplicativos.
    • Se o usuário escolher OK, mas o aplicativo não estiver instalado, uma mensagem de erro será exibida:

uri_cannot_open_page!