Halaman ini diterjemahkan oleh Cloud Translation API.

Tingkat Keparahan masalah dan Diagnostik Merchant Center

Misalkan Anda ingin mendapatkan informasi tentang produk yang saat ini tersedia di menggunakan akun layanan. Secara khusus, Anda tertarik untuk mengetahui apakah produk memiliki masalah yang perlu ditangani. Anda tahu cara mendapatkan informasi ini dari Merchant Center, tetapi Anda ingin menyiapkan sistem peringatan otomatis menggunakan Content API. Dalam panduan ini, kami akan membahas tingkat keparahan masalah informasi di Content API akan memetakan ke prioritas masalah yang terlihat di Laporan diagnostik di Merchant Center.

Contoh dengan Content API

Untuk memunculkan 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 Merchant Center error akun. Critical error akan menyebabkan penangguhan akun, yang juga mencegah penayangan produk Anda.

Di bagian itemLevelIssues, Anda dapat melihat error produk yang dapat menyebabkan produk penolakan. Perlu diketahui bahwa itemLevelIssues[].numItems memberi tahu Anda bahwa 2 item di akun Anda dipengaruhi oleh link gambar yang rusak, dan 5 item memiliki error halaman landing.

Pada bagian itemLevelIssues[].servability, Anda dapat melihat apakah error tersebut menyebabkan produk yang terpengaruh menjadi ditolak. Perhatikan bahwa baik tautan 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. Metode ini menghasilkan entri seperti berikut ini:

 {
  "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 kita, Anda dapat menggunakan itemLevelIssues[].servability untuk menemukan apakah {i>error<i} mematikan kemampuan Anda untuk menayangkan produk Beli dengan Google, Iklan Shopping, atau Platform Google.

Jika itemLevelIssues[].servability unaffected seperti ambiguous_gtin error, error tersebut tidak akan mencegah produk Anda menyeluruh.

Namun, jika itemLevelIssues[].servability adalah disapproved seperti mobile_landing_page_crawling_not_allowed error, ini jauh lebih kesalahan serius karena Anda tidak dapat menayangkan produk hingga kesalahan tersebut diperbaiki.

Dalam contoh accountstatuses kita, di bagian accountLevelIssues[].severity, Bagian diagnostik di Merchant Center menentukan prioritas masalah dan arti perbedaan prioritas yang berbeda-beda.

Pertama, lihat laporan:

Laporan diagnostik dari Merchant Center

Bagaimana semua informasi yang Anda peroleh dari Content API for Shopping sesuai dengan apa yang Anda lihat di bagian Diagnostik? Entri mana yang merupakan masalah yang perlu Anda perbaiki sesegera mungkin, dan yang mana yang bagus untuk ditangani, tetapi tidak penting untuk diperbaiki? Masalah mana apakah produk Anda akan berhenti ditayangkan 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 menjadi tiga kategori berdasarkan tingkat keparahan masalah. Memahami cara menilai tingkat keparahan masalah dikembalikan dari layanan terkait status dapat membantu menentukan dengan cepat masalah mana yang paling penting untuk ditangani, dan masalah mana yang dapat diabaikan dengan aman.

Penentuan prioritas masalah

Di bagian Diagnostik, prioritas masalah menjelaskan masalah tingkat keparahan sebagai salah satu dari tiga tingkat berikut: error, peringatan, dan notifikasi. Di beberapa dalam tabel laporan seperti di atas, tingkat ini diwakili oleh gambar yang muncul dalam kolom: Error untuk kesalahan, untuk peringatan, dan untuk notifikasi.

Error dapat menyebabkan penangguhan akun atau penolakan item. Mereka harus diselesaikan sesegera mungkin untuk memastikan item memenuhi syarat untuk ditampilkan dalam hasil.
Peringatan dapat berdampak negatif terhadap performa iklan Anda dan kemungkinan akan dapat menyebabkan penangguhan item atau akun di masa mendatang kecuali masalahnya diselesaikan.
Notifikasi adalah pengoptimalan yang disarankan untuk meningkatkan kualitas data. Menyelesaikan masalah tersebut direkomendasikan, 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. Kolom ini dapat berisi salah satu dari tiga nilai: critical, error, dan suggestion.

Nilai-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 memungkinkan Anda tahu bahwa Anda perlu menautkan akun Google Ads untuk menayangkan iklan, tetapi memengaruhi persetujuan produk di database Merchant Center Anda. Di sisi lain, editorial_and_professional_standards_destination_url_down_policy adalah error yang lebih serius, yang membuat akun Anda ditangguhkan. Jika Anda berpartisipasi di Beli dengan Google, Platform Google, atau jika Anda telah menautkan Google Ads Anda, error critical menghentikan produk Anda ditayangkan di Program Beli dengan Google, Platform Google, dan Iklan Shopping secara langsung.

Berbekal informasi ini, Anda sekarang dapat menulis perangkat lunak peringatan yang akan segera sampaikan masalah penting kepada Anda sambil mengumpulkan lebih sedikit masalah serius yang akhirnya perlu diperbaiki, tanpa harus membuka Merchant Center untuk membedakan keduanya.