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

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

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

В этом руководстве объясняется, как использовать 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-адреса для оформления заказа на ваши продукты:

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

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

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

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

Шаблон URL-адреса для оформления заказа

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

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

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