Как начать интеграцию UCP в Merchant Center, Как начать интеграцию UCP в Merchant Center

На странице «Интеграция с UCP» в Merchant Center вы найдете пошаговые инструкции по настройке и проверке интеграции с UCP.

Процесс внедрения состоит из пяти основных этапов:

  1. Внедрите UCP, следуя инструкциям руководства : разберитесь в основных концепциях UCP и технических требованиях.
  2. Настройте свою учетную запись Merchant Center для UCP : укажите данные о товарах и параметры учетной записи.
  3. Протестируйте свою реализацию UCP в изолированной среде : безопасно протестируйте и отладьте свою интеграцию.
  4. Проверьте интеграцию UCP в рабочей среде : убедитесь, что интеграция корректно работает в вашей рабочей среде.
  5. Отслеживайте и оптимизируйте свою интеграцию : анализируйте свою производительность и выявляйте новые возможности в 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 продавца .
  • Выберите способ идентификации пользователя: укажите, как пользователи будут идентифицировать себя во время оформления заказа. Проконсультируйтесь с юристами по любым вопросам, касающимся правил конфиденциальности и практики получения согласия. Нажмите «Проверить» , чтобы настроить этот шаг. У вас есть два варианта:

    • Оформление заказа без регистрации: сокращает количество шагов для клиентов и оптимизировано для повышения конверсии.
    • Идентификационная привязка: позволяет клиентам получать доступ к преимуществам программы лояльности и персонализированным предложениям.
      • Требуется реализация 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, а затем:

  1. Войдите в свой аккаунт Google Merchant Center.
  2. Перейдите в раздел «Настройки» в меню слева.
  3. Нажмите «Интеграция UCP» .
  4. Выберите новую вкладку «Аналитика» .

Разберитесь в своих показателях.

Панель мониторинга включает следующие основные показатели, которые помогут вам оценить вашу интеграцию:

Метрика Описание
Купить кликами Количество нажатий покупателями кнопки «Купить» в контекстном меню.
Покупки Общее количество успешно завершенных транзакций с использованием UCP.
Ставка покупки Процент переходов по ссылкам, завершившихся успешной покупкой.
Средняя стоимость заказа (AOV) Среднее значение каждого выполненного заказа UCP.
Отмены Количество заказов, отмененных или возвращенных после покупки.
Связывание учетных записей Показатели количества попыток привязки аккаунтов и процент успешных попыток (где применимо).
Самые продаваемые товары UCP Ранжированный список ваших товаров, обеспечивающих наибольшие продажи благодаря интеграции с UCP.