Mengelola setelan checkout

Fitur checkout mempercepat pembelian bagi pelanggan yang siap membeli dengan mengizinkan mereka membuka halaman keranjang atau checkout situs Anda langsung 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 dalam program fitur checkout secara terprogram.

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

Prasyarat

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

  • Anda harus disetujui untuk 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 di isi permintaan.

Berikut 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 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 contoh permintaan:

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

Berikut 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 Anda ubah di isi permintaan dan tentukan kolom tersebut dalam parameter kueri update_mask.

update_mask mendukung kolom berikut:

  • eligible_destinations
  • uri_settings

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

Menghapus

Untuk menghapus setelan checkout, gunakan metode checkoutSettings.delete.

Tindakan ini akan menghapus konfigurasi tingkat akun Anda, membatalkan pendaftaran Anda dari program checkout, dan menghentikan tampilan link checkout pada produk Anda di listingan gratis dan Iklan Shopping.

Berikut 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 atau cart_uri_template, Anda dapat menggunakan setelan sub-API atau Merchant Center. Template ini diterapkan ke semua produk Anda yang memenuhi syarat. Sebaiknya Anda memiliki URL yang konsisten di seluruh produk Anda. Misalnya, 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 Anda.

  • Jika Anda menetapkan template URL tingkat akun menggunakan sub-API ini, pastikan Anda tidak mengirimkan nilai untuk atribut checkout_link_template di feed Anda 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. Template ini harus berisi placeholder parameter {ID} dan memiliki domain yang cocok.

Saat 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, akan 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 Anda memenuhi persyaratan berikut:

  • Template URL Anda harus mengarah ke halaman yang valid di situs Anda yang cocok dengan domain terdaftar Anda, 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