Начальная настройка для 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!

📘

Чтобы связать домен с приложением, необходимо иметь файл связанного домена на вашем домене и соответствующие разрешения в приложении. Когда ссылка OneLink создана, в AppsFlyer размещается файл apple-app-site-association file. Проверить, верно ли настроены универсальные ссылки, можно с помощью [инструмента проверки ссылок AppsFlyer].(https://www.appsflyer.com/tools/link-validator/).
Когда пользователь устанавливает приложение, система пытается скачать файл связанного домена и проверить домены в вашем разрешении 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. Свяжитесь с маркетологом и разработчиком Android.
  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!