Рабочий процесс интеграции Engage Developer

В этом руководстве представлен пошаговый алгоритм интеграции SDK Engage в ваше приложение.

Общие ресурсы

Для содействия в интеграции доступны следующие ресурсы:

Приложение для верификации

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

правила публикации контента

Документация содержит рекомендации по эффективной публикации контента с использованием 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.12'
}

Шаг 2: Установите приложение для проверки.

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

Шаг 3: Убедитесь, что данные отображаются в приложении для проверки.

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

  • Введите название пакета разработчика, который публикует данные.
Рисунок 1 : Введите название пакета
  • Убедитесь, что все сущности в кластере опубликованы.
Рисунок 2 : Подтвердите, что все сущности в кластере опубликованы.
  • Убедитесь, что все поля сущности опубликованы. Для каждого элемента в строке вы можете щелкнуть изображение-заставку, чтобы подтвердить намерение.
Рисунок 3 : Проверка полей сущности и изображения плаката.
  • Просмотрите сводки на уровне приложения, кластера и сущности, указывающие количество ошибок валидации. Изучите сообщения об ошибках валидации, выделенные красным цветом под каждым соответствующим полем. Ошибки валидации возникают, когда обязательные поля отсутствуют или имеют неверные значения.
Рисунок 4 : Сводка ошибок проверки и подробные сведения.
  • Убедитесь, что все ошибки проверки устранены. Пример состояния:
Рисунок 5 : Проверка устранения ошибок валидации.

Шаг 4: Проверка потока широковещательных намерений

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

Рисунок 6 : Проверка намерения трансляции

После выполнения шагов с 1 по 4 тестирование интеграции на вашей стороне завершено.

Шаг 5: Самостоятельно сертифицируйте свою интеграцию.

Перед проверкой вам необходимо пройти самосертификацию. Это важный шаг для подтверждения готовности вашей интеграции и для упрощения процесса проверки.

  • Введите название пакета и нажмите кнопку «Начать самосертификацию» на главной странице приложения для проверки.

    Рисунок 7 : Начало самосертификации

  • На следующей странице выберите свою вертикаль из выпадающего списка. Отобразится список тестов для выбранной вертикали:

Рисунок 8 : Процесс самосертификации в процессе
  • Используйте приложение Verify для проверки вашей интеграции на соответствие каждому тестовому случаю, отображаемому в приложении Verify.

    • Индикатор выполнения показывает количество выполненных на данный момент тестов.
    • Нажмите кнопку « Просмотреть подробности» , чтобы увидеть шаги по проведению теста и ожидаемое поведение, а также необходимые ручные проверки.
    • В средней части страницы самосертификации отображаются опубликованные кластеры.
    • Нажмите кнопку «Записать результат теста» , чтобы записать результат теста. Укажите обоснование, если вы отмечаете тест как неудачный или пропущенный.
    • Используйте кнопки «Назад» и «Далее» , чтобы перейти к предыдущему и следующему тестам соответственно.
    • Чтобы выйти из тестирования, нажмите кнопку «Завершить тестирование » или закройте приложение Verify в любое время. Текущая сессия тестирования сохраняется автоматически и может быть возобновлена ​​или запущена повторно в любое время (даже если приложение Verify закрыто или устройство перезагружено). Если вы введете то же имя пакета и выберете ту же вертикаль в начале самосертификации, приложение Verify отобразит запрос с вопросом, хотите ли вы возобновить текущую сессию тестирования.
    • Нажмите кнопку «Загрузить сессию» , чтобы загрузить текущую тестовую сессию в виде CSV-файла. Этот CSV-файл можно отправить другим пользователям, и сессию можно загрузить в приложение Verify, используя кнопку «Загрузить общую сессию» на главной странице приложения Verify. Обратите внимание, что в загруженной сессии сохраняются только тестовые случаи и результаты тестирования.
  • После завершения тестирования нажмите кнопку «Завершить тестирование» , чтобы получить загружаемый отчет о результатах самосертификации.

Рисунок 9 : Завершение самосертификации

После выполнения шагов с 1 по 5 интеграционное тестирование завершено.

Шаг 6: Повторная проверка: Переключитесь на производственную версию SDK.

После завершения отладки необходимо обновить метаданные в файле манифеста:

<application>
  ...
  <meta-data
        android:name="com.google.android.engage.service.ENV"
        android:value="PRODUCTION"></meta-data>
</application>

Шаг 7: Отправьте Google APK-файл, готовый к выпуску.

Отправьте копию готового к выпуску APK-файла в качестве вложения к электронному письму на адрес [email protected] . Также приложите заполненную сводку самосертификации, сгенерированную приложением Verify. Google проверит, работает ли интеграция должным образом. После проверки интеграции Google вы можете отправить приложение в продакшн для выпуска.

