Начальная настройка для iOS
Краткий обзор. При начальной настройке приложения маркетолог может создать ссылки, по которым имеющиеся пользователи будут направляться прямо в приложение. Начальная настройка также является необходимым условием для диплинкинга и отложенного диплинкинга.
Методы открытия приложения
Есть два метода открытия приложений, которые необходимо реализовать для полного охвата базы пользователей. Применение этих методов зависит от мобильной платформы и ее версии.
Два метода и инструкции по внедрению подробно описаны в следующих разделах.
Метод | Описание | Версии iOS | Процедура |
---|---|---|---|
Универсальные ссылки | Открывают мобильное приложение непосредственно на странице события, установленной по умолчанию. Универсальные ссылки имеют формат обычных ссылок на сайты (например, https://yourbrand.onelink.me or https://www.yourbrand.com) | iOS 9 и последующие версии | |
Схема URI | Открывает приложение напрямую на основе пути к активности, указанного в схеме URI. | Все версии iOS |
Процедура настройки универсальных ссылок iOS
Getting the app bundle ID and prefix ID
- Войдите в аккаунт Apple Developer.
- В меню слева выберите пункт Certificates, Identifiers & Profiles (Сертификаты, идентификаторы и профили).
- В разделе Identifiers (Идентификаторы), выберите App IDs (Идентификаторы приложений).
- Выберите соответствующее приложение.
- Скопируйте префикс идентификатора и идентификатор пакета приложения.
- Передайте префикс идентификатора и идентификатор пакета приложения маркетологу.
Они ему потребуются для регистрации приложения на дэшборде AppsFlyer.
Enabling associated domains
Чтобы реализовать поддержку связанных доменов в приложении:
Следуйте инструкциям iOS доменов, связанных с аккаунтом.
Configuring mobile apps to register approved domains
Настройка мобильных приложений для регистрации утвержденных приложений выполняется в Xcode. Вам потребуется поддомен OneLink, который сгенерирует маркетолог.
Чтобы настроить мобильные приложения для регистрации утвержденных доменов:
- Получите поддомен OneLink у маркетолога.
- Выберите свой проект в Xcode.
- Нажмите на цель проекта (см. снимок экрана ниже).
- Перейдите на вкладку Capabilities (Возможности).
- Включите параметр Associated Domain (Связанный домен).
- Укажите поддомен, полученный от маркетолога.
Формат:applinks:subdomain.onelink.me
.
Чтобы связать домен с приложением, необходимо иметь файл связанного домена на вашем домене и соответствующие разрешения в приложении. Когда ссылка OneLink создана, в AppsFlyer размещается файл
apple-app-site-association file
.
When a user installs your app, the system attempts to download the associated domain file and verify the domains in yourAssociated Domains Entitlement
.
Universal Link limitations
Открытие приложений из браузеров
Универсальные ссылки работают только при нажатии. Например, это происходит при нажатии ссылки на веб-странице или в электронном сообщении. При вставке ссылки в адресную строку браузера диплинк в приложение не происходит.
Субдомен OneLink
Поддомен ссылки OneLink можно изменить в любое время, однако это приведет к тому, что все имеющиеся URL-адреса ссылки OneLink, в которых используется первоначальный поддомен, перестанут действовать.
OneLink и приложения социальных сетей
Не все приложения, в том числе приложения социальных сетей, полностью поддерживают универсальные ссылки. Подробные сведения см. в этом руководстве.
Другие ограничения и проблемы
С универсальными ссылками могут быть связаны и другие ограничения. Подробные сведения см. в разделе по поиску и устранению неисправностей OneLink.
Процедура настройки схемы URI
Схема URI — это URL-адрес, который приводит пользователей прямо в мобильное приложение.
Когда пользователь приложения вводит схему URI в адресную строку браузера или переходит по ссылке на основе схемы URI, запускается приложение, и пользователь перенаправляется по диплинку.
Если приложение не открывается по универсальной ссылке, в качестве резервного варианта для открытия приложения можно использовать схему 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
Чтобы добавить схему URI:
- Откройте файл plist с информацией о приложении в Xcode.
- Добавьте запись URL types (Типы URL-адресов).
- Раскройте строки URL type (Тип URL-адреса) и Item 0 (Элемент 0).
- Добавьте в качестве значения идентификатора URL уникальный идентификатор приложения.
Желательно задать такой уникальный идентификатор, который скорее всего не будет использоваться другими приложениями. - Правой кнопкой мыши щелкните поле URL identifier (Идентификатор URL-адреса) и выберите Add Row (Добавить строку) > URI Schemes (Схемы URI).
- Задайте значение параметра Item 0 (Элемент 0) для своей уникальной схемы.
Prerequisites:
Устройство iOS с установленным приложением. Убедитесь, что это те источник приложения и версия, в которые вы внесли изменения и внедрили универсальные ссылки и схемы URI.
Testing the URI scheme:
- Свяжитесь с маркетологом и получите созданную им настраиваемую ссылку.
- Отправьте короткий или длинный URL-адрес, полученные от маркетолога, на свой телефон. Вы можете:
- Сканировать QR-код с помощью камеры на телефоне или приложения для сканирования.
- Переслать себе ссылку по электронной почте или WhatsApp и открыть ее на телефоне.
- Нажмите ссылку на мобильном устройстве. Должна открыться главная страница приложения.
Если ссылка не открывает приложение, добавьте параметр af_force_deeplink=true
в индивидуально настраиваемую ссылку атрибуции. Например:
https://demo.onelink.me/1aBC/123ab45c?af_force_deeplink=true
URI scheme limitations
Ни Apple, ни Google не требуют, чтобы у схем приложений были уникальные имена. Чтобы избежать конфликтов между схемами разных приложений, выбирайте для схем уникальные имена, имеющие отношение к вашему бренду. Хорошим именем схемы может быть идентификатор пакета приложения, например com.company.app.
Чтобы OneLink можно было использовать и для iOS, и для Android, нужно задать для обеих платформ одинаковую схему.
Когда ссылка OneLink, в которой есть параметр af_force_deeplink=true
, открывается в iOS 12.3.1, выполняется следующая процедура:
- Открывается диалоговое окно с вопросом пользователю, установлено ли приложение.
- Если пользователь выбирает «OK» (приложение установлено), AppsFlyer делает попытку открыть приложение, используя схему URI.
- Если пользователь выбирает «Отмена» (приложение не установлено), AppsFlyer перенаправляет пользователя в магазин приложений.
- Если пользователь выбирает «ОК», но приложение не установлено, отображается сообщение об ошибке:
Изменения сохранены 3 месяца назад