На странице «Интеграция с UCP» в Merchant Center вы найдете пошаговые инструкции по настройке и проверке интеграции с UCP.
Процесс внедрения состоит из пяти основных этапов:
- Внедрите UCP, следуя инструкциям руководства : разберитесь в основных концепциях UCP и технических требованиях.
- Настройте свою учетную запись Merchant Center для UCP : укажите данные о товарах и параметры учетной записи.
- Протестируйте свою реализацию UCP в изолированной среде : безопасно протестируйте и отладьте свою интеграцию.
- Проверьте интеграцию UCP в рабочей среде : убедитесь, что интеграция корректно работает в вашей рабочей среде.
- Отслеживайте и оптимизируйте свою интеграцию : анализируйте свою производительность и выявляйте новые возможности в Merchant Center.
Перейдите на вкладку интеграции UCP.
В ходе внедрения системы регистрации в США на этапе раннего доступа вы найдете специальную вкладку интеграции с UCP в навигационном меню.
- В своем аккаунте Google Merchant Center нажмите «Настройки» в левом навигационном меню.
- Выберите интеграцию UCP .
1. Внедрите UCP, следуя инструкциям в руководстве.
Ознакомьтесь с руководством по внедрению UCP , чтобы понять этапы интеграции. В этом руководстве рассматриваются основные спецификации и концепции API.
2. Настройте свою учетную запись Merchant Center для UCP.
Нажмите кнопку «Начать» в разделе «Настройка учетной записи Merchant Center для карт UCP» , чтобы настроить параметры Merchant Center и выполнить все действия в контрольном списке. Это гарантирует, что ваши товары будут доступны для поиска и готовы к оформлению заказа с использованием UCP. После выполнения каждого шага нажмите кнопку «Готово» .
3. Протестируйте свою реализацию UCP в изолированной среде.
Нажмите кнопку «Тест» на вкладке «Протестируйте свою реализацию UCP в тестовой среде », чтобы перейти на страницу «Интеграция UCP в тестовую среду». Это позволит вам безопасно протестировать интеграцию в различных сценариях использования и просмотреть ответы от вашего сервера.
Настройка ключей API для оформления заказа
Чтобы Google мог вызывать ваши API для тестирования и использования в производственной среде, вам необходимо предоставить ключи API из вашей системы. Эти ключи используются для аутентификации запросов от Google к вашим конечным точкам.
- Требования: Google зашифрует и сохранит ваши домены и связанные с ними ключи API. Вам следует сгенерировать отдельные ключи для этой интеграции.
- Среды: вам потребуется предоставить отдельные API-ключи для тестовой (песочницы) и производственной сред.
- Для отправки запроса свяжитесь с нами по электронной почте, чтобы обсудить поддерживаемые методы и обмен ключами. Наш контактный адрес электронной почты вы найдете в разделе «Настройки» > «Интеграция с UCP» .
Укажите местоположение вашего профиля UCP и учетные данные.
Для тестирования интеграции UCP в тестовой среде необходимо предоставить следующую информацию:
- Расположение профиля UCP: укажите путь к файлу
/.well-known/ucpкоторый вы хотите протестировать. Этот URL-адрес позволит Google определить возможности вашего сервера и конечные точки API. - Ключ API: введите ключ API, если ваша тестовая среда требует его для аутентификации запросов.
- Переопределите access_token: при необходимости укажите здесь конкретный токен OAuth Bearer, который будет использоваться для запросов к API.
Имитация действий при оформлении заказа
Вы можете имитировать различные действия при оформлении заказа, чтобы убедиться, что ваша интеграция работает должным образом:
- Создание процесса оформления заказа: тесты, запускающие новый процесс оформления заказа. Введите данные запроса в предоставленном редакторе JSON и нажмите «Тест» .
- Обновление оформления заказа: тесты обработки обновлений существующего оформления заказа (например, изменений информации о доставке). Используйте
idиз ответаCreateCheckout. - Завершение оформления заказа: имитирует заключительный этап покупки для подтверждения успешного завершения транзакции.
4. Проверьте интеграцию UCP в рабочей среде.
Нажмите кнопку «Проверить» на карточке «Проверьте интеграцию UCP в рабочей среде» , чтобы начать процесс проверки в производственной среде. Этот контрольный список гарантирует корректную работу вашей интеграции UCP в рабочей среде.
Выполните следующие этапы проверки:
Настройка учетной записи Merchant Center для UCP: убедитесь, что все настройки завершены. Нажмите «Настроить», если вам нужно вернуться к контрольному списку.
Опубликовать профиль продавца UCP: это позволит Google обнаружить ваши сервисы, возможности, обработчики платежей и открытые ключи для проверки. Нажмите «Проверить» .
- Добавьте URL-адрес вашего профиля UCP продавца (например,
https://example.com/.well-known/ucp). - Нажмите «Готово» . Вы должны увидеть обнаруженные возможности.
- Узнайте больше о профиле UCP продавца .
- Добавьте URL-адрес вашего профиля UCP продавца (например,
Выберите способ идентификации пользователя: укажите, как пользователи будут идентифицировать себя во время оформления заказа. Проконсультируйтесь с юристами по любым вопросам, касающимся правил конфиденциальности и практики получения согласия. Нажмите «Проверить» , чтобы настроить этот шаг. У вас есть два варианта:
- Оформление заказа без регистрации: сокращает количество шагов для клиентов и оптимизировано для повышения конверсии.
- Идентификационная привязка: позволяет клиентам получать доступ к преимуществам программы лояльности и персонализированным предложениям.
- Требуется реализация OAuth 2.0. Если у вас не реализован OAuth 2.0, эта опция будет отключена.
- Для включения функции привязки идентификаторов:
- Внедрите свои конечные точки OAuth 2.0, следуя процедуре авторизации по коду OAuth 2.0 .
- Укажите эту возможность в своем профиле UCP для продавца: убедитесь, что ваш файл
/.well-known/ucpвключаетdev.ucp.common.identity_linkingв список возможностей. - Опубликуйте метаданные вашего сервера авторизации OAuth: создайте и разместите JSON-файл по адресу
/.well-known/oauth-authorization-serverв вашем домене. Этот файл должен соответствовать RFC 8414 и содержать такие сведения, как ваши конечные точки авторизации, токена и отзыва. - После завершения технической настройки Google проверит процесс привязки вашей личности и сообщит вам, когда он будет готов к тестированию.
Конкретную структуру, необходимые поля и пример см. в руководстве по привязке идентификаторов — OAuth 2.0 .
Полная интеграция с системой оформления заказа: реализация и проверка 3 основных REST-интерфейсов для создания, обновления и завершения сессий. Нажмите «Проверить» в главном списке, чтобы начать.
- Это открывает страницу тестирования интеграции оформления заказа . Проверка представляет собой многоэтапный процесс, включающий автоматическое тестирование, проверку схемы и обязательную проверку в списке ожидания.
- Выберите метод аутентификации: выберите способ аутентификации для теста:
- Привязанный аккаунт Google: подтвердите действие, используя свой привязанный аккаунт Google.
- Переопределите текстовое поле access_token: вручную укажите токен доступа для тестирования. Он будет передан в заголовке Authorization (Bearer).
- Нажмите «Тест» , чтобы запустить процесс проверки с использованием выбранного метода аутентификации. Вероятно, это потребует дополнительных шагов для проверки выбора товара, данных о доставке и процесса оформления заказа.
- Просмотрите результаты или ошибки, появившиеся после выполнения тестов.
- Нажмите «Готово» , когда завершите тестирование на этой странице.
Синхронизация статуса заказа: настройте веб-хуки для отправки обновлений заказа в Google. Нажмите «Проверить» в главном списке, чтобы перейти на страницу проверки статуса заказа UCP . Свяжитесь с нами по электронной почте, чтобы получить значения
{PARTNER_ID}и{PROD_KEY}. Наш контактный адрес электронной почты можно найти в разделе «Настройки» > «Интеграция UCP» .Получите URL-адрес конечной точки Google: используйте эту конечную точку для отправки запросов веб-перехватчика. Замените заполнители (
{PARTNER_ID},{PROD_KEY}) на ваши конкретные значения.POST https://shoppingdataintegration.googleapis.com/v1/webhooks/partners/PARTNER_ID/events/order?key=PROD_KEYПроверьте свой веб-хук: отправьте тестовое обновление статуса заказа на конечную точку Google. Вы можете использовать идентификатор тестового заказа из предыдущего шага «Проверка интеграции с собственной системой оформления заказа» или нажать «Создать новый заказ» . Google автоматически проверит вашу реализацию после получения запроса.
Нажмите «Готово» , чтобы выйти.
После завершения всех этапов проверки ваша интеграция UCP будет рассмотрена службой поддержки Google. Вы получите уведомление о том, активирована ли ваша учетная запись или необходимо устранить какие-либо проблемы с настройкой.
5. Отслеживайте и оптимизируйте свою интеграцию.
Панель мониторинга UCP Analytics в Google Merchant Center предоставляет централизованное представление о процессе оформления заказа в UCP. Эти данные обеспечивают множество преимуществ:
- Отслеживание эффективности: получите полную информацию о воронке оформления заказа UCP от первого клика до завершения покупки.
- Изучите поведение клиентов: посмотрите, как покупатели взаимодействуют с процессами покупки, поддерживающими UCP.
- Выявление возможностей: используйте полученные данные для совершенствования интеграции UCP и улучшения взаимодействия с клиентами.
- Оценка влияния: количественная оценка общего объема и стоимости транзакций, осуществляемых с помощью UCP.
Как получить доступ к панели мониторинга отчетов UCP Analytics
Доступ к этому отчету предоставляется всем продавцам, использующим UCP. Чтобы просмотреть свои данные, убедитесь, что вам назначена роль «Производительность» в Merchant Center, а затем:
- Войдите в свой аккаунт Google Merchant Center.
- Перейдите в раздел «Настройки» в меню слева.
- Нажмите «Интеграция UCP» .
- Выберите новую вкладку «Аналитика» .
Разберитесь в своих показателях.
Панель мониторинга включает следующие основные показатели, которые помогут вам оценить вашу интеграцию:
| Метрика | Описание |
|---|---|
| Купить кликами | Количество нажатий покупателями кнопки «Купить» в контекстном меню. |
| Покупки | Общее количество успешно завершенных транзакций с использованием UCP. |
| Ставка покупки | Процент переходов по ссылкам, завершившихся успешной покупкой. |
| Средняя стоимость заказа (AOV) | Среднее значение каждого выполненного заказа UCP. |
| Отмены | Количество заказов, отмененных или возвращенных после покупки. |
| Связывание учетных записей | Показатели количества попыток привязки аккаунтов и процент успешных попыток (где применимо). |
| Самые продаваемые товары UCP | Ранжированный список ваших товаров, обеспечивающих наибольшие продажи благодаря интеграции с UCP. |