В этом руководстве представлен пошаговый рабочий процесс интеграции 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: Самостоятельно подтвердите свою интеграцию
Перед проверкой вам необходимо пройти самосертификацию. Это важный шаг для подтверждения готовности вашей интеграции и упрощения процесса проверки.
Сделайте копию таблицы тестовых случаев Engage SDK .
Используйте приложение 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 . Также приложите заполненную таблицу самосертификации. Google проверит, работает ли вся интеграция должным образом. После того, как Google проверит интеграцию, вы можете отправить приложение в производство для выпуска.
Шаг 8: Опубликуйте APK в Play Store
После получения одобрения опубликуйте APK-файл в Play Маркете. После публикации APK-файла отправьте электронное письмо на адрес engage-developers@google.com с указанием номера выпущенной версии. Google ответит вам и сообщит о дальнейших действиях.
Скачать
Перед загрузкой вы должны согласиться со следующими условиями.