Mengelola setelan checkout

Fitur checkout mempercepat pembelian bagi pelanggan yang siap membeli dengan memungkinkan mereka langsung membuka halaman checkout atau keranjang situs Anda dari listingan produk Google, yang dapat meningkatkan rasio konversi dan memperlancar pengalaman belanja.

Dengan Merchant API, Anda dapat mengelola setelan untuk fitur ini menggunakan resource CheckoutSettings.

Panduan ini menjelaskan cara menggunakan Merchant API untuk membuat dan mengelola pendaftaran Anda di fitur checkout secara terprogram.

Untuk informasi selengkapnya, lihat Menambahkan link checkout untuk produk Anda.

Prasyarat

Untuk menggunakan resource CheckoutSettings dan metode terkait, pastikan untuk melakukan hal berikut:

  • Anda harus disetujui dan berpartisipasi dalam Iklan Shopping, listingan gratis, atau keduanya.
  • Negara penjualan Anda harus Amerika Serikat.

Metode

Untuk membuat, mengambil, memperbarui, dan menghapus setelan checkout, Anda dapat menggunakan metode berikut:

Membuat setelan checkout

Untuk membuat setelan checkout, gunakan metode checkoutSettings.create. Sertakan uri_settings dengan checkout_uri_template atau cart_uri_template dan eligible_destinations yang dipilih dalam isi permintaan.

Berikut adalah contoh permintaan:

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"
  ]
}

Ganti {ACCOUNT_ID} dengan ID unik akun Merchant Center Anda.

Berikut adalah contoh respons dari panggilan yang berhasil:

{
  "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"
}

Mengambil setelan checkout

Untuk mengambil setelan checkout, termasuk template URL, tujuan yang dipilih, status pendaftaran, dan status peninjauan URL, gunakan metode checkoutSettings.get.

Berikut adalah contoh permintaan:

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

Berikut adalah contoh respons dari panggilan yang berhasil:

{
  "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"
}

Memperbarui setelan checkout

Untuk memperbarui setelan checkout, gunakan metode checkoutSettings.update. Sertakan kolom yang ingin diubah dalam isi permintaan dan tentukan kolom tersebut dalam parameter kueri update_mask.

update_mask mendukung kolom berikut:

  • eligible_destinations
  • uri_settings

Berikut adalah contoh permintaan yang memperbarui URL dan menghapus tujuan iklan:

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"
  ]
}

Berikut adalah contoh respons dari panggilan yang berhasil:

{
  "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"
}

Hapus

Untuk menghapus setelan checkout, gunakan metode checkoutSettings.delete.

Tindakan ini akan menghapus konfigurasi tingkat akun, membatalkan pendaftaran Anda dari program checkout, dan menghentikan link checkout agar tidak muncul di produk Anda di listingan gratis dan iklan Shopping.

Berikut adalah contoh permintaan:

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

Panggilan yang berhasil akan menampilkan isi respons kosong.

Anda memiliki dua cara untuk memberikan URL checkout untuk produk Anda:

  • Tingkat akun (sub-API atau Merchant Center): Untuk menentukan satu template URL, baik checkout_uri_template maupun cart_uri_template, Anda dapat menggunakan sub-API atau setelan Merchant Center. Template ini diterapkan ke semua produk Anda yang memenuhi syarat. Sebaiknya Anda memiliki URL yang konsisten di seluruh produk. Contoh, yourstore.com/checkout?id={id}.

  • Tingkat produk (Feed): Untuk memberikan URL checkout tertentu untuk setiap produk, gunakan atribut checkout_link_template di feed produk Anda. Hal ini memungkinkan URL yang disesuaikan per produk atau memungkinkan Anda menawarkan checkout hanya untuk sebagian inventaris.

  • Jika Anda menetapkan template URL tingkat akun menggunakan sub-API ini, pastikan Anda tidak mengirimkan nilai untuk atribut checkout_link_template di feed untuk produk tersebut.

  • Jika Anda menggunakan atribut feed checkout_link_template, pastikan Anda tidak menetapkan template URL tingkat akun menggunakan setelan sub-API atau Merchant Center. Anda masih dapat menggunakan sub-API untuk memilih eligible_destinations tanpa memberikan uri_settings jika Anda mengelola URL hanya melalui feed.

Template URL checkout

Dengan template URL checkout, Anda dapat menyertakan URL checkout di data produk, sehingga pembeli online dapat langsung membuka halaman checkout dari listingan Anda. File ini harus berisi placeholder parameter {ID} dan memiliki domain yang cocok.

Saat Anda menyiapkan link checkout menggunakan sub-API, gunakan kolom uri_settings. Kolom ini menerima salah satu dari dua template:

  • checkout_uri_template: Template URL yang, saat placeholder diisi, mengarahkan pengguna ke halaman checkout Anda dengan item tertentu yang siap dibeli.
  • cart_uri_template: Template URL yang mengarahkan pengguna ke halaman keranjang belanja Anda dengan item tertentu yang ditambahkan ke keranjang.

Contoh template

  • Checkout: https://www.your-store.com/checkout?item_id={id}
  • Keranjang: https://shop.your-store.com/add_to_cart?product_sku={id}

Pastikan untuk memenuhi persyaratan berikut:

  • Template URL Anda harus mengarah ke halaman yang valid di situs Anda yang cocok dengan domain terdaftar, berfungsi menggunakan metode HTTP GET, dan tidak mengharuskan pelanggan untuk login.
  • Domain dari template checkout yang diberikan harus cocok dengan domain produk.

Pelajari lebih lanjut