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

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

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

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

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

МетодОписаниеВерсии iOSПроцедура
Универсальные ссылкиОткрывают мобильное приложение непосредственно на странице события, установленной по умолчанию. Универсальные ссылки имеют формат обычных ссылок на сайты (например, https://yourbrand.onelink.me or https://www.yourbrand.com)iOS 9 и последующие версии
  1. Получите идентификатор пакета приложения и префикс идентификатора.
  2. Включите связанные домены.
Схема URIОткрывает приложение напрямую на основе пути к активности, указанного в схеме URI.Все версии iOS
  1. Определите схему URI вместе с маркетологом.
  2. Включите связанные домены.
  3. Тестирование

Процедура настройки универсальных ссылок iOS

Getting the app bundle ID and prefix ID

  1. Войдите в аккаунт Apple Developer.
  2. В меню слева выберите пункт Certificates, Identifiers & Profiles (Сертификаты, идентификаторы и профили).
  3. В разделе Identifiers (Идентификаторы), выберите App IDs (Идентификаторы приложений).
  4. Выберите соответствующее приложение.
  5. Скопируйте префикс идентификатора и идентификатор пакета приложения.
  6. Передайте префикс идентификатора и идентификатор пакета приложения маркетологу.
    Они ему потребуются для регистрации приложения на дэшборде AppsFlyer.
    certs_apple_info!

Enabling associated domains

Чтобы реализовать поддержку связанных доменов в приложении:

Следуйте инструкциям iOS доменов, связанных с аккаунтом.

Configuring mobile apps to register approved domains

Настройка мобильных приложений для регистрации утвержденных приложений выполняется в Xcode. Вам потребуется поддомен OneLink, который сгенерирует маркетолог.

Чтобы настроить мобильные приложения для регистрации утвержденных доменов:

  1. Получите поддомен OneLink у маркетолога.
  2. Выберите свой проект в Xcode.
  3. Нажмите на цель проекта (см. снимок экрана ниже).
  4. Перейдите на вкладку Capabilities (Возможности).
  5. Включите параметр Associated Domain (Связанный домен).
  6. Укажите поддомен, полученный от маркетолога.
    Формат: applinks:subdomain.onelink.me.

xcode-associated-domains!

📘

To associate a domain with your app, you need to have the associated domain file on your domain and the appropriate entitlement in your app. Once the redirection logic for existing app users is added to the OneLink template configuration, AppsFlyer hosts the 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 your Associated Domains Entitlement.

Universal Link limitations

Открытие приложений из браузеров

Универсальные ссылки работают только при нажатии. Например, это происходит при нажатии ссылки на веб-странице или в электронном сообщении. При вставке ссылки в адресную строку браузера диплинк в приложение не происходит.

Субдомен OneLink

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

OneLink и приложения социальных сетей

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

Другие ограничения и проблемы

С универсальными ссылками могут быть связаны и другие ограничения. Подробные сведения см. в разделе по поиску и устранению неисправностей OneLink.

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

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

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

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

Deciding on a URI scheme

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

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

📘

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

Adding URI scheme

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

  1. Откройте файл plist с информацией о приложении в Xcode.
  2. Добавьте запись URL types (Типы URL-адресов).
  3. Раскройте строки URL type (Тип URL-адреса) и Item 0 (Элемент 0).
  4. Добавьте в качестве значения идентификатора URL уникальный идентификатор приложения.
    Желательно задать такой уникальный идентификатор, который скорее всего не будет использоваться другими приложениями.
  5. Правой кнопкой мыши щелкните поле URL identifier (Идентификатор URL-адреса) и выберите Add Row (Добавить строку) > URI Schemes (Схемы URI).
  6. Задайте значение параметра Item 0 (Элемент 0) для своей уникальной схемы.

info_list_uri_schemes!

Prerequisites:

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

Testing the URI scheme:

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

Если ссылка не открывает приложение, добавьте параметр 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 перенаправляет пользователя в магазин приложений.
    • Если пользователь выбирает «ОК», но приложение не установлено, отображается сообщение об ошибке:

uri_cannot_open_page!