Начальная настройка для Android

Краткий обзор. При начальной настройке приложения маркетолог может создать ссылки, по которым имеющиеся пользователи будут направляться прямо в приложение. Начальная настройка также является необходимым условием для диплинкинга и отложенного диплинкинга.

Методы открытия приложения

Есть два метода открытия приложений, которые необходимо реализовать для полного охвата базы пользователей. Применение этих методов зависит от мобильной платформы и ее версии.

Два метода и инструкции по внедрению подробно описаны в следующих разделах.

МетодОписаниеВерсии AndroidПроцедура
Android App LinksОткрывают мобильное приложение непосредственно на странице события, установленной по умолчанию.Android V6+
  1. Сгенерируйте отпечаток SHA256.
  2. Добавьте фильтр намерений в основную активность.
Схема URIОткрывает приложение напрямую на основе пути к активности, указанного в схеме URI.Android все версии
  1. Определите схему URI вместе с маркетологом.
  2. Добавьте фильтр намерений в основную активность.
  3. Тестирование

Процедуры настройки Android App Links

Ссылки Android App Links работают с Android 6 и выше. Подробнее.

Generating a SHA256 fingerprint while in development

  1. Найдите хранилище ключей приложения.
    Если ваше приложение еще в разработке, найдите файл debug.keystore
    • Для пользователей Windows: C:\Users\USERNAME\.android\debug.keystore
    • Для пользователей Linux или Mac OS: ~/.android/debug.keystore
  2. Откройте командную строку и перейдите в папку, в которой находится файл хранилища ключей.
  3. Выполните следующую команду:
// keytool -list -v -keystore <<KEY_STORE_FILE>>
// For example, the default keystore file 
keytool -list -v -keystore ~/.android/debug.keystore

🚧

В качестве пароля для debug.keystore, как правило, используется "android".

Результат должен выглядеть примерно так:

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. Отправьте SHA256 маркетологу.

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. Отправьте SHA256 маркетологу.

Adding App Link intent-filter to main activity

  1. Получите автоматически сгенерированный код для фильтра намерений у маркетолога. Код фильтра намерений используется в файле AndroidManifest.XML.
  2. Откройте файл приложения AndroidManifest.xml file.
  3. Добавьте фильтр намерений в основную активность.
    Если в ней уже есть фильтр намерений для ссылки Android App Link, перезапишите его.

Пример

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

ℹ️

Если в одном из фильтров намерений есть код android:autoVerify="true" , при установке приложения на устройства с Android 6 и выше система будет пытаться проверить все хосты, связанные с URL-адресами в фильтрах намерений приложения.
Для каждого уникального имени хоста, найденного в приведенных выше фильтрах намерений, Android запрашивает у соответствующих сайтов файл Digital Asset Links (ссылки на цифровые ресурсы) по адресу 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

Ссылка на Github: XML

  1. Сообщите маркетологу, что настройка App Link завершена.
    При проверке ссылки маркетологом она должна вести пользователя на главную страницу приложения.

Процедура настройки схемы URI

Схема URI — это URL-адрес, который приводит пользователей прямо в мобильное приложение.

Когда пользователь приложения вводит схему URI в адресную строку браузера или переходит по ссылке на основе схемы URI, запускается приложение и пользователь перенаправляется по диплинку.

Если приложение не открывается по ссылке App Link, в качестве резервного варианта для открытия приложения можно использовать схему URI.

Deciding on a URI scheme

Чтобы определиться со схемой URI:

  1. Contact the marketer.

  2. Выберите схему URI. Например: yourappname://

    ℹ️

    • Схема URI должна быть уникальной для вашего приложения и бренда, чтобы избежать случайных совпадений с другими приложениями в экосистеме. Совпадения с другими приложениями — характерная проблема для протокола со схемами URI.
    • Схема URI не должна начинаться с http или https.
    • Схема URI должна быть определена одинаковым образом для Android и iOS.
  3. Отправьте схему URI маркетологу. Например: afshopapp://mainactivity

Adding URI scheme intent-filter to the main activity

Чтобы добавить фильтр намерений для основной активности:

  1. Откройте файл приложения AndroidManifest.xml file.
  2. Добавьте следующий фильтр намерений в основную активность.
    В разделе data замените host and scheme на выбранную вами схему URI. В коде фильтра намерений ниже, host="mainactivity" and scheme="afshopapp", что соответствует схеме URI afshopapp://mainactivity.
    Если в основной активности уже есть фильтр намерений для схемы URI, перезапишите его.
<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>

⇲ Ссылка на Github: XML

  1. Предоставьте схему URI маркетологу.

Testing URI schemes

Необходимые условия:

Устройство Android с установленным приложением. Убедитесь, что это те источник приложения и версия, в которые вы внесли изменения и внедрили App Links и/или схему URI.

Чтобы протестировать схему URI:

  1. Свяжитесь с маркетологом и получите созданную им настраиваемую ссылку.
  2. Отправьте короткий или длинный URL-адрес, полученные от маркетолога, на свой телефон. Вы можете:
    • Сканировать QR-код с помощью камеры на телефоне или приложения для сканирования.
    • Переслать себе ссылку по электронной почте или WhatsApp и открыть ее на телефоне.
  3. Нажмите на ссылку на мобильном устройстве.
    Должна открыться главная страница приложения.