Тестирование интеграции SDK для маркетологов

Краткий обзор. Протестируйте интеграцию вашего приложения для Android или iOS с AppsFlyer. 

Материал по теме для рекламных сетей: Тестирование интеграции рекламных сетей.

Обзор

Тщательно протестированная интеграция обеспечивает точный и полный сбор данных. Тестируя интеграцию SDK, вы можете проверить, успешно ли SDK взаимодействует с серверами AppsFlyer, а также корректно ли атрибутируются установки, внутренние события приложения и ретаргетинг. 

Когда интеграция SDK завершена, любой член команды с доступом к дэшборду AppsFlyer может провести базовое тестирование. Разработчики могут использовать журналы отладки в среде разработки.

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

Методы тестирования

В следующих разделах описываются различные тесты и доступные методы.

Тестирование с дэшборда

Чтобы протестировать интеграцию SDK с дэшборда, сначала нужно зарегистрировать тестовое устройство (Android или iOS). Благодаря этому вы сможете использовать одно и тоже устройство несколько раз, и установки не будут регистрироваться как повторные установки.  

Выполните следующее:

  • Тестирование органических установок.
  • Тестирование базовых функций интеграции (неорганические установки, внутренние события приложения и ретаргетинг).
    Доступные методы:
    • Страница тестирования интеграции SDK: мастер на дэшборде AppsFlyer с подробными инструкциями по процессу выполнения каждого теста.
    • Тесты с использованием ссылок атрибуции: все рекламные сети без самостоятельной атрибуции (не SRN) и собственные медиа-источники используют ссылки атрибуции AppsFlyer; поэтому рекомендуется проводить тесты с использованием ссылок атрибуции. Вы создаете ссылки атрибуции, а затем проводите тесты, чтобы проверить, правильно ли SDK атрибутирует неорганические установки и внутренние события приложения медиа-источникам. Кроме того, следует проводить тесты для проверки, правильно ли ретаргетинг (реатрибуция и повторное вовлечение) регистрируется и атрибутируется медиа-источникам.

Примечание по тестированию на iOS 14+

Начиная с iOS 14.5, идентификатор IDFA доступен только в том случае, если пользователь дает согласие на App Tracking Transparency (ATT). Если в вашем приложении реализован ATT-запрос, вы можете проводить тесты как пользователь, давший или не давший согласие.  Дополнительную информацию см. в руководстве по регистрации тестового устройства с помощью IDFA или IDFV.

Тестирование в среде разработки

Разработчик может сделать следующее:

  • Включить и проверить журналы отладки и протестировать сценарии, такие как проверка покупки, данные о конверсиях и диплинкинг.

     Примечание

    Если ваш разработчик получает в журналах ответ 403, это может быть связано с тем, что у вас тарифный план Zero. Он включает только данные по кликам и показам и не содержит данные атрибуции. Для получения подробной информации о тарифных планах свяжитесь с нашей командой по работе с клиентами по адресу hello@appsflyer.com или посетите страницу с ценами на сайте AppsFlyer.

  • Создать приложение для отладки, чтобы протестировать интеграцию SDK. При выполнении тестов данные регистрируются и отображаются на дэшборде. Записанные данные нельзя удалить. Если добавление тестовых данных к работающему приложению нежелательно, вы можете попросить разработчика выполнить тестирование интеграции SDK с помощью отладочных приложений. Отладочное приложение отличается от работающего тем, что у него другой идентификатор приложения AppsFlyer, свой дэшборд и оно не опубликовано в магазинах приложений.

Добавление отладочных приложений на дэшборд

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

Чтобы добавить отладочное приложение, выполните одну из следующих процедур:

Отладочные приложения Android Отладочные приложения iOS

Чтобы добавить отладочное приложение на дэшборд:

  1. Узнайте название пакета отладочного приложения у разработчика и добавьте приложение на дэшборд AppsFlyer.
  2. Задайте для приложения один из следующих статусов:
    • Ожидает подтверждения
    • Не опубликовано

Специальные тестовые случаи

К специальным тестовым случаям относятся следующие:

  • Android TV: SDK совместим со смарт-ТВ на основе Android. Маркетолог или любой член команды может тестировать приложения для таких ТВ, следуя инструкциям из этой статьи.
  • Apple TV (tvOS): SDK совместим с устройствами Apple TV (tvOS). Маркетолог или любой член команды может тестировать приложения для таких ТВ, следуя инструкциям из этой статьи.
  • Неопубликованные приложения для tvOS: требуется взаимодействие маркетолога и разработчика (см. Тестирование интеграции tvOS перед публикацией).
  • Amazon Fire TV: маркетолог может выполнить тесты с дэшборда (см. Тестирование для альтернативных магазинов Android).
  • Веб-события PBA: требуется взаимодействие маркетолога и разработчика (см. Тестирование интеграции веб-SDK PBA).

