Тестирование интеграции 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» для тестирования неорганических установок, внутренних событий приложения и диплинкинга (ретаргетинг) и выявления проблем с интеграцией в проекте при их наличии.

Только для iOS: Страница тестирования интеграции SDK применима только для приложений iOS, реализующих ATT. Вы можете протестировать приложения, не реализующие АТТ, используя эту процедуру.

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

  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-код с помощью зарегистрированного тестового устройства и следуйте инструкциям, которые будут отображаться на устройстве.

    Обратите внимание, что для устройств Android в этом тесте используется метод install referrer, поэтому ссылка атрибуции не включает GAID.

  7. Если вы выбрали Другое, установите приложение из своей среды разработки.
  8. Дождитесь регистрации неорганической установки на странице Тесты интеграции SDK — это означает, что тест прошел успешно. Это может занять около 2 минут.

    NonOrganic_install

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

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

Шаг 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: из файла APK (или Android Studio для разработчиков)
      • Для iOS: из TestFlight (или Xcode для разработчиков)

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

 Совет

Альтернативные способы проверки результатов теста:

  • Если у вас есть доступ к отчетам с сырыми данными, скачайте отчет Installs (Установки). Скачивание отчета занимает несколько минут.

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

    1. На дэшборде перейдите в Reports (Отчеты) > Export Data (Экспорт данных). 
    2. Из списка User acquisition (non-organic) (Привлечение пользователей (неорганические)) выберите Installs (Установки) и скачайте отчет. 
  • Если у вас есть доступ к журналам отладки, вы можете получить результаты атрибуции по конкретной установке через API для тестирования интеграции SDK.

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

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

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

  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. Откройте дэшборд приложения и в поле View type (Тип представления) выберите Retargeting (Ретаргетинг).
  5. В поле Attribution type (Тип атрибуции) выберите Re-attributions (Реатрибуция).

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

    Testing_SDK_Reattribution

 Совет

Альтернативные способы проверки результатов теста:

  • Если у вас есть доступ к отчетам с сырыми данными, скачайте отчет Conversions (Конверсии). Скачивание отчета занимает несколько минут.

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

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

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

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

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

    Testing_Reattribution_window

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

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

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

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

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

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

    Testing_SDK_Re-engagement

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

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

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