Настройки оплаты в Merchant Center

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

В Merchant API вы можете управлять настройками этой функции с помощью ресурса CheckoutSettings.

В этом руководстве рассказывается, как использовать Merchant API, чтобы программно создавать и настраивать переход на страницу оплаты.

Подробнее о том, как добавить ссылку на страницу оплаты в бесплатные предложения…

Требования

Чтобы использовать ресурс CheckoutSettings и связанные с ним методы, выполните следующие действия:

• Вы должны быть одобрены для участия в программе "Товарная реклама" и/или "Бесплатные предложения".
• Страной сбыта должны быть США.

Методы

Чтобы создавать, получать, обновлять и удалять настройки оформления покупки, используйте следующие методы:

• checkoutSettings.create
• checkoutSettings.get
• checkoutSettings.update
• checkoutSettings.delete

Создать настройки оформления покупки

Чтобы создать настройку оформления покупки, используйте метод checkoutSettings.create. Включите в тело запроса uri_settings с checkout_uri_template или cart_uri_template и выбранным eligible_destinations.

Пример запроса:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

Замените {ACCOUNT_ID} уникальным идентификатором своего аккаунта Merchant Center.

Ниже приведен пример ответа на успешный вызов.

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Как получить настройки оформления заказа

Чтобы получить настройки страницы оплаты, включая шаблон URL, выбранные целевые сервисы, статус регистрации и статус проверки URL, используйте метод checkoutSettings.get.

Пример запроса:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Ниже приведен пример ответа на успешный вызов.

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

Изменить настройки

Чтобы изменить настройки оформления покупки, используйте метод checkoutSettings.update. Включите поля, которые вы хотите изменить, в тело запроса и укажите их в параметре запроса update_mask.

update_mask поддерживает следующие поля:

• eligible_destinations
• uri_settings

Ниже приведен пример запроса, в котором обновляется URL и удаляется целевая страница объявления.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

Ниже приведен пример ответа на успешный вызов.

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Удалить

Чтобы удалить настройки оформления покупки, используйте метод checkoutSettings.delete.

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

Пример запроса:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

При успешном вызове возвращается пустое тело ответа.

Ссылки на страницу оплаты на уровне аккаунта и на уровне товара

Добавить URL страниц оплаты можно двумя способами:

• На уровне аккаунта (дочерний API или Merchant Center). Чтобы задать один шаблон URL (checkout_uri_template или cart_uri_template), можно использовать дочерний API или настройки Merchant Center. Этот шаблон применяется ко всем вашим товарам, соответствующим требованиям. Рекомендуем использовать одинаковый URL для всех товаров. Пример: yourstore.com/checkout?id={id}.

• На уровне товара (фид). Чтобы указать URL страницы оплаты для отдельных товаров, используйте атрибут checkout_link_template в фиде товаров. Это позволяет настраивать собственные URL для отдельных товаров или предлагать покупку только для части ассортимента.

• Если вы задали шаблон URL на уровне аккаунта с помощью этого дополнительного API, убедитесь, что вы не отправляете значения атрибута checkout_link_template в фиде для этих товаров.

• Если вы используете атрибут фида checkout_link_template, не задавайте шаблон URL на уровне аккаунта с помощью дочернего API или настроек Merchant Center. Вы по-прежнему можете использовать дочерний API, чтобы выбрать eligible_destinations, не указывая uri_settings, если вы управляете URL только через фид.

Шаблон URL страницы оплаты

Шаблон URL страницы оформления покупки позволяет включить в сведения о товарах URL страницы оформления покупки, чтобы покупатели могли переходить на нее прямо из предложения. Он должен содержать плейсхолдер параметра {ID} и иметь соответствующий домен.

При настройке ссылок на страницу оплаты с помощью дополнительного API используйте поле uri_settings. Это поле принимает один из двух шаблонов:

• checkout_uri_template. Шаблон URL, который после заполнения плейсхолдера направляет пользователя на страницу оформления покупки, где выбранный товар уже готов к покупке.
• cart_uri_template. Шаблон URL, который направляет пользователя на страницу корзины с добавленным в нее товаром.

Примеры шаблонов

• Выезд: https://www.your-store.com/checkout?item_id={id}
• Корзина: https://shop.your-store.com/add_to_cart?product_sku={id}

Убедитесь, что выполняются следующие требования:

• Шаблон URL должен указывать на действительную страницу вашего сайта, которая соответствует зарегистрированному домену, работает с использованием метода HTTP GET и не требует входа в аккаунт.
• Домен в шаблоне страницы оплаты должен совпадать с доменом товара.

Подробнее…

• Как добавить ссылку на страницу оплаты для ваших товаров
• Шаблон ссылки на страницу оплаты