Тестирование базовой функциональности SDK

В следующем разделе описаны процедуры тестирования базовой интеграции SDK.

Тестирование органических установок

Рекомендуем начать с тестирования органической установки.

Чтобы протестировать органическую установку:

  1. Установите приложение на зарегистрированном тестовом устройстве.
  2. Запустите приложение.

На дэшборде приложения отобразится новая органическая установка. Данные об установке должны появиться в течение 30 минут.

Test_SDK_Organic_install

Тестирование на странице «Тесты интеграции SDK»

Используйте страницу «Тесты интеграции SDK» для тестирования неорганических установок, внутренних событий приложения и диплинкинга (ретаргетинг) и выявления проблем с интеграцией в проекте при их наличии.

Прежде чем начать:

  1. Подготовьте устройство (Android или iOS), на котором не установлено приложение. При необходимости удалите приложение с устройства.
  2. Зарегистрируйте устройство как тестовое.

Шаг 1. Тестирование неорганических установок

  1. Выберите приложение на дэшборде.
  2. Перейдите на вкладку Интеграция > Тесты интеграции SDK. 
    Откроется страница «Тесты интеграции SDK». 
  3. Проведите тест неорганической установки.
  4. Выберите тестовое устройство из списка. 
  5. Выберите магазин, из которого будет установлено приложение:
    • Для Android: 
      • Google Play
      • Другое (например, внемагазинное, Android Studio, файл APK) 
    • Для iOS:
      • App Store
      • Другое (например, XCode, TestFlight)
  6. Отсканируйте QR-код с помощью зарегистрированного тестового устройства и следуйте инструкциям, которые будут отображаться на устройстве.
  7. Если вы выбрали Другое, установите приложение из своей среды разработки.
  8. Дождитесь регистрации неорганической установки на странице Тесты интеграции SDK — это означает, что тест прошел успешно. Это может занять около 2 минут.

    NonOrganic_install

    Если по приложению не регистрируется неорганическая установка, возможной причиной этого может быть следующее:
    • Вы выполнили тест на устройстве iOS 14+, не зарегистрированном с помощью IDFA.
    • Зарегистрирована органическая установка.
    • Протестирована версия приложения без SDK.

В случае ошибок интеграции обратитесь к разработчику.

Шаг 2. Тестирование внутренних событий приложения

Прежде чем начать:

  • Используйте то же тестовое устройство, которое применялось для регистрации неорганической установки.
  1. Проведите тест внутренних событий.
  2. Выберите тестовое устройство из списка и нажмите Next (Далее). 
  3. Запустите свое приложение и начните создавать в нем внутренние события.
  4. Вы увидите журнал этих событий, поскольку они регистрируются в режиме реального времени.

    Test_SDK_Integration_Inapp_events

Шаг 3. Тестирование диплинков (ретаргетинг)

