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

Кратко: Проверьте интеграцию AppsFlyer для Android с помощью приложения AppsFlyer Partner Integrations, чтобы запускать постбэки.

Тестирование интеграции Android

Тестирование включает следующие элементы:

Используйте версию приложения AppsFlyer Partner Integrations для Android, чтобы генерировать тестовые установки и события purchase в приложении. Эти тесты, в свою очередь, запускают постбэки, отправляемые в ваши конечные точки. Вы также можете тестировать события login и registration в приложении.
После получения постбэков убедитесь, что вы можете их принимать.

Область тестирования

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

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

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

Выполните предварительные требования, а затем выполните тестовые процедуры в следующих разделах. Каждый раздел тестирования содержит таблицу, которую можно использовать для записи результатов тестирования.

Требования

Перед выполнением тестовой процедуры выполните предварительные требования.

Требования
Интегрируйте тестовое приложение Android в свою учетную запись.
Убедитесь, что тестовое приложение интегрировано в вашу учетную запись
Сопоставьте события в приложении с названиями ваших событий. Названия событий для сопоставления: `purchase`, `login`, `registration`
Подготовьте ссылку атрибуции
Протестируйте атрибуцию установки на устройстве под управлением Android
Протестируйте атрибуцию события в приложении на устройстве Android
Протестируйте атрибуцию ретаргетинга на устройстве Android

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

Чтобы запускать постбэки:

Отправьте ранее подготовленную ссылку атрибуции на тестовое устройство.
Нажмите на ссылку, выполните установку, а затем откройте приложение.
Отображается страница Install Data.
Проверьте атрибуцию по следующим параметрам. Если проверка не пройдена, см. раздел Устранение неполадок.
1. install_time: близко к текущему времени. Время указывается по UTC.
2. af_status: Non-organic Если это не так, установка не была атрибутирована.
3. media_source: ваша рекламная сеть
Нажмите In-App Event Tests.
Нажмите Purchase Event.
Отображается подтверждение события Purchase Event.
Проверьте, что:
1. Вы получили постбэки об установке и покупке.
2. Название события сопоставлено правильно (если вы настроили сопоставление событий в приложении).
3. Вы можете принять постбэк.

Дополнительная информация и процедуры

О тестовом приложении Partner Integrations

Приложение Partner Integrations доступно в Google Play. Приложение отправляет данные об установке и события в приложении на платформу AppsFlyer.

При первом открытии приложения страница Install Data отображает данные конверсии, зарегистрированные на платформе AppsFlyer. Тестовые события в приложении запускаются в пользовательском интерфейсе.

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

In-App Event Tests
Отправка событий в приложении purchase, login и registration. При сопоставлении названий событий в приложении с вашими названиями событий постбэки заполняются с использованием ваших названий событий.

Ссылка атрибуции

Подготовьте ссылку атрибуции в дэшборде AppsFlyer, используя один из следующих способов:

Сгенерируйте ссылку в дэшборде AppsFlyer.
Измените пример ссылки ниже.

Чтобы сгенерировать ссылку в дэшборде:

В AppsFlyer в верхнем меню выберите вкладку Мои приложения.
Выберите adNetworkTest.
В AppsFlyer в боковом меню выберите Сотрудничество > Активные интеграции > выберите свою рекламную сеть > вкладку Ссылка атрибуции.

На вкладке Attribution link задайте перечисленные параметры. При необходимости можно добавить дополнительные параметры. Ссылка на ссылку атрибуции

Параметр	Пример значения	Замечание
кампания;	c-test-2020-12-20	Задайте значение, которое можно идентифицировать в ваших постбэках
pid	pitestap

Скопируйте полученную ссылку для дальнейшего использования.

Пример ссылки атрибуции:


https://app.appsflyer.com/com.appsflyer.adNetworkTest?pid=pitestap_int&c=c-test-2020-12-20

Тестовое приложение, интегрированное в вашу учетную запись

Чтобы убедиться, что тестовое приложение доступно в вашей учетной записи:

В AppsFlyer в верхнем меню перейдите в раздел Мои приложения.
Убедитесь, что приложение Интеграция партнеров adNewtorkTest отображается в разделе Доступные приложения. Если это не так, обратитесь к своему Partner Development Manager.

Устранение неполадок

