Anda harus memiliki akun Merchant Center yang aktif dan produk yang disetujui untuk listingan gratis di akun Anda. Untuk memulai, lihat artikel Pusat Bantuan berikut:
- Mulai menggunakan Merchant Center
- Cara mengupload produk ke Merchant Center
- Listingan gratis untuk produk
Setelah menyiapkan Merchant Center dengan produk, Anda harus menyelesaikan persyaratan di bagian ini sebelum membuat integrasi API.
1. Setelan Merchant Center
Pastikan setelan berikut dikonfigurasi di akun Google Merchant Center Anda:
1.1. Kebijakan pengembalian
Anda harus menentukan kebijakan pengembalian di Merchant Center, karena kebijakan ini merupakan persyaratan Penjual yang Tercatat dan akan dirujuk di layar checkout. Kebijakan yang dikonfigurasi berlaku secara global untuk akun Anda, meskipun Anda dapat menggunakan atribut feed return_policy_label untuk membatasi kebijakan pengembalian tertentu pada subset produk.
Jika akun Merchant Center Anda adalah akun tingkat lanjut, kebijakan pengembalian Anda harus dikonfigurasi di setiap sub-akun.
Anda harus menyertakan biaya pengembalian, kecepatan pengembalian (periode), dan link ke kebijakan lengkap. Baca selengkapnya tentang cara mengonfigurasi pengembalian di sini.
1.2. Info dukungan pelanggan
Anda harus menyetel informasi dukungan pelanggan di Merchant Center. Link ini akan digunakan untuk membuat link "Hubungi Penjual" di halaman konfirmasi pesanan. Baca selengkapnya tentang cara menyetel info dukungan pelanggan di sini.
2. Data produk
Anda harus memperbarui feed produk untuk menunjukkan kelayakan dan memberikan data kepatuhan. Informasi ini diperlukan untuk mengaktifkan checkout melalui UCP dengan Google, karena memungkinkan agen menentukan kelayakan produk, menghitung total biaya yang akurat, dan menampilkan peringatan hukum wajib kepada pengguna.
2.1. Kelayakan pembayaran agentic
Tindakan ini akan mengikutsertakan produk dalam pengalaman checkout di Google.
Hal ini diberikan menggunakan atribut produk native_commerce yang berisi satu
boolean. Jika disetel ke salah (false) atau tidak ada, produk tidak akan memenuhi syarat untuk checkout.
2.2. Peringatan produk
Atribut ini wajib diisi untuk item dengan persyaratan peringatan peraturan (misalnya, California Proposition 65). Anda bertanggung jawab untuk mematuhi semua hukum yang berlaku, termasuk persyaratan peringatan produk. Peringatan ini ditampilkan dengan jelas di layar Checkout saat Anda memberikannya.
Berikan grup atribut consumer_notice dengan dua sub-atribut:
consumer_notice_type: Harus salah satu darilegal_disclaimer,safety_warning, atauprop_65.consumer_notice_message: String (maks. 1.000 karakter). Tag HTML<b>,<br>, dan<i>diterima.
2.3. Kode produk
id di feed produk Anda harus cocok dengan ID produk yang diharapkan oleh
Checkout API Anda. Jika cocok, Anda tidak perlu melakukan tindakan apa pun. Jika tidak, gunakan atribut kustom
merchant_item_id untuk memetakannya.
2.4. Cara menambahkan atribut ke produk Anda
Contoh berikut menguraikan berbagai opsi untuk memberikan produk ke Merchant Center.
2.4.1. Feed
Sebaiknya buat sumber data tambahan (petunjuknya ada di sini). Anda dapat menambahkan ini ke feed utama, tetapi berhati-hatilah karena format yang salah dapat memengaruhi penyerapan produk reguler.
Catatan tentang Sintaksis: Pastikan string kompleks (seperti pesan Prop 65) tidak berisi karakter yang merusak format file Anda (seperti koma tambahan dalam CSV) kecuali jika di-escape dengan benar.
Format file teks:
| ID | native_commerce | consumer_notice |
|---|---|---|
| 11111 | TRUE | prop_65:This product can expose you... |
| 22222 | TRUE | |
| 33333 | FALSE |
Format XML:
<item>
<g:id>11111</g:id>
<g:native_commerce>TRUE</g:native_commerce>
<g:consumer_notice>
<g:consumer_notice_type>prop_65</g:consumer_notice_type>
<g:consumer_notice_message>
This product can expose you to chemicals...
</g:consumer_notice_message>
</g:consumer_notice>
</item>
<item>
<g:id>22222</g:id>
<g:native_commerce>TRUE</g:native_commerce>
</item>
<item>
<g:id>33333</g:id>
<g:native_commerce>FALSE</g:native_commerce>
</item>
2.4.2. Content API
Berikan atribut sebagai atribut khusus. Atribut ini harus disertakan dalam products.insert yang berisi produk lengkap, karena products.update tidak mendukung pembaruan customAttributes.
Contoh:
"customAttributes": [
{
"name": "native commerce",
"groupValues": [
{
"name": "checkout eligibility",
"value": "true"
}
]
},
{
"name": "consumer notice",
"groupValues": [
{
"name": "notice type",
"value": "prop_65"
},
{
"name": "notice message",
"value": "This product can expose you to chemicals..."
}
]
},
{
"name": "merchant item id",
"value": "some_checkout_item_id_1"
}
]
2.4.2. Merchant API
Berikan atribut sebagai atribut khusus. Anda dapat menambahkannya ke accounts.productInputs.insert yang sudah ada, atau memperbaruinya secara langsung menggunakan accounts.productInputs.patch.
Contoh untuk insert:
"customAttributes": [
{
"name": "native commerce",
"groupValues": [
{
"name": "checkout eligibility",
"value": "true"
}
]
},
{
"name": "consumer notice",
"groupValues": [
{
"name": "notice type",
"value": "prop_65"
},
{
"name": "notice message",
"value": "This product can expose you to chemicals..."
}
]
},
{
"name": "merchant item id",
"value": "some_checkout_item_id_1"
}
]
Contoh untuk update:
| Jenis | Nama | Nilai |
|---|---|---|
| Parameter jalur | productInput.name |
accounts/{account}/productInputs/en~US~11111 |
| Parameter kueri | updateMask |
customAttributes.native%20commerce,customAttributes.consumer%20notice,customAttributes.product%20fee,customAttributes.merchant%20item%20id |
dataSource |
dataSources/{datasource} |
{
"offerId": "11111",
"contentLanguage": "en",
"feedLabel": "US",
"customAttributes": [
{
"name": "native commerce",
"groupValues": [
{
"name": "checkout eligibility",
"value": "true"
}
]
},
{
"name": "consumer notice",
"groupValues": [
{
"name": "notice type",
"value": "prop_65"
},
{
"name": "notice message",
"value": "This product can expose you to chemicals..."
}
]
},
{
"name": "product fee",
"groupValues": [
{
"name": "product fee type",
"value": "US_AZ_TIRE_FEE"
},
{
"name": "product fee amount",
"value": "2.75 USD"
}
]
},
{
"name": "merchant item id",
"value": "some_checkout_item_id_1"
}
]
}
3. Pembatasan Produk
Kategori produk berikut tidak memenuhi syarat untuk checkout. Pastikan item ini memiliki native_commerce kosong atau ditetapkan ke false.
Produk keuangan dan model penagihan berulang
- Langganan: produk yang memerlukan siklus penagihan berulang.
- Cicilan: transaksi yang memerlukan rencana pembayaran atau pembiayaan yang diwajibkan penjual.
Barang yang dapat disesuaikan dan opsi pemenuhan pesanan
- Barang yang dipersonalisasi: item yang memerlukan keputusan desain khusus (misalnya, ukiran, monogram).
- Item non-baru atau penjualan akhir: barang refurbished, item bekas, dan item yang ditandai sebagai "Penjualan Akhir" (tidak ada pengembalian).
- Item praorder: produk dengan tanggal rilis mendatang dan pemenuhan yang ditangguhkan.
- Layanan paket: item yang memerlukan kontrak tambahan, seperti garansi, pemasangan, atau penyiapan.
- Pengiriman khusus: item yang memerlukan biaya pengiriman non-standar (misalnya, kargo, pengiriman premium).
- Pemberian hadiah: transaksi yang memerlukan logistik invoice terpisah atau harga tersembunyi untuk penerima.
- Aktivasi di toko: produk yang harus diaktifkan secara fisik di lokasi retail.
Pembatasan kebijakan dan keamanan
- Dibatasi usia: item yang memerlukan verifikasi tanda pengenal (misalnya, Alkohol, Tembakau).
- Konten terlarang: senjata, konten dewasa, kesehatan/farmasi, produk palsu, atau kategori lain yang diblokir oleh Kebijakan Google Shopping standar.
Barang dan layanan digital
- Layanan: pelajaran, kelas online, dan paket perjalanan (kecuali jika terintegrasi menggunakan jalur Perjalanan tertentu).
- Penyewaan: penyewaan film, penyewaan peralatan, atau sewa beli.
- Item virtual: mata uang dalam game, item MMORPG, atau skin.
- Dependensi software: barang yang mewajibkan pengguna menginstal software tertentu sebelum menyelesaikan pembelian.