Misalnya, Anda ingin mendapatkan informasi tentang produk yang saat ini tersedia di akun Anda. Secara khusus, Anda tertarik untuk mengetahui apakah ada masalah pada produk Anda yang perlu ditangani. Anda tahu cara mendapatkan informasi ini dari Merchant Center, tetapi Anda lebih memilih untuk menyiapkan sistem pemberitahuan otomatis menggunakan Content API. Dalam panduan ini, kita 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 mendapatkan masalah yang memengaruhi produk Anda, Anda dapat menjalankan
accountstatuses.get
untuk akun Anda. Berikut adalah contoh singkat 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. Critical akan menyebabkan penangguhan akun, yang akan menghentikan Anda menayangkan produk.
Di bagian itemLevelIssues, Anda dapat melihat error produk yang dapat menyebabkan penolakan produk. Perhatikan bahwa itemLevelIssues[].numItems memberi tahu Anda bahwa 2 item
di akun Anda terpengaruh oleh link gambar yang rusak, dan 5 item mengalami
error halaman landing.
Di bagian itemLevelIssues[].servability, Anda dapat melihat apakah error tersebut menyebabkan produk yang terpengaruh ditolak. Perhatikan bahwa link gambar rusak dan
error halaman landing menyebabkan produk ditolak.
Untuk menemukan semua produk yang terpengaruh, Anda dapat memanggil
Productstatuses.list
untuk mendapatkan daftar lengkap masalah berdasarkan per produk. Responsnya 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 pentingnya memperbaiki masalah ini.
Dalam contoh productstatuses, Anda dapat menggunakan itemLevelIssues[].servability
untuk mengetahui apakah error membuat Anda tidak dapat menayangkan produk di
Beli di Google, Iklan Shopping, atau Platform Google.
Jika itemLevelIssues[].servability sama dengan unaffected seperti error
ambiguous_gtin, error tersebut tidak akan mencegah produk Anda ditayangkan.
Namun, jika itemLevelIssues[].servability sama dengan disapproved seperti error
mobile_landing_page_crawling_not_allowed, ini adalah error yang jauh lebih
serius karena Anda tidak dapat menayangkan produk hingga error diperbaiki.
Dalam contoh accountstatuses kami, di bagian accountLevelIssues[].severity, bagian Diagnostik
di Merchant Center menentukan prioritas masalah
dan secara tepat apa arti berbagai prioritas tersebut.
Pertama, lihat laporan:
Bagaimana korelasi semua informasi yang Anda dapatkan dari Content API for Shopping dengan informasi yang Anda lihat di bagian Diagnostik? Entri mana yang merupakan masalah yang harus segera Anda perbaiki, dan entri mana yang sebaiknya diperbaiki, tetapi tidak penting untuk diperbaiki? Masalah apa yang akan menghentikan penayangan produk Anda di iklan jika tidak ditangani?
Seperti yang ditunjukkan dalam contoh ini, bagian Diagnostik memberikan informasi tingkat keparahan tentang masalah untuk akun dan produk di akun tersebut, sementara Content API (melalui layanan Accountstatuses) memberikan informasi tingkat keparahan hanya untuk masalah accountLevel.
Setiap sumber membagi masalah ke dalam tiga kategori berdasarkan tingkat keparahan masalah. Memahami cara menilai tingkat keparahan masalah yang ditampilkan dari layanan terkait status dapat membantu dengan cepat menentukan masalah mana yang paling penting untuk ditangani, 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: error, peringatan, dan notifikasi. Dalam
tabel laporan seperti di atas, tingkat ini direpresentasikan oleh gambar yang
muncul di kolom
pertama:
untuk
error,
untuk
peringatan,
dan
untuk notifikasi.
Error telah menyebabkan penangguhan akun atau penolakan item. Error tersebut harus diselesaikan sesegera mungkin untuk memastikan item memenuhi syarat agar muncul kembali di hasil penelusuran.
Peringatan dapat berdampak negatif pada performa iklan Anda dan kemungkinan akan menyebabkan penangguhan item atau akun di masa mendatang, kecuali jika masalahnya diselesaikan.
Notifikasi adalah pengoptimalan yang disarankan untuk meningkatkan kualitas data. Sebaiknya selesaikan masalah ini, tetapi tidak wajib.
Namun, kita tidak perlu membuka Merchant Center untuk mengetahui jenis errornya.
Di Content API, kolom accountLevelIssues[].severity dalam 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 satu-ke-satu dengan prioritas masalah di tab Diagnostik:
| Tingkat Keparahan Masalah Kualitas Data (API) | Penentuan Prioritas Masalah |
|---|---|
critical |
Error () |
error |
Peringatan () |
suggestion |
Notifikasi () |
Jadi, dalam contoh accountstatuses kami, 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, pelanggaran
editorial_and_professional_standards_destination_url_down_policy adalah
error yang lebih berat yang menangguhkan akun Anda. Jika Anda berpartisipasi
dalam Beli di Google, Platform di Google, atau jika Anda memiliki akun Google Ads yang tertaut, error critical akan menghentikan penayangan produk Anda di program Beli di Google, Platform di Google, dan Iklan Shopping secara langsung.
Dengan informasi ini, Anda kini dapat menulis software pemberitahuan yang akan segera memberi tahu Anda tentang masalah penting sekaligus mengumpulkan masalah yang kurang serius untuk diperbaiki nanti, tanpa harus membuka Merchant Center untuk membedakan masalah yang penting dan yang tidak.