Тестирование интеграции веб-SDK PBA

Для:
разработчиков
Последнее обновление:

Краткий обзор. Протестируйте интеграцию плагина веб-SDK PBA.

Тестирование веб-событий PBA

Принципы использования страницы тестирования

Веб-SDK отправляет веб-события в PBA, и они становятся доступны на дэшборде PBA и в отчетах по сырым данным после ежедневной обработки. Для обеспечения эффективного процесса тестирования вы отправляете тестовые события, не дожидаясь ежедневной обработки. Тестовые события:

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

Страница тестирования интеграции веб-SDK

Основной вид страницы

TestScreen_us-en.jpg

  • Сначала отображаются самые последние события.
  • Кэш событий:
    • Содержит до 100 событий
    • Старые события удаляются, чтобы освободить место для новых событий.
    • Кэшированные события удаляются через 24 часа.
  • Элементы управления страницей:
    • Индикатор частоты обновления: Страница автоматически обновляется каждые 5 секунд.
    • Очистить все: Очищает кэш событий навсегда. Внимание! Кэш является общим для веб-сайтов, использующих один и тот же ключ веб-разработки. Таким образом, если другой разработчик использует страницу тестирования, она будет очищена и для него. 
    • Пауза/старт: Приостанавливает автоматическое обновление. Новые события не отображаются, пока вы не нажмете «Старт». 

Столбцы таблицы событий

Поле Описание
Время (UTC) Время события
Тип события

Типы событий следующие:

  • События, отправленные вами:
    • EVENT
    • setCustomerUserId
    • pageLoad: Отправляется из веб-SDK каждый раз при загрузке/обновлении страницы на вашем сайте.
Содержание события

Полезная нагрузка события, зафиксированная PBA.
Комментарии
  • Действительно: Событие получено и зарегистрировано в PBA. Никаких дополнительных действий не требуется.
  • Недействительно: Список ошибок, требующих исправления. Формат сообщения об ошибке:
    название поля события: описание ошибки 
  • Наведите курсор на сообщения об ошибках, чтобы увидеть подробности:

    PBAWebSDKTestingErrorMessagesPopup_en-us.png

 

Детализированный вид

mceclip0.png

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

Процедура

Выполните следующие процедуры.

Включите тестовый режим

Необходимые условия

Перед тестированием веб-SDK необходимо внедрить на ваш сайт или на тестовый сайт.

Ограничение браузера

Если в определенном браузере включен тестовый режим, независимо от вкладки, браузер можно использовать только для подключения к указанному веб-сайту, а не к какому-либо другому веб-сайту. Используйте другой браузер, например Safari вместо Chrome, чтобы подключиться с того же компьютера к другому веб-сайту.

Чтобы включить тестовый режим:

  1. Убедитесь, что SDK загружен:
    1. В AppsFlyer в верхнем меню выберите Мои приложения > Просмотр пакетов брендов.
    2. Выберите необходимый Тест интеграции веб-SDK.
      Откроется страница интеграции. Отобразится веб-ключ разработчика.

      pba_web_sdk_integration_test_web_dev_key_en-us.png

    3. В новой вкладке браузера перейдите на свой сайт (на котором установлен веб-SDK).
    4. Нажмите правой кнопкой мыши и выберите «Проверить», чтобы открыть инструменты разработчика в браузере. 
    5. Перейдите на вкладку Консоль.
    6. В консоли введите:
      window.AF_SDK.initPluginsConfig.pba.webAppId

      Отобразится webAppID.

      testing_pba_integration_webappid_check_en-us.png

    7. Убедитесь, что webAppID совпадает с веб-ключом разработчика на странице тестирования интеграции веб-SDK.
  2. Включите тестовый режим:
    1. На вкладке браузера веб-сайта перейдите на вкладку Консоль.
    2. Введите следующее: 
      window.AF_SDK.PLUGINS.PBA.turnOnDevMode()
      Функция возвращает undefined.

      testing_pba_integration_turnondevmode.png

  3. Убедитесь, что тестовый режим включен:
    • На вкладке Консоль введите:
      window.AF_SDK.PLUGINS.PBA.isDevModeOn()

      Возвращаемое значение: true. Это означает, что тестовый режим активен. 
      PBATestingWebSDKIntegrationIsDevModeOn_en-us.png

Отправьте тестовые события

  • В тестовом режиме отправляемые вами события отображаются на странице тестирования интеграции.
  • Внимание! Тестовые события обрабатываются и впоследствии включаются в отчеты PBA. Чтобы избежать искажения отчетов, заполните eventRevenue низкими (малыми) значениями. Если значение не отправлено, PBA заполняет его как 0. 

Отправьте примеры событий каждого из описанных типов. 

Шаг

Действие

(Введите команды)

Страница тестирования интеграции веб-SDK

(Ожидаемый результат) 
1

Откройте новую вкладку в браузере и перейдите на любую страницу вашего сайта.

PBA зарегистрирует событие 'pageLoad' при открытии/обновлении вашего сайта:

PBATestingWebSDKPageLoadEvent_en-us.png

2

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

mceclip3.png
3

Начните отправлять веб-события, чтобы убедиться, что PBA обрабатывает их правильно.

Примечание.

Если не указано иное, eventRevenue и eventRevenueCurrency заполнены значениями по умолчанию:

  • eventRevenueCurrency: "USD"
  • eventRevenue: 0

PBAWebSDKTestEventEVENT_en-us.png

Дополнительные сведения см. в параметрах событий веб-SDK.

mceclip5.png

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

События не отображаются на странице тестирования

  1. В инструментах разработчика в браузере перейдите на вкладку Сеть.
  2. В поле фильтра введите «websdk».
  3. На основе кода ответа HTTP выполните следующие действия:
    • 200: Обратитесь в службу технической поддержки AppsFlyer.
    • 400: Проверьте, что все параметры заключены в кавычки " ".