Руководство по интеграции Apple App Clips

Краткий обзор. Мини-приложения App Clips позволяют пользователям iOS 14 или более поздней версии быстро получить доступ к вашему приложению и ознакомиться с ним. AppsFlyer обеспечивает атрибуцию App Clip и при необходимости перенаправляет пользователей, которые не могут использовать App Clip (например, пользователей Android).

app_clip_flow_3.png

Интеграция App Clip

  • Мини-приложения App Clips предоставляют пользователям iOS 14 быстрый и удобный доступ к приложениям без необходимости загружать их целиком.
  • App Clips устанавливаются и запускаются с помощью их инициирования (например, QR-кода или NFC-метки). Примечание. Смарт-баннеры и ссылки в сообщениях в Safari не поддерживаются. 
  • AppsFlyer SDK необходим для атрибуции кликов, установок, событий в приложении App Clip и установок App Clip в полные приложения.
  • Независимо от SDK, OneLink перенаправляет пользователей по мере необходимости:
    • Пользователи без установленного приложения:
      • С iOS 14 или более поздней версией перенаправляются в App Clip.
      • С iOS 13 или более ранней версией, или Android, перенаправляются на основе ваших настроек в OneLink (в магазин приложений и т.д.).
    • Пользователи, у которых установлено приложение, переходят к нему в соответствии с настройками Universal Link или App Link в OneLink.

Факторы, которые необходимо учитывать

  • Размер App Clip может достигать 10 МБ. AppsFlyer SDK занимает ~1,5 МБ. 
  • Рекламные идентификаторы отсутствуют.
  • App Clip удаляются ОС автоматически после 30-дневного периода бездействия.

 Пример

Марк — маркетолог сети кофеен. Он поручает своему iOS-разработчику создать мини-приложение App Clip, которое позволит покупателям миновать очередь и сделать заказ за считанные секунды. Они просто идентифицируют себя с помощью Apple Sign-in, заказывают кофе и расплачиваются с помощью Apple Pay. Разработчик добавляет AppsFlyer SDK и проверяет, что он работает как в приложении, так и в мини-приложении.

Марк создает OneLink и размещает QR-код в кофейне вместе со слоганом "Покупайте без очереди!". 

Клиенты сканируют QR-код и:

  • Если у них есть устройство с iOS 14 или более поздней версией, откроется приложение App Clip с нужным филиалом кофейни и купоном на скидку.
  • Если у них уже установлено полное приложение, оно откроется на странице заказа кофе.
  • Если у них нет приложения и есть устройство с iOS 13 или более ранней версией или Android, откроется страница магазина приложений для приложения кофейни.

Марк использует дэшборд и отчеты AppsFlyer, чтобы посмотреть, сколько кликов и установок получает App Clip и сколько пользователей в итоге скачивают полное приложение.

Показатели и отчетность

Аналитические и сырые данные App Clips доступны на платформе на основе действий пользователей, описанных в следующей таблице.

Действия пользователя Событие AppsFlyer Обзорный дэшборд и аналитические инструменты Сырые данные
Инициирование (пример: QR-код) Нет события Нет события Нет события
Нажимает на карточку приложения и открывается App Clip

Клик и установка атрибутированы к источнику инициирования

  • Клики
  • Установки
app_type=app_clip
Использует App Clip
  • [Необязательно] Разработчик отправляет событие в приложении
  • После первого запуска App Clip последующие запуски учитываются как сессии.
  • Внутреннее событие приложения
  • Сеанс
  • Событие в приложении, отправленное разработчиком
  • app_type=app_clip
Загрузка и запуск полного приложения Внутреннее событие приложения Имя события в приложении = af_app_clip_to_full_app
  • Имя события в приложении = af_app_clip_to_full_app
  • app_type=full_app
Постоянное использование полного приложения [Необязательно] Разработчик отправляет событие в приложении Внутреннее событие приложения
  • Событие в приложении, отправленное разработчиком
  • app_type=full_app

Дэшборд когорт

Просматривайте показатели App Clip на дэшборде когорт, где вы можете: 

  • Узнать, сколько времени требуется пользователям, чтобы перейти из App Clip к установке полного приложения.
  • Использовать метрику конверсий в приложении, чтобы сравнить эффективность различных кампаний по инициированию мини-приложений.

Реализация App Clip

Ниже подробно описано, что нужно сделать вам и разработчику iOS для разработки и интеграции App Clips.

Объем работ

Кто задействован

  • Рекламодатель: 
    • Настраивает Apple App Clips в шаблонах OneLink.
    • Размещает ссылки OneLink на портале Apple App Store Connect.
    • Просматривает показатели на дэшборде и в отчетах AppsFlyer.
  • Разработчик iOS:
    • Создает App Clip
    • Интегрирует AppsFlyer SDK в App Clip.

Необходимые условия

  • Аккаунт AppsFlyer с хотя бы одним приложением.
  • Шаблон OneLink с универсальными ссылками и настройка ссылок OneLink для направления пользователей вашего полного приложения.
    Рекомендация: Инициирование (запуск) шаблона и ссылки, которые вы используете для App Clip, отправляют всех пользователей, не имеющих вашего полного приложения, в App Clip. Поэтому рассмотрите возможность создания отдельного шаблона и настраиваемой ссылки для случаев, когда вы хотите отправить пользователей в App Store, а не в App Clip.

Разработка App Clip

