Configuração inicial do Android

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

Existem dois métodos de abertura de aplicativos que podem 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 AndroidProcedimento
Links de aplicativo AndroidAbre diretamente o aplicativo móvel na atividade padrão.Android V6+
  1. Gerar fingerprint SHA256.
  2. Adicione filtro de intent à atividade principal.
Esquema do URIAbre diretamente o aplicativo com base no caminho de atividade especificado no esquema de URI.Todas as versões do Android
  1. Decida sobre um esquema de URI com o profissional de marketing.
  2. Adicione filtro de intent à atividade principal.
  3. Testes

Procedimentos para o Android App Links

Os Android App Links funcionam com Android V6 e superior. Saiba mais.

Generating a SHA256 fingerprint

Para gerar a fingerprint SHA256:

  1. Localize a keystore do aplicativo.
    Se o aplicativo ainda estiver em desenvolvimento, localize o debug.keystore
    • Para usuários do Windows: C:\Users\USERNAME\.android\debug.keystore
    • Para usuários do Linux ou Mac OS: ~/.android/debug.keystore
  2. Abra a linha de comando e navegue até a pasta onde o arquivo keystore está localizado.
  3. Execute o comando:
keytool -list -v -keystore [APK-KEY].keystore

🚧

A senha para debug.keystore geralmente é "android".

A saída deverá ser semelhante ao seguinte:

Alias name: test
Creation date: Sep 27, 2017
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=myname
Issuer: CN=myname
Serial number: 365ead6d
Valid from: Wed Sep 27 17:53:32 IDT 2017 until: Sun Sep 21 17:53:32 IDT 2042
Certificate fingerprints:
MD5: DB:71:C3:FC:1A:42:ED:06:AC:45:2B:6D:23:F9:F1:24
SHA1: AE:4F:5F:24:AC:F9:49:07:8D:56:54:F0:33:56:48:F7:FE:3C:E1:60
SHA256: A9:EA:2F:A7:F1:12:AC:02:31:C3:7A:90:7C:CA:4B:CF:C3:21:6E:A7:F0:0D:60:64:4F:4B:5B:2A:D3:E1:86:C9
Signature algorithm name: SHA256withRSA
Version: 3
Extensions:
#1: ObjectId: 2.5.29.14 Criticality=false
SubjectKeyIdentifier [
  KeyIdentifier [
   0000: 34 58 91 8C 02 7F 1A 0F  0D 3B 9F 65 66 D8 E8 65 
   0010: 74 42 2D 44                    
 ]
]
  1. Envie o SHA256 de volta para o profissional de marketing.

Adding App Link intent-filter to main activity

Para adicionar o filtro de intent à atividade principal:

  1. Obtenha o código de filtro de intent gerado automaticamente com profissional de marketing. O código do filtro de intent é usado no AndroidManifest.XML.
  2. Open the app's AndroidManifest.xml file.
  3. Adicione o filtro de intent à atividade principal.
    Se já houver um filtro de intent para o Android App Link na atividade principal, substitua-o.

Exemplo

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />

    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data
        android:host="onelink-basic-app.onelink.me"
        android:scheme="https" />
</intent-filter>

ℹ️

When android:autoVerify="true" está presente em qualquer um dos seus filtros de intent, instalar seu aplicativo em dispositivos com Android 6 e superior faz com que o sistema tente verificar todos os hosts associados aos URLs em qualquer um dos filtros de intent do seu aplicativo.
Para cada nome de host exclusivo encontrado nos filtros de intenção acima, o Android consulta os sites correspondentes para o arquivo Digital Asset Links em https://hostname/.well-known/assetlinks.json. Depois que o OneLink é criado, a AppsFlyer cria e hospeda esse caminho para você. Você pode testar a configuração do App Links usando o validador de links da AppsFlyer.
Saiba mais

Link do Github: XML

  1. Diga ao profissional de marketing que a configuração do App Link foi concluída.
    Quando o profissional de marketing testa o link, ele deve direcionar o usuário para a página principal do aplicativo.

Procedimentos para esquema de URI

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

Quando um usuário de aplicativo insere um esquema de URI na barra de endereço de um navegador ou clica em um link com base em um esquema de URI, o aplicativo é iniciado e o usuário recebe um deep link.

Sempre que um link de aplicativo falhar ao abrir o aplicativo, o esquema de URI pode ser utilizado 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 iOS.

  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.
  3. Envie o esquema de URI para o profissional de marketing. Por exemplo: afshopapp://mainactivity

Adding URI scheme intent-filter to the main activity

Para adicionar o filtro de intent à atividade principal:

  1. Open the app's AndroidManifest.xml file.
  2. Add the following intent-filter to the main activity.
    In the data section, replace host and scheme with the URI scheme you chose. In the intent-filter code below, host="mainactivity" and scheme="afshopapp", matching the URI scheme afshopapp://mainactivity.
    If there already is an intent-filter for the URI scheme in the main activity, overwrite it.
<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data
        android:host="mainactivity"
        android:scheme="afshopapp" />
</intent-filter>

⇲ Link do Github: XML

  1. Dê o esquema de URI ao profissional de marketing.

Testing URI schemes

Pré-requisitos:

Um dispositivo Android com o aplicativo instalado. Certifique-se de que é a fonte e a versão do aplicativo em que você fez alterações e implementou App Links e/ou um esquema de URI.

Para testar o esquema de URI:

  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.