Шаг 8: Опубликуйте APK-файл в Play Store.

После получения одобрения опубликуйте APK-файл в Play Store. После публикации APK-файла отправьте электронное письмо по адресу [email protected] с указанием номера выпущенной версии. Google ответит вам и сообщит о дальнейших шагах.

Скачать

Перед загрузкой вы должны согласиться со следующими условиями.

Условия и положения

Это лицензионное соглашение на комплект разработки программного обеспечения Android (Android Software Development Kit).

1. Введение

1.1 Комплект разработки программного обеспечения Android (далее в Лицензионном соглашении именуемый «SDK» и, в частности, включающий системные файлы Android, упакованные API и дополнения Google API) предоставляется вам по лицензии в соответствии с условиями Лицензионного соглашения. Лицензионное соглашение представляет собой юридически обязывающий договор между вами и Google в отношении использования вами SDK. 1.2 «Android» означает программный стек Android для устройств, предоставляемый в рамках проекта Android Open Source Project, который находится по следующему URL-адресу: https://source.android.com, и периодически обновляется. 1.3 «Совместимая реализация» означает любое устройство Android, которое (i) соответствует документу «Определение совместимости Android», который можно найти на веб-сайте совместимости Android (https://source.android.com/compatibility) и который может периодически обновляться; и (ii) успешно проходит набор тестов совместимости Android (CTS). 1.4 «Google» означает Google LLC, зарегистрированную в соответствии с законодательством штата Делавэр, США, и осуществляющую деятельность в соответствии с законодательством США, с основным местом деятельности по адресу: 1600 Amphitheatre Parkway, Mountain View, CA 94043, США.

2. Принятие настоящего лицензионного соглашения

2.1 Для использования SDK необходимо сначала согласиться с Лицензионным соглашением. Вы не можете использовать SDK, если не принимаете Лицензионное соглашение. 2.2 Нажимая кнопку «Принять» и/или используя данный SDK, вы тем самым соглашаетесь с условиями Лицензионного соглашения. 2.3 Вы не можете использовать SDK и не можете принять Лицензионное соглашение, если вы являетесь лицом, которому запрещено получать SDK в соответствии с законодательством Соединенных Штатов или других стран, включая страну вашего проживания или страну, из которой вы используете SDK. 2.4 Если вы соглашаетесь соблюдать Лицензионное соглашение от имени вашего работодателя или другого юридического лица, вы заявляете и гарантируете, что обладаете всеми необходимыми юридическими полномочиями для заключения Лицензионного соглашения от имени вашего работодателя или такого юридического лица. Если у вас нет необходимых полномочий, вы не можете принять Лицензионное соглашение или использовать SDK от имени вашего работодателя или другого юридического лица.

3. Лицензия SDK от Google.

3.1 В соответствии с условиями Лицензионного соглашения, Google предоставляет вам ограниченную, всемирную, безвозмездную, непередаваемую, неисключительную и не подлежащую сублицензированию лицензию на использование SDK исключительно для разработки приложений для совместимых реализаций Android. 3.2 Вы не можете использовать этот SDK для разработки приложений для других платформ (включая несовместимые реализации Android) или для разработки другого SDK. Вы, конечно, можете разрабатывать приложения для других платформ, включая несовместимые реализации Android, при условии, что этот SDK не используется для этой цели. 3.3 Вы соглашаетесь с тем, что Google или третьи стороны владеют всеми законными правами, титулами и интересами в отношении SDK, включая любые права интеллектуальной собственности, существующие в отношении SDK. «Права интеллектуальной собственности» означают любые и все права в соответствии с патентным правом, авторским правом, правом на коммерческую тайну, правом на товарные знаки и любыми другими правами собственности. Google оставляет за собой все права, прямо не предоставленные вам. 3.4 Вы не можете использовать SDK для каких-либо целей, прямо не разрешенных Лицензионным соглашением. За исключением случаев, когда это требуется в соответствии с применимыми лицензиями третьих лиц, вы не имеете права копировать (за исключением целей резервного копирования), изменять, адаптировать, распространять, декомпилировать, осуществлять обратное проектирование, разбирать или создавать производные работы SDK или любой его части. 3.5 Использование, воспроизведение и распространение компонентов SDK, лицензированных в соответствии с лицензией на программное обеспечение с открытым исходным кодом, регулируются исключительно условиями этой лицензии на программное обеспечение с открытым исходным кодом, а не настоящим Лицензионным соглашением. 3.6 Вы соглашаетесь с тем, что форма и характер предоставляемого Google SDK могут изменяться без предварительного уведомления, и что будущие версии SDK могут быть несовместимы с приложениями, разработанными на основе предыдущих версий SDK. Вы соглашаетесь с тем, что Google может прекратить (навсегда или временно) предоставление вам или пользователям в целом SDK по своему собственному усмотрению без предварительного уведомления. 3.7 Ничто в настоящем Лицензионном соглашении не дает вам права использовать какие-либо фирменные наименования, товарные знаки, знаки обслуживания, логотипы, доменные имена или другие отличительные элементы бренда Google. 3.8 Вы соглашаетесь не удалять, не скрывать и не изменять какие-либо уведомления о правах собственности (включая уведомления об авторских правах и товарных знаках), которые могут быть прикреплены к SDK или содержаться в нем.