Полные инструкции по созданию App Clip для вашего приложения вы найдете в руководстве по Apple App Clip для разработчиков.

Упрощенный пример приложения, демонстрирующий использование App Clips и его интеграцию с полноценным приложением, приведен в руководстве AppsFlyer по App Clip.

Интеграция SDK

  • SDK необходим для атрибуции в AppsFlyer кликов, установок, событий в приложении App Clip и установок App Clip в полное приложение.
  • OneLink перенаправляет пользователей независимо от интеграции SDK.

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

Отправьте следующие ссылки своему разработчику iOS и попросите его следовать инструкциям:

Конфигурация OneLink

Необходимые условия:

  • Шаблон OneLink для вашего полного приложения с настроенными универсальными ссылками iOS.
  • Ссылка OneLink.
  • Рекомендация: Инициирование (запуск) шаблона и ссылки, которые вы используете для App Clip, отправляют всех пользователей, не имеющих вашего полного приложения, в App Clip. Поэтому рассмотрите возможность создания отдельного шаблона и настраиваемой ссылки для случаев, когда вы хотите отправить пользователей в App Store, а не в App Clip.

Чтобы настроить шаблон OneLink для вашего App Clip:

  1. На дэшборде AppsFlyer перейдите в раздел Вовлечение > Управление OneLink.
  2. Выберите шаблон OneLink, который вы используете для перенаправления пользователей в ваше полное приложение. 
  3. Убедитесь, что в шаблоне OneLink настроены универсальные ссылки. (См. инструкции по добавлению универсальных ссылок).
  4. Нажмите Сохранить.
    Файл AASA обновится для поддержки App Clip.
  5. На дэшборде AppsFlyer перейдите в раздел Вовлечение > Управление OneLink.
  6. Выберите настраиваемую ссылку OneLink, основанную на шаблоне, который вы настроили в шагах 1-4 и используемую для направления пользователей в App Clip.
  7. Убедитесь, что указан медиа-источник (pid).
    Медиа-источник должен быть указан в URL (например: pid=chartboost_int) или содержаться внутри ссылки.

Чтобы проверить, что App Clips включены в AppsFlyer OneLink:

  1. Создайте URL-адрес для получения файла ассоциации. URL создается с помощью добавления /.well-known/apple-app-site-association к домену шаблона OneLink. 
    Например, coffee.onelink.me/.well-known/apple-app-site-association.
  2. Перейдите по URL-адресу файла ассоциации.
    Файл apple-app-site-association загрузится автоматически.
  3. Откройте файл apple-app-site-association с помощью текстового редактора (например, Notepad).
  4. Убедитесь, что файл содержит слово "appclips" и что идентификатор пакета заканчивается на ".Clip". Например:
    "appclips": {
        "apps": [
          "ABCD1234.id.your.app.Clip",
          ...
        ]
    ...
    }
    Если это так, значит, вы успешно настроили App Clips на стороне AppsFlyer, и App Clip будет реализован в любом шаблоне OneLink с тем же поддоменом.

Настройка App Store Connect

Необходимые условия: Завершение настройки шаблона OneLink для App Clips

Чтобы настроить App Clip для работы с OneLink

  1. На странице вашего приложения в App Store Connect перейдите в раздел Build > Domain Status.
  2. Убедитесь, что ваш домен OneLink отображается в разделе Build domains, а статус Cache и статус Debug оба "validated".
  3. На дэшборде AppsFlyer перейдите в раздел Вовлечение > Управление OneLink.
  4. Наведите курсор на значок Действия ссылки, которую вы хотите использовать, и нажмите Получить URL
  5. Запишите короткий URL-адрес (или префикс длинного URL-адреса). 
  6. На странице вашего приложения в App Store Connect перейдите в раздел App Clip > Edit Advanced Experiences > +Add > Next.
  7. В поле App Clip Experience URL вставьте пользовательский URL OneLink, который вы записали в шаге 5.
    Примечание. Вы можете добавлять параметры запроса после основного пользовательского URL, но не можете изменять путь.
  8. Нажмите Далее.
    Теперь ваше мини-приложение App Clip настроено для работы с OneLink. Дополнительные инструкции по настройке App Store Connect можно найти в руководстве для разработчиков Apple.

Тестирование

Необходимые условия: Зарегистрированное тестовое устройство с iOS 14 без установленного полного приложения.

Чтобы проверить интеграцию OneLink и App Clip:

  1. На дэшборде AppsFlyer перейдите в раздел Вовлечение > Управление OneLink.
  2. Наведите курсор на значок Действия для ссылки, которую вы хотите протестировать, и нажмите Получить URL-адрес
  3. Отсканируйте QR-код с помощью своего устройства.
    На устройстве отобразится карточка App Clip, указывающая на то, что интеграция OneLink и App Clip настроена правильно.

Ограничения и особенности

Ограничения и особенности

Особенность/ограничение Описание
Методы запуска
  • Поддерживаются QR-коды и метки NFC.
  • Смарт-баннеры и ссылки в сообщениях в Safari не поддерживаются. 
SKAdNetwork

Функциональность SKAdNetwork недоступна. Поэтому установки App Clip отображаются на дэшборде SKAdNetwork как органические.

Универсальные ссылки OneLink

Для одной настраиваемой ссылки OneLink разрешено только одно расширенное использование App Clip. Это означает, что вы не можете добавить дополнительные пути к OneLink в App Store Connect.

Protect360

Protect360 не поддерживает App Clips.