Начальная настройка для Android
Краткий обзор. При начальной настройке приложения маркетолог может создать ссылки, по которым имеющиеся пользователи будут направляться прямо в приложение. Начальная настройка также является необходимым условием для диплинкинга и отложенного диплинкинга.
Методы открытия приложения
Есть два метода открытия приложений, которые необходимо реализовать для полного охвата базы пользователей. Применение этих методов зависит от мобильной платформы и ее версии.
Два метода и инструкции по внедрению подробно описаны в следующих разделах.
Метод | Описание | Версии Android | Процедура |
---|---|---|---|
Android App Links | Открывают мобильное приложение непосредственно на странице события, установленной по умолчанию. | Android V6+ | |
Схема URI | Открывает приложение напрямую на основе пути к активности, указанного в схеме URI. | Android все версии |
Процедуры настройки Android App Links
Ссылки Android App Links работают с Android 6 и выше. Подробнее.
Generating a SHA256 fingerprint while in development
- Найдите хранилище ключей приложения.
Если ваше приложение еще в разработке, найдите файлdebug.keystore
- Для пользователей Windows:
C:\Users\USERNAME\.android\debug.keystore
- Для пользователей Linux или Mac OS:
~/.android/debug.keystore
- Для пользователей Windows:
- Откройте командную строку и перейдите в папку, в которой находится файл хранилища ключей.
- Выполните следующую команду:
// 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
]
]
- Отправьте SHA256 маркетологу.
Generating a SHA256 fingerprint while in production
The SHA256 fingerprint is generated in
- In Google Play console Find the public SHA256 fingerprint in Setup -> App signing (see image below)
- Отправьте SHA256 маркетологу.
Adding App Link intent-filter to main activity
- Получите автоматически сгенерированный код для фильтра намерений у маркетолога. Код фильтра намерений используется в файле AndroidManifest.XML.
- Откройте файл приложения
AndroidManifest.xml
file. - Добавьте фильтр намерений в основную активность.
Если в ней уже есть фильтр намерений для ссылки 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
- Сообщите маркетологу, что настройка App Link завершена.
При проверке ссылки маркетологом она должна вести пользователя на главную страницу приложения.
Процедура настройки схемы URI
Схема URI — это URL-адрес, который приводит пользователей прямо в мобильное приложение.
Когда пользователь приложения вводит схему URI в адресную строку браузера или переходит по ссылке на основе схемы URI, запускается приложение и пользователь перенаправляется по диплинку.
Если приложение не открывается по ссылке App Link, в качестве резервного варианта для открытия приложения можно использовать схему URI.
Deciding on a URI scheme
Чтобы определиться со схемой URI:
-
Contact the marketer.
-
Выберите схему URI. Например:
yourappname://
- Схема URI должна быть уникальной для вашего приложения и бренда, чтобы избежать случайных совпадений с другими приложениями в экосистеме. Совпадения с другими приложениями — характерная проблема для протокола со схемами URI.
- Схема URI не должна начинаться с http или https.
- Схема URI должна быть определена одинаковым образом для Android и iOS.
-
Отправьте схему URI маркетологу. Например:
afshopapp://mainactivity
Adding URI scheme intent-filter to the main activity
Чтобы добавить фильтр намерений для основной активности:
- Откройте файл приложения
AndroidManifest.xml
file. - Добавьте следующий фильтр намерений в основную активность.
В разделеdata
заменитеhost
andscheme
на выбранную вами схему URI. В коде фильтра намерений ниже,host="mainactivity"
andscheme="afshopapp"
, что соответствует схеме URIafshopapp://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
- Предоставьте схему URI маркетологу.
Testing URI schemes
Необходимые условия:
Устройство Android с установленным приложением. Убедитесь, что это те источник приложения и версия, в которые вы внесли изменения и внедрили App Links и/или схему URI.
Чтобы протестировать схему URI:
- Свяжитесь с маркетологом и получите созданную им настраиваемую ссылку.
- Отправьте короткий или длинный URL-адрес, полученные от маркетолога, на свой телефон. Вы можете:
- Сканировать QR-код с помощью камеры на телефоне или приложения для сканирования.
- Переслать себе ссылку по электронной почте или WhatsApp и открыть ее на телефоне.
- Нажмите на ссылку на мобильном устройстве.
Должна открыться главная страница приложения.
Изменения сохранены 8 месяцев назад