Управление настройками оформления заказа

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

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

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

Для получения более подробной информации см. раздел «Добавление ссылки для оформления заказа для ваших товаров» .

Предварительные требования

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

  • Для участия в рекламных кампаниях с товарами, бесплатных объявлениях или и том, и другом необходимо получить одобрение.
  • Вашей страной продаж должны быть Соединенные Штаты.

Методы

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

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

Для создания настроек оформления заказа используйте метод 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 и не требует от клиента входа в систему.
  • Домен, указанный в предоставленном шаблоне оформления заказа, должен совпадать с доменом товара.

Узнать больше