Configuración inicial de Android

De un vistazo: La configuración inicial de la aplicación permite al marketer crear enlaces que enviarán a los usuarios existentes de la aplicación directamente a la aplicación. La configuración inicial también es un requisito previo para enlaces profundos y enlaces profundos diferidos.

Métodos de apertura de aplicaciones

Hay dos métodos de apertura de aplicaciones que se pueden implementar para cubrir toda tu base de usuarios. El método utilizado depende de la versión de la plataforma móvil.

Los dos métodos e instrucciones para la implementación se describen en detalle en las siguientes secciones.

MétodoDescripciónVersiones de AndroidProcedimiento
Enlaces de aplicaciones de AndroidAbre la aplicación móvil directamente en la actividad predeterminada.Android V6+
  1. Generar fingerprint SHA256.
  2. Agregar filtro de intención a la actividad principal.
Esquema URIAbrir la aplicación directamente en función de la ruta de actividad especificada en el esquema URL.Todas las versiones de Android 
  1. Decidir sobre un esquema URI con el marketer.
  2. Agregar filtro de intención a la actividad principal.
  3. Pruebas

Procedimientos para enlaces de aplicaciones de Android

Los enlaces de aplicaciones de Android funcionan con Android V6 y versiones posteriores. Aprender más.

Generating a SHA256 fingerprint while in development

  1. Ubica el keystore de tu aplicación.
    Si la aplicación aún está en desarrollo, ubica el debug.keystore
    • Para usuarios de Windows: C:\Users\USERNAME\.android\debug.keystore
    • Para usuarios de Linux o Mac OS: ~/.android/debug.keystore
  2. Abre la línea de comandos y dirígete a la carpeta donde se encuentra el archivo keystore.
  3. Ejecuta el comando:
// keytool -list -v -keystore <<KEY_STORE_FILE>>
// For example, the default keystore file 
keytool -list -v -keystore ~/.android/debug.keystore

🚧

Por lo general, la contraseña del debug.keystore es "android".

El resultado debe verse de la siguiente manera:

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. Envía el SHA256 de vuelta al marketer.

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)

Google Play SHA256 cert!

  1. Envía el SHA256 de vuelta al marketer.

Adding App Link intent-filter to main activity

  1. Obtén el código intent-filter generado automáticamente del marketer. El código intent-filter se utiliza en AndroidManifest.XML.
  2. Abre el archivo de la aplicación AndroidManifest.xml file.
  3. Agrega el filtro de intención a la actividad principal.
    Si ya hay un filtro de intención para el enlace de aplicaciones de Android en la actividad principal, sobrescríbelo.

Ejemplo

<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" />
    
    <!-- Replace "onlink-basic-app" with your OneLink domain -->
    <data
        android:host="onelink-basic-app.onelink.me"
        android:scheme="https" />
</intent-filter>

ℹ️

Cuando android:autoVerify="true" está presente en cualquiera de tus filtros de intención, la instalación de la aplicación en dispositivos con Android 6 y versiones posteriores hace que el sistema intente verificar todos los hosts asociados con las URL en cualquiera de los filtros de intención de la aplicación.
Por cada nombre de host único que se encuentra en los filtros de intención anteriores, Android consulta los sitios web correspondientes para el archivo Digital Asset Links en 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

Enlace de Github: XML

  1. Dile al marketer que se ha completado la configuración del enlace de aplicación.
    Cuando el marketer pruebe el enlace, debería dirigir al usuario a la página principal de la aplicación.

📘

Specifying which templates open your app

You can specify which templates open your app by adding them to the pathPrefix element, as shown in the example below:

<intent-filter android:autoVerify="true">
		...		
   <!-- Replace "onlink-basic-app" with your OneLink domain -->
   <data 
       android:scheme="https"
       android:host="onelink-basic-app.onelink.me" 
       android:pathPrefix="/H5hv" />
   <data 
       android:scheme="https"
       android:host="onelink-basic-app.onelink.me" 
       android:pathPrefix="/H2jv" />
</intent-filter>

Procedimientos para el esquema URI

Los esquemas URI son una URL que lleva a los usuarios directamente a la aplicación móvil.

Cuando un usuario de una aplicación introduce un esquema URI en la barra de direcciones del navegador, o hace clic en un enlace basado en un esquema URI, la aplicación se inicia y el usuario se conecta mediante enlaces profundos.

Siempre que un enlace de aplicación no abra la aplicación, el esquema URI se puede usar como respaldo para abrir la aplicación.

Deciding on a URI scheme

Para decidir sobre un esquema URI:

  1. Contact the marketer.

  2. Elige un esquema de URI. Por ejemplo: yourappname://

    ℹ️

    • Usa un esquema URI que sea lo más exclusivo posible para tu aplicación y marca a fin de evitar la superposición casual con otras aplicaciones del ecosistema. La superposición con otras aplicaciones es un problema inherente en la naturaleza del protocolo del esquema URI.
    • El esquema URI no debe comenzar con http o https.
    • El esquema URI debe definirse de manera similar en Android e iOS.
  3. Envía el esquema URI al marketer. Por ejemplo: afshopapp://mainactivity

Adding URI scheme intent-filter to the main activity

Para agregar el filtro de intención a la actividad principal:

  1. Abre el archivo de la aplicación AndroidManifest.xml file.
  2. Agrega el filtro de intención a la actividad principal.
    En la sección data , reemplaza host and scheme con el esquema URI que escogiste. En el siguiente código de intent-filter, host="mainactivity" and scheme="afshopapp", que coincidan con el esquema URI afshopapp://mainactivity.
    Si ya hay un filtro de intención para el esquema URI en la actividad principal, sobrescríbelo.
<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>

Enlace de Github: XML

  1. Envía el esquema URI al marketer.

Testing URI schemes

Requisitos previos:

Un dispositivo Android con la aplicación instalada. Asegúrate de que sea la fuente y la versión de la aplicación en la que hiciste cambios e implementaste los enlaces universales y/o un esquemas URI.

Para probar el esquema URI:

  1. Comunícate con el marketer y obtén el enlace personalizado que creó.
  2. Envía la URL corta o larga que obtienes del marketer a tu teléfono. Puedes elegir cualquiera de las siguientes opciones:
    • Escanear el código QR con la cámara de tu teléfono o con la aplicación de escáner de QR.
    • Enviar el enlace por correo electrónico o por WhatsApp y abrirlo en tu teléfono
      .
  3. Haz clic en el enlace en tu dispositivo móvil.
    La aplicación debería abrirse en su pantalla de inicio.