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.

Procedimentos para o Android App Links

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

Generating a SHA256 fingerprint while in development

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 <<KEY_STORE_FILE>>
// For example, the default keystore file 
keytool -list -v -keystore ~/.android/debug.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                    
 ]
]

4. Envie o SHA256 de volta para o profissional de marketing.

Generating a SHA256 fingerprint while in production

The SHA256 fingerprint is generated in

1. In Google Play console Find the public SHA256 fingerprint in Setup -> App signing (see image below)

2. Envie o SHA256 de volta para o profissional de marketing.

Adding App Link intent-filter to main activity

1. Obtenha o código de filtro de intent gerado automaticamente com o profissional de marketing. O código do filtro de intent é usado no AndroidManifest.XML.
2. Abra o arquivo 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>

ℹ️

Quando 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. Once the redirection logic for existing app users is added to the OneLink template configuration, AppsFlyer creates and hosts this path for you.
Learn more

Link do Github: XML

4. 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. Contact the marketer.

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. Abra o arquivo AndroidManifest.xml file.
2. Adicione o seguinte filtro de intent à atividade principal.
   Na seção data , substitua host and scheme com o esquema de URI que você escolheu. No código do filtro de intent abaixo, host="mainactivity" and scheme="afshopapp", correspondendo ao esquema de URI afshopapp://mainactivity.
   Se já houver um filtro de intent para o esquema de URI na atividade principal, substitua-o.

<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

3. 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.