В этом руководстве представлен пошаговый рабочий процесс интеграции Engage SDK в ваше приложение.
Общие ресурсы
Для помощи в интеграции доступны следующие ресурсы:
Приложение для проверки
Приложение для проверки, используемое для проверки публикации контента в пользовательском интерфейсе.
Правила публикации контента
Документация , предоставляющая рекомендации по эффективной публикации контента с использованием API.
Шаг 1: Разработка в режиме отладки SDK
Добавьте Engage SDK в файл build.gradle и следуйте соответствующему руководству по интеграции для конкретной отрасли, чтобы завершить интеграцию.
dependencies {
// Make sure you also include the repository in your project's
// build.gradle file.
implementation 'com.google.android.engage:engage-core:1.5.7'
}
Шаг 2: Установите приложение для проверки
Приложение для проверки — это приложение для Android, которое можно использовать для проверки работоспособности интеграции. Оно включает в себя функции, помогающие разработчикам проверять данные и намерения трансляции.
Шаг 3: Убедитесь, что данные видны в приложении проверки.
Приложение проверки должно отображать каждый кластер как отдельную строку.
- Введите название пакета разработчика, который публикует данные.
- Убедитесь, что все сущности в кластере опубликованы.
- Убедитесь, что все поля сущности опубликованы. Для каждого элемента в строке нажмите на изображение постера, чтобы проверить намерение.
- Проверьте сводки для уровней приложения, кластера и сущности, которые показывают количество ошибок валидации. Ознакомьтесь с сообщениями об ошибках валидации, которые отображаются красным цветом под каждым соответствующим полем. Ошибки валидации возникают, когда обязательные поля отсутствуют или содержат неверные значения.
- Убедитесь, что все ошибки проверки устранены. Пример состояния:
Шаг 4: Проверьте поток намерений трансляции
Чтобы проверить цель трансляции, нажмите кнопку в верхней части пользовательского интерфейса, чтобы запустить логику отправки трансляций.
После завершения шагов с 1 по 4 вы завершите тестирование интеграции на своей стороне.
Шаг 5: Самостоятельно подтвердите свою интеграцию
Перед проверкой вам необходимо пройти самосертификацию. Это важный шаг для подтверждения готовности вашей интеграции и упрощения процесса проверки.
Введите название пакета и нажмите кнопку «Начать самостоятельную сертификацию» на главной странице приложения проверки.
Рисунок 7 : Начало самостоятельной сертификации На следующей странице выберите свою вертикаль из раскрывающегося списка. Отобразится список тестов для этой вертикали:
Используйте приложение Verify для проверки интеграции с каждым тестовым случаем, созданным в приложении Verify.
- Индикатор выполнения показывает количество выполненных на данный момент тестов.
- Нажмите кнопку « Просмотреть подробности» , чтобы просмотреть шаги по выполнению теста и ожидаемое поведение, а также необходимые ручные проверки.
- В средней части страницы самосертификации отображаются опубликованные кластеры.
- Нажмите кнопку «Записать результат теста» , чтобы зафиксировать результат. Если вы отмечаете тест как проваленный или пропущенный, предоставьте обоснование.
- Используйте кнопки «Назад» и «Далее» для перехода к предыдущему и следующему тестам соответственно.
- Чтобы выйти из тестирования, нажмите кнопку «Выйти из тестирования» или закройте приложение Verify. Текущий сеанс тестирования сохраняется автоматически и может быть возобновлен или запущен повторно в любое время (даже если приложение Verify закрыто или устройство перезагружено). При вводе того же названия пакета и выборе той же вертикали в начале самостоятельной сертификации приложение Verify выводит запрос на возобновление текущего сеанса тестирования.
- Нажмите кнопку «Загрузить сеанс» , чтобы загрузить текущий сеанс тестирования в виде CSV-файла. Этот CSV-файл можно использовать для общего доступа, а сам сеанс можно загрузить в приложение Verify с помощью кнопки «Загрузить общий сеанс» на главной странице приложения Verify. Обратите внимание, что в загруженном сеансе сохраняются только тестовые случаи и результаты тестирования.
После завершения тестирования нажмите кнопку «Завершить тестирование» , чтобы сформировать доступный для скачивания отчет о тестировании для самостоятельной сертификации.
После выполнения шагов с 1 по 5 вы завершите интеграционное тестирование.
Шаг 6: Повторная проверка: переход на версию SDK prod
После завершения отладки необходимо обновить метаданные в файле манифеста:
<application>
...
<meta-data
android:name="com.google.android.engage.service.ENV"
android:value="PRODUCTION"></meta-data>
</application>
Шаг 7: Отправьте Google готовый к выпуску APK-файл
Отправьте копию готового к выпуску APK-файла в виде вложения к электронному письму на адрес engage-developers@google.com . Также приложите заполненный отчёт о самосертификации, сгенерированный приложением Verify. Google проверит, работает ли интеграция должным образом. После того, как Google проверит интеграцию, вы можете отправить приложение в производство для выпуска.
Шаг 8: Опубликуйте APK в Play Store
После получения одобрения опубликуйте APK-файл в Play Маркете. После публикации APK-файла отправьте электронное письмо на адрес engage-developers@google.com с указанием номера выпущенной версии. Google ответит вам и сообщит о дальнейших действиях.
Скачать
Перед загрузкой вы должны согласиться со следующими условиями.