Начальная настройка для 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" />
<!-- Replace "onlink-basic-app" with your OneLink domain -->
<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 завершена.
При проверке ссылки маркетологом она должна вести пользователя на главную страницу приложения.
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>
Процедура настройки схемы 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 и открыть ее на телефоне.
- Нажмите на ссылку на мобильном устройстве.
Должна открыться главная страница приложения.
Изменения сохранены 2 месяца назад