Misalkan Anda ingin mendapatkan informasi tentang produk yang saat ini tersedia di akun Anda. Secara khusus, Anda tertarik untuk mengetahui apakah ada produk yang memiliki masalah yang perlu ditangani. Anda mengetahui cara mendapatkan informasi ini dari Merchant Center, tetapi Anda ingin menyiapkan sistem pemberitahuan otomatis menggunakan Content API. Dalam panduan ini, kami akan membahas cara informasi tingkat keparahan masalah di Content API dipetakan ke prioritas masalah yang terlihat dalam laporan Diagnostik di Merchant Center.
Contoh dengan Content API
Untuk menemukan masalah yang memengaruhi produk, Anda dapat menjalankan accountstatuses.get untuk akun Anda. Berikut adalah contoh potongan resource yang Anda dapatkan kembali:
{
"kind": "content#accountStatus",
"accountId": "...",
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
}
]
},
...
}
Di bagian accountLevelIssues[].severity, Anda akan melihat tingkat keparahan error akun Merchant Center. Error Critical akan menyebabkan penangguhan akun, yang akan menghentikan penayangan produk Anda.
Pada bagian itemLevelIssues, Anda dapat melihat error produk yang dapat menyebabkan penolakan
produk. Perlu diperhatikan bahwa itemLevelIssues[].numItems memberi tahu Anda bahwa 2 item
di akun Anda terpengaruh oleh link gambar yang rusak, dan 5 item memiliki
error halaman landing.
Di bagian itemLevelIssues[].servability, Anda dapat melihat apakah error tersebut menyebabkan produk yang terpengaruh tidak disetujui. Perhatikan bahwa link gambar yang rusak dan error halaman landing menyebabkan produk tidak disetujui.
Untuk menemukan semua produk yang terpengaruh, panggil
Productstatuses.list
untuk mendapatkan daftar masalah lengkap per produk. Kueri tersebut akan menampilkan
entri seperti berikut:
{
"kind": "content#productstatusesListResponse",
...
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
...
"itemLevelIssues": [
{
"code": "mobile_landing_page_crawling_not_allowed",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Mobile page not crawlable due to robots.txt",
"detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
"documentation": "https://support.google.com/merchants/answer/6098296"
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694"
},
{
"code": "ambiguous_gtin",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "gtin",
"destination": "Shopping",
"description": "Ambiguous value [gtin]",
"detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
"documentation": "https://support.google.com/merchants/answer/7000891"
}
],
...
},
...
]
}
Sekarang Anda memiliki informasi tentang masalah untuk semua produk di akun Anda, tetapi tidak jelas seberapa penting memperbaiki masalah ini.
Dalam contoh productstatuses, Anda dapat menggunakan itemLevelIssues[].servability
untuk mengetahui apakah error menonaktifkan kemampuan Anda untuk menayangkan produk di
Beli dengan Google, Iklan Shopping, atau Platform Google.
Jika itemLevelIssues[].servability adalah unaffected seperti
error ambiguous_gtin, error tersebut tidak akan mencegah produk Anda
ditayangkan.
Namun, jika itemLevelIssues[].servability adalah disapproved seperti
error mobile_landing_page_crawling_not_allowed, ini merupakan error
yang jauh lebih serius karena Anda tidak dapat menayangkan produk sampai error tersebut diperbaiki.
Dalam contoh accountstatuses, di bagian accountLevelIssues[].severity, bagian Diagnostik di Merchant Center menentukan prioritas masalah dan arti berbagai prioritas yang berbeda-beda.
Pertama, lihat laporan:
Bagaimana semua informasi yang Anda dapatkan dari Content API for Shopping berhubungan dengan hal yang Anda lihat di bagian Diagnostik? Entri manakah yang merupakan masalah yang perlu segera diperbaiki, dan masalah mana yang sebaiknya ditangani, tetapi tidak penting untuk diperbaiki? Masalah mana yang akan menghentikan penayangan produk Anda di iklan jika tidak ditangani?
Seperti yang ditunjukkan dalam contoh ini, bagian Diagnostik memberikan informasi tingkat keparahan
masalah untuk akun dan produk pada akun tersebut, sedangkan Content API
(melalui layanan Accountstatuses) hanya memberikan informasi tingkat keparahan
untuk masalah accountLevel.
Setiap sumber membagi masalah menjadi tiga kategori berdasarkan tingkat keparahan masalah. Memahami cara menilai tingkat keparahan masalah yang ditampilkan dari layanan terkait status dapat membantu menentukan dengan cepat masalah mana yang paling penting untuk diatasi, dan masalah mana yang dapat diabaikan dengan aman.
Penentuan prioritas masalah
Di bagian Diagnostik, prioritas masalah menjelaskan tingkat keparahan masalah sebagai salah satu dari tiga tingkat berikut: error, peringatan, dan notifikasi. Dalam
tabel laporan seperti di atas, tingkat ini diwakili oleh gambar yang
muncul di kolom
pertama:
untuk
error,
untuk
peringatan,
dan
untuk notifikasi.
Error dapat menyebabkan penangguhan akun atau penolakan item. Masalah ini harus diselesaikan sesegera mungkin untuk memastikan item memenuhi syarat untuk ditampilkan lagi di hasil penelusuran.
Peringatan dapat berdampak negatif pada performa iklan dan kemungkinan akan menyebabkan penangguhan item atau akun di masa mendatang, kecuali jika masalah tersebut diselesaikan.
Notifikasi adalah pengoptimalan yang disarankan untuk meningkatkan kualitas data. Sebaiknya selesaikan masalah ini, tetapi tidak wajib.
Namun, kami tidak perlu membuka Merchant Center untuk mencari tahu error mana yang terjadi.
Di Content API, kolom accountLevelIssues[].severity di
objek resource accountstatuses memberikan informasi
tingkat keparahan masalah yang sama. Kolom ini dapat berisi salah satu dari tiga nilai:
critical, error, dan suggestion.
Nilai ini memiliki korespondensi one-to-one dengan prioritas masalah pada tab Diagnostik:
| Tingkat Keparahan Masalah Kualitas Data (API) | Prioritas Masalah |
|---|---|
critical |
Kesalahan () |
error |
Peringatan () |
suggestion |
Notifikasi () |
Jadi, dalam contoh accountstatuses, masalah missing_ad_words_link memberi tahu Anda bahwa Anda perlu menautkan akun Google Ads untuk menayangkan iklan, tetapi tidak akan memengaruhi persetujuan produk di database Merchant Center Anda.
Di sisi lain, editorial_and_professional_standards_destination_url_down_policy adalah
error yang lebih parah yang menangguhkan akun Anda. Jika Anda berpartisipasi
dalam Beli dengan Google, Platform Google, atau jika Anda memiliki akun Google Ads
tertaut, error critical akan menghentikan produk Anda langsung ditayangkan di
program Beli dengan Google, Platform Google, dan Iklan Shopping.
Berbekal informasi ini, Anda kini dapat menulis software pemberitahuan yang akan segera melaporkan masalah penting sekaligus mengumpulkan masalah yang tidak terlalu serius untuk diperbaiki, tanpa harus membuka Merchant Center untuk membedakan mana yang mana.