فرض کنید میخواهید اطلاعاتی در مورد محصولاتی که در حال حاضر در حساب کاربری شما موجود است، دریافت کنید. به طور خاص، شما علاقهمند به دانستن این هستید که آیا هیچ یک از محصولات شما دارای مشکلاتی هستند که نیاز به رسیدگی دارند یا خیر. شما میدانید که چگونه این اطلاعات را از مرکز فروشندگان دریافت کنید، اما ترجیح میدهید یک سیستم هشدار خودکار با استفاده از API محتوا راهاندازی کنید. در این راهنما، ما بررسی خواهیم کرد که چگونه اطلاعات شدت مشکل در API محتوا با اولویتبندی مشکل مشاهده شده در گزارشهای تشخیصی در مرکز فروشندگان مطابقت دارد.
مثال با API محتوا
برای دریافت مشکلاتی که روی محصولات شما تأثیر میگذارند، میتوانید accountstatuses.get برای حساب خود اجرا کنید. در اینجا یک مثال خلاصه از منبعی که بازیابی میکنید، آورده شده است:
{
"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"
}
]
},
...
}
در قسمت accountLevelIssues[].severity ، شدت خطاهای حساب مرکز فروشندگان را مشاهده میکنید. خطاهای Critical باعث تعلیق حساب میشوند که مانع از ارائه محصولات شما خواهد شد.
در زیر itemLevelIssues ، میتوانید خطاهای محصول را که میتوانند منجر به عدم تایید محصول شوند، مشاهده کنید. توجه داشته باشید که itemLevelIssues[].numItems به شما اطلاع میدهد که ۲ مورد در حساب شما تحت تأثیر لینک تصویر خراب قرار دارند و ۵ مورد دارای خطای صفحه فرود هستند.
در زیر itemLevelIssues[].servability میتوانید ببینید که آیا این خطا باعث عدم تأیید محصولات آسیبدیده میشود یا خیر. توجه داشته باشید که هم لینک تصویر خراب و هم خطای صفحه فرود باعث عدم تأیید محصولات میشوند.
برای یافتن تمام محصولات آسیبدیده، تابع Productstatuses.list را فراخوانی میکنید تا لیست کاملی از مشکلات را بر اساس هر محصول دریافت کنید. این تابع ورودیهایی مانند موارد زیر را برمیگرداند:
{
"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"
}
],
...
},
...
]
}
اکنون شما اطلاعاتی در مورد مشکلات مربوط به همه محصولات موجود در حساب خود دارید، اما مشخص نیست که رفع این مشکلات چقدر اهمیت دارد.
در مثال productstatuses ما، میتوانید از itemLevelIssues[].servability برای کشف اینکه آیا خطایی توانایی شما را برای ارائه محصول در خرید در گوگل، تبلیغات خرید یا سطوح در سراسر گوگل غیرفعال میکند یا خیر، استفاده کنید.
اگر itemLevelIssues[].servability مانند خطای ambiguous_gtin unaffected قرار نگیرد، این خطا مانع از ارائه محصول شما نخواهد شد.
با این حال، اگر itemLevelIssues[].servability مانند خطای mobile_landing_page_crawling_not_allowed disapproved ، این یک خطای بسیار جدیتر است زیرا تا زمانی که خطا برطرف نشود، نمیتوانید محصول خود را ارائه دهید.
در مثال accountstatuses ما، در بخش accountLevelIssues[].severity ، بخش Diagnostics در مرکز فروشندگان، اولویتبندی مشکلات و معنای دقیق اولویتهای مختلف را تعریف میکند.
ابتدا به گزارش توجه کنید:
چگونه تمام اطلاعاتی که از API محتوا برای خرید دریافت میکنید با آنچه در بخش تشخیصها میبینید، مرتبط است؟ کدام ورودیها مشکلاتی هستند که باید در اسرع وقت برطرف شوند و کدام یک خوب است که برطرف شوند، اما رفع آنها ضروری نیست؟ کدام مشکلات در صورت عدم رسیدگی، مانع از نمایش محصولات شما در تبلیغاتتان میشوند؟
همانطور که در این مثالها نشان داده شده است، بخش تشخیصها (Diagnostics) اطلاعات شدت مشکل را در مورد مشکلات مربوط به حساب و محصولات موجود در آن حساب ارائه میدهد، در حالی که API محتوا (از طریق سرویس Accountstatuses ) اطلاعات شدت مشکل را صرفاً برای مشکلات accountLevel ارائه میدهد.
هر منبع، مشکلات را بر اساس شدت آنها به سه دسته تقسیم میکند. درک چگونگی قضاوت در مورد شدت مشکلات گزارششده از سرویسهای مرتبط با وضعیت، میتواند به سرعت به تشخیص اینکه کدام مشکلات برای رسیدگی مهمتر هستند و کدام مشکلات را میتوان با خیال راحت نادیده گرفت، کمک کند.
اولویتبندی مسائل
در بخش تشخیص، اولویتبندی مشکل، شدت مشکل را به عنوان یکی از سه سطح توصیف میکند: خطاها، هشدارها و اعلانها. در جداول گزارش مانند جدول بالا، این سطوح با تصاویری که در ستون اول ظاهر میشوند، نمایش داده میشوند: 
برای خطاها، 
برای هشدارها، و 
برای اعلانها.
خطاها یا باعث تعلیق حساب کاربری یا عدم تأیید کالا شدهاند. این خطاها باید در اسرع وقت برطرف شوند تا اطمینان حاصل شود که کالاها دوباره واجد شرایط نمایش در نتایج هستند.
هشدارها میتوانند تأثیر منفی بر عملکرد تبلیغات شما داشته باشند و احتمالاً در آینده منجر به مسدود شدن کالا یا حساب کاربری شما میشوند، مگر اینکه مشکل حل شود.
اعلانها، بهینهسازیهای پیشنهادی برای افزایش کیفیت دادهها هستند. حل این مشکلات توصیه میشود، اما الزامی نیست.
با این حال، برای فهمیدن اینکه کدام خطاها مربوط به کدام هستند، نیازی به مراجعه به مرکز فروشندگان نداریم. در API محتوا، فیلد accountLevelIssues[].severity در اشیاء منبع accountstatuses همان اطلاعات شدت مشکل را ارائه میدهد. این فیلدها میتوانند شامل یکی از سه مقدار باشند: critical ، error و suggestion .
این مقادیر با اولویتبندی مسئله در برگه تشخیص، تناظر یک به یک دارند:
| شدت مشکل کیفیت داده (API) | اولویتبندی مسائل |
|---|---|
critical | خطا ( ) |
error | هشدار ( ) |
suggestion | اطلاع رسانی ( ) |
بنابراین در مثال accountstatuses ما، مشکل missing_ad_words_link به شما اطلاع میدهد که برای نمایش تبلیغات باید یک حساب Google Ads را پیوند دهید، اما این موضوع بر تأیید محصول در پایگاه داده مرکز فروشندگان شما تأثیری نخواهد گذاشت. از سوی دیگر، editorial_and_professional_standards_destination_url_down_policy یک خطای شدیدتر است که حساب شما را به حالت تعلیق در میآورد. اگر در برنامههای Buy on Google، Surfaces across Google شرکت میکنید یا اگر یک حساب Google Ads پیوند شده دارید، یک خطای critical بلافاصله مانع از نمایش محصولات شما در برنامههای Buy on Google، Surfaces across Google و Shopping Ads میشود.
با در دست داشتن این اطلاعات، اکنون میتوانید نرمافزار هشداردهندهای بنویسید که مسائل مهم را فوراً به شما اطلاع دهد و در عین حال مسائل کماهمیتتر را برای رفع نهایی جمعآوری کند، بدون اینکه لازم باشد برای تشخیص اینکه کدام یک مربوط به کدام است، به مرکز فروشندگان مراجعه کنید.