4. Использование SDK вами

4.1 Google соглашается с тем, что не получает от вас (или ваших лицензиаров) никаких прав, титулов или интересов в отношении любых программных приложений, которые вы разрабатываете с использованием SDK, включая любые права интеллектуальной собственности, существующие в этих приложениях. 4.2 Вы соглашаетесь использовать SDK и создавать приложения только для целей, разрешенных (а) Лицензионным соглашением и (б) любым применимым законом, положением или общепринятой практикой или руководящими принципами в соответствующих юрисдикциях (включая любые законы, касающиеся экспорта данных или программного обеспечения в Соединенные Штаты или другие соответствующие страны и из них). 4.3 Вы соглашаетесь с тем, что если вы используете SDK для разработки приложений для обычных пользователей, вы будете защищать конфиденциальность и законные права этих пользователей. Если пользователи предоставляют вам имена пользователей, пароли или другую информацию для входа в систему или личную информацию, вы должны уведомить пользователей о том, что эта информация будет доступна вашему приложению, и вы должны обеспечить юридически адекватное уведомление о конфиденциальности и защиту для этих пользователей. Если ваше приложение хранит личную или конфиденциальную информацию, предоставленную пользователями, оно должно делать это безопасным образом. Если пользователь предоставляет вашему приложению информацию об учетной записи Google, ваше приложение может использовать эту информацию для доступа к учетной записи Google пользователя только тогда и в ограниченных целях, на которые пользователь дал вам разрешение. 4.4 Вы соглашаетесь, что не будете заниматься какой-либо деятельностью с SDK, включая разработку или распространение приложения, которая препятствует, нарушает, повреждает или несанкционированно получает доступ к серверам, сетям или другим ресурсам или услугам любой третьей стороны, включая, помимо прочего, Google или любого оператора мобильной связи. 4.5 Вы соглашаетесь, что несете единоличную ответственность за (и что Google не несет никакой ответственности перед вами или любой третьей стороной за) любые данные, контент или ресурсы, которые вы создаете, передаете или отображаете через Android и/или приложения для Android, а также за последствия ваших действий (включая любые убытки или ущерб, которые может понести Google). 4.6 Вы соглашаетесь с тем, что несете единоличную ответственность за любое нарушение ваших обязательств по Лицензионному соглашению, любому применимому договору с третьей стороной или Условиям обслуживания, а также за любой применимый закон или нормативный акт, а также за последствия (включая любые убытки или ущерб, которые может понести Google или любая третья сторона) любого такого нарушения (и что Google не несет за них никакой ответственности).

5. Ваши учетные данные разработчика

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

6. Конфиденциальность и информация

6.1 В целях постоянного совершенствования и улучшения SDK компания Google может собирать определенную статистику использования программного обеспечения, включая, помимо прочего, уникальный идентификатор, связанный IP-адрес, номер версии программного обеспечения, а также информацию о том, какие инструменты и/или сервисы в SDK используются и как они используются. Перед сбором любой из этих данных SDK уведомит вас и запросит ваше согласие. Если вы откажетесь дать согласие, информация не будет собрана. 6.2 Собранные данные анализируются в совокупности для улучшения SDK и хранятся в соответствии с Политикой конфиденциальности Google, которая находится по следующему адресу: https://policies.google.com/privacy 6.3 Анонимизированные и агрегированные наборы данных могут быть переданы партнерам Google для улучшения SDK.

7. Сторонние приложения

