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

Live Event Viewer (просмотр событий в режиме реального времени) - это инструмент тестирования, отображающий в режиме реального времени данные, отправляемые из SDK в AppsFlyer, такие как события установки и другие события внутри приложения. Для каждого зафиксированного события вы можете просмотреть журнал событий и подробную информацию.

Для просмотра событий в Live Event Viewer:

1. В AppsFlyer в боковом меню выберите Настройки > Тестирование интеграции SDK.

   

2. Нажмите События в режиме реального времени.

   

3. В списке приложений выберите приложение, которое вы хотите протестировать.
4. В списке тестовых устройств выберите устройство, которое вы хотите использовать для тестирования своего приложения. Если у вас нет тестового устройства, вы можете зарегистрировать его, нажав на ссылку Добавить тестовое устройство.
5. Нажмите Продолжить, чтобы начать запись событий приложения.

6. Запустите приложение и используйте его, чтобы создавать сеансы и внутренние события приложения.

   

7. Щелкните элемент события, чтобы просмотреть сведения о событии на панели справа.
8. Если вы хотите остановить запись событий, нажмите Стоп. Нажмите кнопку Пуск еще раз, когда захотите продолжить.

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

1. В AppsFlyer в боковом меню выберите Настройки > Тестирование интеграции SDK. 

   

2. Нажмите Тестирование неорганических установок.

   

3. В списке приложений выберите приложение, которое вы хотите протестировать.
4. В списке тестовых устройств выберите устройство, которое вы хотите использовать для тестирования своего приложения. Если у вас нет тестового устройства, вы можете зарегистрировать его, нажав на ссылку Добавить тестовое устройство.
5. Если тестируемое приложение установлено на вашем тестовом устройстве, удалите его.
6. Установите флажок Я удалил приложение с тестируемого устройства.
7. Нажмите Продолжить и следуйте инструкциям мастера.

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

• IDFA доступен, но тестовое устройство не зарегистрировано с этим идентификатором на странице Тестовые устройства.
• На тестовом устройстве установлено несколько ваших приложений, помимо тестового, но тестовое устройство не зарегистрировано с этим IDFV на странице Тестовые устройства.
• Зарегистрирована органическая установка.
• Протестирована версия приложения без SDK.

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

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

• Запустите тестовое приложение не менее трех раз.
• Чтобы тестировать диплинкинг (ретаргетинг), для приложения должна быть определена ссылка OneLink. Дополнительные сведения см. в Руководстве по настройке OneLink. 
• Убедитесь, что ретаргетинг включен.

Для проверки диплинков:

1. В AppsFlyer в боковом меню выберите Настройки > Тестирование интеграции SDK.

   

2. Нажмите Ретаргетинг.

   

3. В списке приложений выберите приложение, которое вы хотите протестировать.
4. В списке тестовых устройств выберите устройство, которое вы хотите использовать для тестирования своего приложения. Если у вас нет тестового устройства, вы можете зарегистрировать его, нажав на ссылку Добавить тестовое устройство.
5. Нажмите Продолжить и следуйте инструкциям мастера.

Тестирование установок позволяет выяснить, верно ли 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>

   IDFA

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

   IDFV

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfv=<IDFV>

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

   Android iOS

   https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*

   https://app.appsflyer.com/id123456789?pid=Test&c=Test&idfa=1A2B****-9128-4***-123*-04E***654321

    Примечание:

   Если вы тестируете приложение для iOS, не зарегистрировав тестовое устройство, ваш тестовый клик может быть отмечен Fraud 360 как мошеннический.

   Чтобы данное событие не было распознано как фрод, добавьте в ссылку следующий параметр запроса: pid=”ios_testing”

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

    Примечание:

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

3. Выполните одно из следующих действий:

   • Если приложение опубликовано, перейдите к установке.
   • Если приложение находится на рассмотрении, отображается следующее сообщение: Приложение, которое вы ищете, пока не доступно на рынке.Это ожидаемый результат. Поскольку приложение неактивно, ссылка атрибуции не ведет ни в один магазин приложений. Тем не менее, ссылка атрибуции по-прежнему действительна для целей атрибуции, и вам следует установить приложение следующим образом:
     • Для Android: Из APK-файла (или Android Studio для разработчиков)
     • Для iOS: Из TestFlight (или Xcode для разработчиков)

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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-адреса:

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

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

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

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

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

    Примечание:

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

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

5. В поле Attribution type (Тип атрибуции) выберите Re-attributions (Реатрибуция).

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

   

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

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

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

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

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

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

3. Откройте приложение одним из следующих способов:

   • Нажмите Открыть в магазине приложений.
   • Запустите приложение со своего устройства.

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

   

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

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

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