Прежде чем начать:

  • Используйте то же тестовое устройство, которое применялось для регистрации неорганической установки. 
  • Запустите тестовое приложение не менее трех раз.
  • Чтобы тестировать диплинкинг (ретаргетинг), для приложения должна быть определена ссылка OneLink. Дополнительные сведения см. в руководстве по настройке OneLink
  • Убедитесь, что ретаргетинг включен.
  1. Проведите тест диплинкинга.
  2. Выберите тестовое устройство из списка.
  3. Выберите тип теста:
    • OneLink: выберите ссылку OneLink. 
    • Схема URI: укажите схему URI (например, greatapps://cars).
  4. Нажмите Далее.
  5. Отсканируйте QR-код с помощью зарегистрированного тестового устройства и следуйте инструкциям, которые будут отображаться на вашем устройстве. По завершении тестирования тест диплинкинга регистрируется как успешный.

    TestSDK_DeepLinks_en-us.png

Тестирование с помощью ссылок атрибуции

В следующем разделе описаны процедуры тестирования установок с помощью ссылок атрибуции. Эти тесты можно проводить, даже если приложение все еще находится на рассмотрении (т. е. еще не опубликовано в Google Play или Apple App Store).

Тестирование атрибуции установок

Тестирование установок позволяет выяснить, верно ли SDK AppsFlyer атрибутирует установки различным медиа-источникам.

Чтобы протестировать атрибуцию установок:

  1. Скопируйте ссылку (для Android или iOS) и внесите следующие изменения:
    1. Значение app_id: укажите идентификатор своего приложения в AppsFlyer. 
    2. Параметр pid: укажите имя медиа-источника, которому атрибутирована установка.
    3. Параметр c: укажите название кампании.
    4. Если вы тестируете приложение из стороннего магазина Android: добавьте параметр af_r к ссылке атрибуции. 
    5. Вместо GAID, IDFA или IDFV укажите идентификатор своего устройства.
    Android iOS
    https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

    Далее приведены примеры ссылок атрибуции со значениями:

    Android iOS

    https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*
  2. Скопируйте обновленную ссылку, отправьте ее на тестовое устройство и затем перейдите по ней.

     Примечание

    В iOS для отправки ссылки на устройство воспользуйтесь iMessage или электронной почтой. Не вставляйте ссылку в приложение заметок iOS Notes, чтобы затем перейти по ней. Иначе ссылка может не работать.

  3. Произведите одно из следующих действий:
    • Если приложение опубликовано, перейдите к установке.
    • Если приложение находится на рассмотрении, отображается следующее сообщение: «Приложение, которое вы ищете, еще не доступно в магазине приложений». Это ожидаемый результат. Поскольку приложение не опубликовано, ссылка атрибуции не ведет на магазин приложений. При этом она действительна для атрибуции и должна устанавливать приложение следующим образом:
      • Для Android: из Android Studio или файла APK.
      • Для iOS: из TestFlight.

    Установка, атрибутированная тестовой кампании, должна появиться в данных медиа-источника Test. Данные об установке обычно отображаются на дэшборде приложения в течение 30 минут. Test_Install_Attribution_Link

Совет. Рекомендуем скачать отчет с сырыми данными по установкам, чтобы проверить правильно ли атрибутирована установка. Скачивание отчета занимает несколько минут.

Чтобы скачать отчет:

  1. На дэшборде перейдите в Reports (Отчеты) > Export Data (Экспорт данных). 
  2. В разделе Raw Data Reports (Отчеты с сырыми данными) загрузите отчет Installation (Установки).

Тестирование атрибуции внутренних событий

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

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

  1. Запустите приложение и создайте в нем несколько внутренних событий.
  2. Откройте дэшборд приложения и выберите Events (События).

    Здесь должны быть видны события, доход от них (если с ними связан доход) и медиа-источник, с которым они связаны. Данные о событиях появляются на дэшборде в течение 60–70 минут.

    Testing_InAppEvents_Attribution

Совет. Рекомендуем скачать отчет с сырыми данными по внутренним событиям приложения, чтобы проверить правильно ли атрибутированы события. Скачивание отчета занимает несколько минут.

Чтобы скачать отчет:

  1. На дэшборде перейдите в Reports (Отчеты) > Export Data (Экспорт данных).
  2. В разделе Raw Data Reports (Отчеты с сырыми данными) скачайте отчет по внутренним событиям.

Тестирование ссылок OneLink

OneLink позволяет настроить единую ссылку атрибуции для Android и iOS. OneLink распознает устройства пользователей и перенаправляет их в соответствующий магазин приложений.

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

Подробные сведения см в нашем руководстве по тестированию URL-адресов ссылок OneLink.

Тестирование ретаргетинга с помощью ссылок атрибуции

В следующих разделах описаны процедуры тестирования атрибуции ретаргетинга.

О тестах ретаргетинга

Атрибуция ретаргетинга происходит, когда в рамках ретаргетинговой кампании пользователь кликает по ссылке атрибуции ретаргетинга. В результате имеет место событие реатрибуции или повторного вовлечения. Дополнительные сведения см. в руководстве по атрибуции ретаргетинга.

Тесты ретаргетинга включают в себя следующее:

  • Для реатрибуции: удаление и повторная установка приложения. Проверка регистрации установки на дэшборде.
  • Для повторного вовлечения: переход по ссылке атрибуции ретаргетинга или диплинку и выяснение, корректно ли повторное вовлечение атрибутировано медиа-источнику.

Необходимые условия для проведения тестов ретаргетинга

Перед проведением тестов ретаргетинга необходимо задать следующие настройки:

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

Чтобы настроить тесты ретаргетинга:

  1. Включите ретаргетинг в настройках приложения.

    На дэшборде приложения нажмите App Settings (Настройки приложения) и активируйте переключатель Enable retargeting attribution (Включить атрибуцию ретаргетинга).

    Set_Reattribution_window

  2. Произведите одно из следующих действий: 
    • Создайте ссылку атрибуции для приложения. Не забудьте включить параметр ретаргетинга is_retargeting=true и рекламный идентификатор. Чтобы увидеть GAID, IDFA или IDFV, следуйте инструкциям по регистрации тестового устройства.  
      Далее приведен пример ссылки атрибуции, в которой в качестве идентификатора устройства указан параметр для Android (GAID). Дополнительные сведения о добавлении параметров идентификаторов устройств, таких как IDFA или IDFV, см. в статье Структура и параметры ссылки атрибуции

      https://app.appsflyer.com/<app_id>?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>
    • Получите настраиваемый длинный URL-адрес из шаблона OneLink. Обязательно активируйте Retargeting campaign (Ретаргетинговая кампания). На следующем скриншоте показан пример настраиваемого длинного URL-адреса:

      Testing_LongLink_en-us.png

Теперь можно переходить к тестированию реатрибуции и повторного вовлечения.

Тестирование реатрибуции

Прежде чем начать:

  • Следуйте инструкциям по настройке тестов ретаргетинга.
  • Убедитесь, что ваше тестовое устройство НЕ зарегистрировано.

Чтобы протестировать реатрибуцию:

  1. Удалите приложение с устройства. Если вы удалили приложение только что, подождите несколько минут.
  2. Скопируйте ранее созданную ссылку атрибуции: ссылку атрибуции конкретного приложения или настраиваемую длинную ссылку из шаблона OneLink, отправьте ее на тестовое устройство и затем перейдите по ней.

     Примечание

    В iOS для отправки ссылки на устройство воспользуйтесь iMessage или электронной почтой. Не вставляйте ссылку в приложение заметок iOS Notes, чтобы затем перейти по ней. Иначе ссылка может не работать.

  3. Произведите одно из следующих действий:
    • Если приложение опубликовано, перейдите к установке.
    • Если приложение находится на рассмотрении, установите его следующим образом:
      • Для Android: из Android Studio или файла APK.
      • Для iOS: из TestFlight.
  4. Откройте дэшборд приложения и выберите в меню слева пункт Retargeting (Ретаргетинг).

    Здесь установка должна быть атрибутирована медиа-источнику Test в кампании Test. Данные об установке, выполненной в результате ретаргетинга, появятся на дэшборде в течение 30 минут.

    Testing_Reattribution

Совет. Рекомендуем скачать отчет с сырыми данными по конверсиям, чтобы проверить корректно ли установка атрибутирована медиа-источнику. Скачивание отчета занимает несколько минут.

Чтобы скачать отчет:

  1. На дэшборде перейдите в Reports (Отчеты) > Export Data (Экспорт данных).
  2. В разделе Retargeting (Ретаргетинг) скачайте отчет Conversions (re-engagements & re-attributions) (Конверсии (повторное вовлечение и реатрибуция)).

Тестирование повторного вовлечения

Прежде чем начать:

  • Следуйте инструкциям по настройке тестов ретаргетинга. 
  • В целях тестирования в качестве минимального интервала между конверсиями укажите None (Нет). Так, во время тестирования будут регистрироваться и атрибутироваться все конверсии повторного вовлечения.

    Testing_Reattribution_window

  • Убедитесь, что приложение установлено на вашем тестовом устройстве и уже несколько раз было запущено. Если вы удалили приложение только что, подождите несколько минут.

Чтобы протестировать повторное вовлечение (прямой диплинкинг):

Убедитесь, что в приложении настроен диплинкинг, после чего выполните следующую процедуру тестирования.

Чтобы протестировать повторное вовлечение (непрямой диплинкинг):

  1. Скопируйте ранее созданную ссылку атрибуции: ссылку атрибуции для конкретного приложения или настраиваемую длинную ссылку из шаблона OneLink.
  2. Отправьте ссылку на тестовое устройство и перейдите по ней.
  3. Откройте приложение одним из следующих способов:
    • Нажмите Открыть в магазине приложений.
    • Запустите приложение со своего устройства.

    На дэшборде повторное вовлечение должно быть атрибутировано медиа-источнику Test в кампании Test. Данные о повторном вовлечении должны появиться в течение 30 минут. Testing_ReEngagement

Совет. Рекомендуем скачать отчет с сырыми данными по конверсиям, чтобы проверить корректно ли повторное вовлечение атрибутировано медиа-источнику. Скачивание отчета занимает несколько минут.

Чтобы скачать отчет:

  1. На дэшборде перейдите в Reports (Отчеты) > Export Data (Экспорт данных).
  2. В разделе Retargeting (Ретаргетинг) скачайте отчет Conversions (re-engagements & re-attributions) (Конверсии (повторное вовлечение и реатрибуция)).
Была ли эта статья полезной?