7.1 Если вы используете SDK для запуска приложений, разработанных третьей стороной, или приложений, получающих доступ к данным, контенту или ресурсам, предоставляемым третьей стороной, вы соглашаетесь с тем, что Google не несет ответственности за эти приложения, данные, контент или ресурсы. Вы понимаете, что все данные, контент или ресурсы, к которым вы можете получить доступ через такие приложения третьих сторон, являются исключительной ответственностью лица, от которого они исходят, и что Google не несет ответственности за любые убытки или ущерб, которые вы можете понести в результате использования или доступа к любым из этих приложений, данных, контента или ресурсов третьих сторон. 7.2 Вам следует знать, что данные, контент и ресурсы, предоставляемые вам через такое приложение третьей стороны, могут быть защищены правами интеллектуальной собственности, принадлежащими поставщикам (или другим лицам или компаниям от их имени). Вы не можете изменять, сдавать в аренду, предоставлять в лизинг, давать взаймы, продавать, распространять или создавать производные работы на основе этих данных, контента или ресурсов (полностью или частично), если вы не получили на это специальное разрешение от соответствующих владельцев. 7.3 Вы признаете, что использование вами таких сторонних приложений, данных, контента или ресурсов может регулироваться отдельными условиями между вами и соответствующей третьей стороной. В этом случае Лицензионное соглашение не влияет на ваши правовые отношения с этими третьими сторонами.

8. Использование API Android

8.1 API данных Google 8.1.1 Если вы используете какой-либо API для получения данных от Google, вы подтверждаете, что эти данные могут быть защищены правами интеллектуальной собственности, принадлежащими Google или сторонам, предоставляющим данные (или другим лицам или компаниям от их имени). Использование вами любого такого API может регулироваться дополнительными Условиями обслуживания. Вы не имеете права изменять, сдавать в аренду, предоставлять в лизинг, давать взаймы, продавать, распространять или создавать производные работы на основе этих данных (полностью или частично), если это не разрешено соответствующими Условиями обслуживания. 8.1.2 Если вы используете какой-либо API для получения данных пользователя от Google, вы подтверждаете и соглашаетесь с тем, что будете получать данные только с явного согласия пользователя и только тогда и для ограниченных целей, для которых пользователь дал вам разрешение на это. Используя API службы распознавания речи Android, документацию по которому можно найти по следующему адресу: https://da.cyanowen.top/reference/android/speech/RecognitionService (с периодическими обновлениями), вы подтверждаете, что использование API регулируется Дополнением к соглашению об обработке данных для продуктов, в которых Google выступает в качестве обработчика данных, которое находится по следующему адресу: https://privacy.google.com/businesses/gdprprocessorterms/ (с периодическими обновлениями). Нажимая кнопку «Принять», вы тем самым соглашаетесь с условиями Дополнения к соглашению об обработке данных для продуктов, в которых Google выступает в качестве обработчика данных.

9. Расторжение настоящего лицензионного соглашения

9.1 Лицензионное соглашение будет продолжать действовать до тех пор, пока оно не будет расторгнуто вами или Google в соответствии с условиями, изложенными ниже. 9.2 Если вы хотите расторгнуть Лицензионное соглашение, вы можете сделать это, прекратив использование SDK и любых соответствующих учетных данных разработчика. 9.3 Google может в любое время расторгнуть с вами Лицензионное соглашение, если: (A) вы нарушили какое-либо положение Лицензионного соглашения; или (B) Google обязан сделать это по закону; или (C) партнер, с которым Google предоставлял вам определенные части SDK (например, API), прекратил свои отношения с Google или перестал предоставлять вам определенные части SDK; или (D) Google принимает решение больше не предоставлять SDK или определенные части SDK пользователям в стране, в которой вы проживаете или из которой вы используете услугу, или предоставление вам SDK или определенных услуг SDK компанией Google, по собственному усмотрению Google, больше не является коммерчески целесообразным. 9.4. После прекращения действия Лицензионного соглашения все юридические права, обязанности и ответственность, которыми вы и Google пользовались, которым подчинялись (или которые возникли с течением времени, пока Лицензионное соглашение действовало) или которые, как указано, сохраняются бессрочно, остаются в силе, и положения пункта 14.7 продолжают применяться к таким правам, обязанностям и ответственности бессрочно.

10. ОТКАЗ ОТ ГАРАНТИЙ

10.1 Вы прямо понимаете и соглашаетесь с тем, что использование вами SDK осуществляется на ваш собственный риск, и что SDK предоставляется «как есть» и «в наличии» без каких-либо гарантий со стороны Google. 10.2 Использование вами SDK и любых материалов, загруженных или иным образом полученных посредством использования SDK, осуществляется на ваше собственное усмотрение и риск, и вы несете единоличную ответственность за любой ущерб вашей компьютерной системе или другому устройству, а также за потерю данных, возникшие в результате такого использования. 10.3 Компания Google также прямо отказывается от всех гарантий и условий любого рода, как явных, так и подразумеваемых, включая, помимо прочего, подразумеваемые гарантии и условия товарной пригодности, пригодности для определенной цели и отсутствия нарушений прав.

