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

Поиск

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

  • Обновлено

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

iOS: тестирование интеграции 

Тестирование состоит из следующих элементов:

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

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

Рекламодатели управляют данными, передаваемыми рекламным сетям с помощью настройки Advanced Privacy. Эта настройка вместе с настройкой ATT пользователя приложения влияет на тип постбэка и данные, передаваемые рекламным сетям, как описано в руководстве по постбэкам Advanced Privacy. В следующей таблице перечислены тестовые сценарии в соответствии с доступными комбинациями настроек.

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

Комбинации тестовых сценариев

Пример ситуации

 Настройка Advanced Privacy Настройка ATT в приложении  Тип отправляемого постбэка
А Откл. Разрешить Regular
Б Включен Попросить приложение не отслеживать Продвинутая защита данных

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

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

Требования

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

Требования
Завершите стандартную интеграцию с AppsFlyer. При необходимости свяжитесь с AppsFlyer с помощью виджета помощника для партнеров.
Завершите интеграцию Расширенная конфиденциальность с AppsFlyer. При необходимости свяжитесь с AppsFlyer с помощью виджета помощника партнера.
Интегрируйте тестовое iOS-приложение в свою учетную запись.
Убедитесь, что тестовое приложение интегрировано в вашу учетную запись
Сопоставьте события в приложении с названиями своих событий. Названия событий для сопоставления: purchase, login, registration
Подготовьте ссылку атрибуции
Проведите тест на устройстве под управлением iOS 14.5+

Тест — расширенные настройки конфиденциальности: выкл

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

  1. На дэшборде AppsFlyer установите для параметра Enable Advanced Privacy значение off.
  2. На устройстве:
    1. Проверьте, что тестовое приложение не установлено. При необходимости удалите его.
    2. В настройках конфиденциальности убедитесь, что параметр Allow Apps to Request to Track is on.

      PartnerIntegrationAllow.png

  3. Отправьте ссылку атрибуции на тестовое устройство.
  4. Откройте ссылку атрибуции в браузере устройства.
    Вы будете перенаправлены в магазин приложений.
  5. Скачайте и откройте приложение.
    Появится диалоговое окно согласия ATT.

    AppDialogue_us-en.png

  6. Нажмите Allow.
    Откроется страница Install Data.

    PartnerIntegrationInstallData.png

  7. Нажмите ATT Status.
    Отобразится статус Авторизовано.

  8. Проверьте атрибуцию, используя следующие параметры. Если валидация не пройдена, см. раздел Устранение неполадок.

    1. install_time: близко к текущему времени. Время указано в UTC. 
    2. af_status: Non-organic Если это не так, установка не была атрибутирована. 
    3. media_source: ваша рекламная сеть 
  9. Нажмите Тесты in-app событий.

    AppPurchase.png

  10. Нажмите Событие покупки.
    Появится подтверждение события покупки. 
  11. Проверьте, что:
    1. Вы получили постбэки об установке и покупке.
    2. Имя события сопоставлено правильно (если вы настроили события в приложении).
    3. Вы можете принять постбэк.

Расширенные настройки конфиденциальности отключены — результаты теста

постбэк

Время запуска события 

 Ожидаемый тип постбэка Фактически полученный постбэк (успешно/неуспешно) Валидация постбэка (успешно/неуспешно)
установка   Regular    
In-app событие: Purchase   Regular    

Тест — расширенные настройки конфиденциальности включены

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

  1. На дэшборде AppsFlyer включите параметр Enable Advanced Privacy.
  2. На устройстве:
    1. Убедитесь, что тестовое приложение не установлено. Удалите это при необходимости.
    2. В настройках конфиденциальности проверьте, что параметр Allow Apps to Request to Track включен.

      PartnerIntegrationAllow.png

  3. Отправьте ссылку атрибуции на тестовое устройство.
  4. Откройте ссылку атрибуции в браузере на устройстве.
    Вы будете перенаправлены в магазин приложений.
  5. Скачайте и откройте приложение.
    Появится диалоговое окно согласия ATT.

    AppDialogue_us-en.png

  6. Нажмите Попросить приложение не отслеживать.
    Отображается страница Install Data.

    PartnerIntegrationInstallData.png

  7. Нажмите ATT Status.
    Отобразится статус Denied.

  8. Проверьте атрибуцию по перечисленным параметрам. Если валидация не пройдена, см. раздел Troubleshooting. 

    1. install_time: близко к текущему времени. Время указывается по UTC. 
    2. af_status: Non-organic Если это не так, установка не атрибутирована. 
    3. media_source: ваша рекламная сеть 
  9. Нажмите In-App Event Tests.

    AppPurchase.png

  10. Нажмите Purchase Event.
  11. Проверьте, что:
    1. Вы получили постбэки об установке и покупке.
    2. Название события сопоставлено правильно (если вы сопоставили события в приложении).
    3. Вы можете принять постбэк.

Расширенная конфиденциальность включена — результаты теста

постбэк

Время запуска события 

 Ожидаемый тип постбэка Полученный постбэк (успешно/неуспешно) Валидация постбэка (успешно/неуспешно)
установка   Продвинутая защита данных    
Событие в приложении: Покупка   Продвинутая защита данных    

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

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

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

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

PartnerIntegrationУстановкаData.png

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

  • Тестирование событий в приложении
    Отправить событие покупки, входа и регистрации в приложении. Если сопоставить названия событий в приложении с вашими названиями событий, постбэки будут заполняться вашими названиями событий.
  • Статус ATT
    Возвращает текущий статус ATT, указанный iOS: Authorized или Denied. Статус ATT зависит от согласия пользователя на отслеживание в диалоговом окне согласия ATT и от настройки устройства Разрешить приложениям запрашивать отслеживание. 

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

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

  • Сгенерируйте ссылку на дэшборде AppsFlyer.
  • Отредактируйте пример ссылки ниже.

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

  1. В AppsFlyer перейдите в Мои приложения.
  2. Выберите id1543229303.
  3. В боковом меню выберите Сотрудничество > Активные интеграции > выберите свою рекламную сеть > вкладку Ссылка атрибуции.
  4. На вкладке «Ссылка атрибуции» задайте указанные параметры. При необходимости можно добавить дополнительные параметры.
    Параметр Пример значения Замечание
    кампания; c-test-2020-12-20 Задайте значение, которое можно идентифицировать в ваших постбэках
  5. Скопируйте полученную ссылку для дальнейшего использования. 

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


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

Настройте расширенную конфиденциальность

AdvancedPrivacyOff.png

Чтобы изменить настройку Enable Advanced Privacy: 

  1. В AppsFlyer перейдите в Мои приложения.
  2. Выберите приложение id1543229303.
  3. В боковом меню выберите Сотрудничество > Активные интеграции > выберите свою рекламную сеть > вкладку Интеграция.
  4. Установите для Enable Advanced Privacy подходящее значение для каждого тестового сценария. 
  5. Нажмите кнопку Save Integration (Сохранить интеграцию).

Тестовое приложение, интегрированное в ваш аккаунт

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

  1. В AppsFlyer перейдите в Мои приложения.
  2. Убедитесь, что приложение Partner Integrations id1543229303 отображается в разделе Available Apps. В противном случае обратитесь к своему менеджеру по развитию партнеров. 

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

Симптом Причина/корректирующее действие
Время установки не соответствует текущему времени

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

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

Убедитесь, что версия iOS на устройстве соответствует указанной в предварительных требованиях. 

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

Tags