Guides

Configuration initiale d'Android

Suggérer des modifications

En bref : la configuration initiale de l'app permet au marketeur de créer des liens qui enverront les utilisateurs existants directement dans l'app. La configuration initiale est également une condition préalable pour le deep linking et le deep linking différé.

Méthodes d'ouverture des apps

Deux méthodes d'ouverture d'app peuvent être implémentées pour couvrir l'ensemble de votre base d'utilisateurs. La méthode utilisée dépend de la version de la plateforme mobile.

Les deux méthodes et instructions de mise en œuvre sont décrites en détail dans les sections suivantes.

MéthodeDescriptionVersions AndroidProcédure
Liens d'application AndroidOuvre l'app mobile directement sur l'activité par défaut.Android V6 et +
  1. Générer l'empreinte digitale SHA256.
  2. Ajouter un filtre d'intention à l'activité principale.
Schéma d'URIOuvre directement l'app en fonction du chemin d'activité spécifié dans le schéma d'URI.Android toutes versions
  1. Définir un schéma d'URI avec le marketeur.
  2. Ajouter un filtre d'intention à l'activité principale.
  3. Test

Procédures pour les liens d'app Android

Les liens d'app Android fonctionnent sous Android 6 et +. En savoir plus.

Generating a SHA256 fingerprint while in development

  1. Localisez le store principal votre app.
    Si l'app est encore en développement, localisez le debug.keystore
    • Pour les utilisateurs de Windows : C:\Users\USERNAME\.android\debug.keystore
    • Pour les utilisateurs Linux ou Mac : ~/.android/debug.keystore
  2. Ouvrez la ligne de commande et accédez au dossier où se trouve le fichier keystore.
  3. Exécutez la commande :
// keytool -list -v -keystore <<KEY_STORE_FILE>>
// For example, the default keystore file 
keytool -list -v -keystore ~/.android/debug.keystore

🚧

Le mot de passe de debug.keystore est généralement « android ».

Le résultat doit ressembler à ceci :

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. Renvoyez le SHA256 au marketeur.

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. Renvoyez le SHA256 au marketeur.

Adding App Link intent-filter to main activity

  1. Get the auto-generated intent-filter code from the marketer. The intent-filter code is used in the AndroidManifest.XML.
  2. Ouvrez l'app AndroidManifest.xml file.
  3. Ajoutez le filtre d'intention à l'activité principale.
    S'il existe déjà un filtre d'intention pour le lien d'app Android dans l'activité principale, écrasez-le.

Exemple

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

ℹ️

Quand android:autoVerify="true" si la valeur est présente dans l'un de vos filtres intent, lorsque vous installez votre app sur des appareils sous Android 6 et +, le système vérifie tous les hôtes associés aux URL pour l'un des filtres intent de votre app.
Pour chaque nom d'hôte unique trouvé dans les filtres intent, Android interroge les sites web correspondants pour le fichier Digital Asset Links sur 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

Lien github : XML

  1. Informez le marketeur que la configuration du lien d'app est terminée.
    Lorsque le marketeur teste le lien, ce dernier doit diriger l'utilisateur vers la page principale de l'app.

Procédures pour le schéma d'URI

Les schémas d'URI sont des URL menant les utilisateurs directement à l'app mobile.

Lorsque l'utilisateur d'une app saisit un schéma d'URI dans la barre d'adresse d'un navigateur, ou clique sur un lien basé sur un schéma d'URI, l'app se lance et l'utilisateur suit un deep link.

Lorsqu'un lien d'app ne parvient pas à ouvrir une app, le schéma d'URI peut être utilisé en solution de secours.

Deciding on a URI scheme

Pour choisir un schéma d'URI :

  1. Contact the marketer.

  2. Choisissez un schéma d'URI. Par exemple : yourappname://

    ℹ️

    • Utilisez un schéma d'URI le plus particulier possible pour votre app et votre marque afin d'éviter les répétitions avec d'autres apps de l'écosystème. Les doublons entre applications est un problème qui est inhérent au protocole du schéma URI.
    • Le schéma d'URI ne doit pas commencer par http ou https.
    • Le schéma d'URI doit être défini de manière similaire sur Android et iOS.

  3. Envoyer le schéma d'URI au marketeur. Par exemple : afshopapp://mainactivity

Adding URI scheme intent-filter to the main activity

Pour ajouter le filtre d'intention à l'activité principale :

  1. Ouvrez l'app AndroidManifest.xml file.
  2. Ajoutez le filtre intent à l'activité principale.
    Dans la section data , remplacez host and scheme par le schéma d'URI que vous avez choisi. Dans le code du filtre intent ci-dessous, host="mainactivity" and scheme="afshopapp"correspondent au schéma d'URI afshopapp://mainactivityS'il existe déjà un filtre intent pour le schéma d'URI dans l'activité principale, écrasez-le.
<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>

⇲ Lien github : XML

  1. Envoyez le schéma d'URI au marketeur.

Testing URI schemes

Conditions préalables :

Un appareil Android avec l'app installée. Vérifiez que c'est bien l'app d'origine et la version à laquelle vous avez apporté des modifications et implémenté des liens universels et des schémas d'URI.

Pour tester le schéma d'URI :

  1. Contactez le marketeur et obtenez le lien personnalisé qu'il a créé.
  2. Envoyez l'URL courte ou longue que le marketeur vous transmet sur votre téléphone. Vous pouvez soit :
    • Scanner le code QR avec la caméra de votre téléphone ou bien l'app QR scanner.
    • Vous envoyer le lien par e-mail ou par WhatsApp, et l'ouvrir sur votre téléphone
      .
  3. Cliquez sur le lien de votre appareil mobile.
    L'app devrait s'ouvrir sur son écran d'accueil.

Mis(e) à jour Il y a 7 mois