11. Ограничение ответственности

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

12. Возмещение убытков

12.1 В максимальной степени, разрешенной законом, вы соглашаетесь защищать, возмещать убытки и ограждать Google, его аффилированные компании и их соответствующих директоров, должностных лиц, сотрудников и агентов от любых и всех претензий, исков, судебных разбирательств, а также от любых и всех потерь, обязательств, убытков, затрат и расходов (включая разумные гонорары адвокатов), возникающих в результате или связанных с (а) использованием вами SDK, (б) любым приложением, разработанным вами на основе SDK, которое нарушает авторские права, товарные знаки, коммерческую тайну, фирменный стиль, патенты или другие права интеллектуальной собственности любого лица, порочит любое лицо или нарушает его права на публичность или неприкосновенность частной жизни, и (в) любым несоблюдением вами условий Лицензионного соглашения.

13. Изменения в Лицензионном соглашении

13.1 Google может вносить изменения в Лицензионное соглашение по мере распространения новых версий SDK. После внесения этих изменений Google разместит новую версию Лицензионного соглашения на веб-сайте, где доступен SDK. 14.1 Настоящее Лицензионное соглашение представляет собой полное юридическое соглашение между вами и Google и регулирует ваше использование SDK (за исключением любых услуг, которые Google может предоставлять вам в соответствии с отдельным письменным соглашением), и полностью заменяет любые предыдущие соглашения между вами и Google в отношении SDK. 14.2 Вы соглашаетесь с тем, что если Google не воспользуется или не обеспечит соблюдение какого-либо юридического права или средства правовой защиты, предусмотренного в Лицензионном соглашении (или которым Google обладает в соответствии с любым применимым законодательством), это не будет считаться формальным отказом от прав Google, и эти права или средства правовой защиты по-прежнему будут доступны Google. 14.3 Если какой-либо суд, обладающий юрисдикцией для принятия решения по данному вопросу, признает какое-либо положение Лицензионного соглашения недействительным, то это положение будет исключено из Лицензионного соглашения без ущерба для остальных положений Лицензионного соглашения. Остальные положения Лицензионного соглашения останутся действительными и подлежащими исполнению. 14.4 Вы признаете и соглашаетесь с тем, что каждый член группы компаний, материнской компанией которой является Google, будет являться третьим лицом-бенефициаром Лицензионного соглашения, и что такие другие компании будут иметь право напрямую применять и полагаться на любое положение Лицензионного соглашения, которое предоставляет им выгоду (или права в их пользу). Помимо этого, никакое другое лицо или компания не будут являться третьими лицами-бенефициарами Лицензионного соглашения. 14.5 ОГРАНИЧЕНИЯ НА ЭКСПОРТ. SDK ПОДЛЕЖИТ ДЕЙСТВИЮ ЗАКОНОВ И ПРАВИЛ ЭКСПОРТА СОЕДИНЕННЫХ ШТАТОВ. ВЫ ДОЛЖНЫ СОБЛЮДАТЬ ВСЕ ВНУТРЕННИЕ И МЕЖДУНАРОДНЫЕ ЗАКОНЫ И ПРАВИЛА ЭКСПОРТА, ПРИМЕНЯЕМЫЕ К SDK. ЭТИ ЗАКОНЫ ВКЛЮЧАЮТ ОГРАНИЧЕНИЯ НА НАПРАВЛЕНИЯ, КОНЕЧНЫХ ПОЛЬЗОВАТЕЛЕЙ И КОНЕЧНОЕ ИСПОЛЬЗОВАНИЕ. 14.6 Права, предоставленные в Лицензионном соглашении, не могут быть переданы или переуступлены ни вами, ни Google без предварительного письменного согласия другой стороны. Ни вам, ни Google не разрешается делегировать свои обязанности или обязательства по Лицензионному соглашению без предварительного письменного согласия другой стороны. 14.7 Лицензионное соглашение и ваши отношения с Google в соответствии с Лицензионным соглашением регулируются законами штата Калифорния без учета коллизионных норм. Вы и Google соглашаетесь подчиниться исключительной юрисдикции судов, расположенных в округе Санта-Клара, штат Калифорния, для разрешения любых юридических вопросов, возникающих из Лицензионного соглашения. Несмотря на это, вы соглашаетесь с тем, что Google по-прежнему будет иметь право подавать заявления о применении обеспечительных мер (или эквивалентного вида срочной юридической защиты) в любой юрисдикции. 28 апреля 2026 г.
Скачать

verify_app_multiplatform_public_20251215.apk