Симптом	Причина/корректирующее действие
Время установки не совпадает с текущим временем	Приложение не было удалено перед установкой. Удалите приложение и повторите процедуру.
Медиаисточник не совпадает с вашим медиаисточником	Убедитесь, что в ссылке атрибуции задано правильное значение pid. Убедитесь, что вы используете правильную ссылку атрибуции
af_status — органический	Проверьте формат ссылки атрибуции, особенно значение pid.

Симптом

Причина/корректирующее действие

Время установки не совпадает с текущим временем

Приложение не было удалено перед установкой.

Удалите приложение и повторите процедуру.

Медиаисточник не совпадает с вашим медиаисточником

Убедитесь, что в ссылке атрибуции задано правильное значение pid. Убедитесь, что вы используете правильную ссылку атрибуции

af_status — органический

Проверьте формат ссылки атрибуции, особенно значение pid.

Тест атрибуции ретаргетинга

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

Создайте новую ссылку атрибуции и добавьте в нее параметр is_retargeting=true.

https://app.appsflyer.com/com.appsflyer.adNetworkTest?pid=YOUR_PID&c=YOUR_CAMPAIGN&af_click_lookback=7d
          &clickid={clickid}&is_retargeting=true

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

Просмотр установок после ретаргетинга в дэшборде

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

Тест атрибуции по просмотрам

В AppsFlyer перейдите в My Apps.
Выберите adNetworkTest.
В AppsFlyer в боковом меню выберите Collaborate > Active Integrations > выберите свою рекламную сеть > вкладку Integration.
Убедитесь, что параметр Enable view-through attribution включен.
Скопируйте ссылку атрибуции показов.
```
https://impression.appsflyer.com/com.appsflyer.adNetworkTest?pid=YOUR_PID&c=YOUR_CAMPAIGN&af_viewthrough_lookback=24h&advertising_id=YOUR_GAID&af_siteid=YOUR_SITEID
```
Замените параметры следующим образом:
- YOUR_PID — ваш идентификатор ID партнера, предоставленный AppsFlyer (заканчивается на _int)
- YOUR_CAMPAIGN — любое название кампании
- YOUR_GAID — ваш Рекламный идентификатор Google
- YOUR_SITEID — любой идентификатор ID сайта
Примечание: параметры в ссылке — это базовые параметры, используемые здесь для тестирования. Вы можете добавить в ссылку атрибуции по просмотрам другие параметры в соответствии с вашими требованиями.
Отправьте ссылку атрибуции по просмотрам на тестовое устройство.
Откройте ссылку в браузере и установите приложение из магазина.
Запустите приложение.
Откроется следующая страница:

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

Совет.

Чтобы получить более детальные результаты, повторите процесс установки, используя ссылку атрибуции по просмотрам на новом тестовом устройстве. Удалите приложение, измените параметры в ссылке (название кампании, af_siteid и advertising_id), а затем снова установите его, нажав URL-адрес.

Просмотр установок в дэшборде

После установки и запуска приложения результаты можно увидеть на дэшборде AppsFlyer.

Подождите до 30 минут, пока установка не отобразится в дэшборде приложения.

Экспорт сырых данных

Данные, связанные с приложениями, установка которых атрибутирована вашей рекламной сети, можно экспортировать в формате CSV.

Данные включают следующее:

Установок
События в приложении
Установки из ретаргетинга
События в приложении для приложений, установленных из ретаргетинговых кампаний

Чтобы экспортировать сырые данные:

В AppsFlyer перейдите в раздел Report > Raw data export.
Выберите диапазон дат.
Выберите отчет.
Отчет будет загружен в течение нескольких минут.

Проверьте данные постбэка

Каждая установка генерирует постбэк, который отправляется на ваши серверы. Чтобы проверить URL-адрес постбэка, его структуру и параметры, которые к нему добавляются, экспортируйте отчет Installation postbacks.

Отчет Installation postbacks содержит столбец Postback URL. В этом столбце перечислены URL-адреса постбэков, сгенерированные для каждой установки.

Проверьте данные в этом столбце и убедитесь в следующем:

URL-адрес эндпоинта указан верно
Параметры, добавленные к URL-адресу, соответствуют параметрам, добавленным к атрибуционной ссылке AppsFlyer
Столбец Postback Error Message пуст

Чем мы можем помочь?

Поиск