رفع خطاهای اسکیما در سرچ کنسول (Error, Warning, Invalid)

راهنمای جامع رفع خطاهای اسکیما: عیب‌یابی گزارش Enhancements سرچ کنسول

برای «سارا»، مدیر بازاریابی فنی، پیاده‌سازی اسکیما تازه آغاز مسیر است. شما کد JSON-LD را برای اسکیما Article، Product یا FAQ در سایت قرار می‌دهید، اما کار در اینجا تمام نمی‌شود. چالش واقعی، «نگهداری» (Maintenance) و «عیب‌یابی» (Troubleshooting) است. اینجاست که گزارش‌های سرچ کنسول گوگل به مهم‌ترین ابزار شما تبدیل می‌شوند.

نادیده گرفتن خطاهای اسکیما در سرچ کنسول به معنای نادیده گرفتن بازخورد مستقیم گوگل است. این خطاها به شما می‌گویند که گوگل یا نمی‌تواند کد شما را بخواند (Parsing error) یا اطلاعات حیاتی را در آن پیدا نمی‌کند (Missing field). تسلط بر رفع خطاهای اسکیما به معنای تضمین این است که تلاش‌های شما برای کسب ریچ اسنیپت و سیگنال‌دهی E-E-A-T به ثمر می‌نشیند.

چگونه خطاهای اسکیما را در سرچ کنسول پیدا کنیم؟ (گزارش Enhancements)

اولین قدم در عیب یابی اسکیما، دانستن این است که کجا را باید نگاه کنید. برخلاف تصور رایج، خطاهای اسکیما معمولاً در گزارش Coverage سرچ کنسول (که بر ایندکس شدن URL تمرکز دارد) ظاهر نمی‌شوند.

خطاهای داده‌های ساختاریافته در بخش «Enhancements» (بهبودها) در نوار کناری سرچ کنسول گوگل (GSC) زندگی می‌کنند. این بخش پویا است؛ یعنی فقط زمانی ظاهر می‌شود که گوگل انواع خاصی از اسکیما را در سایت شما شناسایی کند. اگر شما اسکیما FAQ را پیاده‌سازی کرده باشید، گزارشی به نام “FAQ” در این بخش خواهید دید. اگر اسکیما Product داشته باشید، گزارش “Product snippets” ظاهر می‌شود.

این گزارش‌ها، به اصطلاح خطاهای Rich Results را نشان می‌دهند و کارنامه سلامت اسکیمای شما هستند. گوگل URLهای شما را به سه دسته تقسیم می‌کند:

1. Error (خطا – قرمز): بحرانی‌ترین بخش. این URLها به دلیل یک خطای اساسی، واجد شرایط هیچ‌گونه ریچ اسنیپتی *نیستند*. رفع خطاهای اسکیما باید از اینجا شروع شود.
2. Valid with warnings (معتبر با هشدار – زرد): این URLها واجد شرایط هستند، اما گوگل فیلدهای «توصیه‌شده» (Recommended) را پیدا نکرده است. رفع این موارد می‌تواند شانس شما را برای نمایش ریچ اسنیپت افزایش دهد.
3. Valid (معتبر – سبز): هدف نهایی. این URLها دارای اسکیمای معتبر هستند و هیچ مشکلی ندارند.

وظیفه «سارا» به عنوان مدیر فنی، به صفر رساندن نمودار «Error» و به حداقل رساندن نمودار «Valid with warnings» است.

تحلیل عمیق خطاهای اسکیما: درک زبان گوگل

وقتی GSC یک «خطا» را گزارش می‌دهد، درک دقیق معنای آن برای عیب یابی اسکیما ضروری است. خطاهای اسکیما در سرچ کنسول به طور کلی به دو خانواده بزرگ تقسیم می‌شوند: خطاهای سینتکس (کد شما شکسته است) و خطاهای اعتبارسنجی (کد شما کار می‌کند، اما ناقص است).

دسته اول: خطاهای مرگبار سینتکس (Parsing Errors)

اینها بدترین نوع خطا هستند. Parsing error اسکیما به این معناست که گوگل‌بات حتی قادر به خواندن و «تجزیه» (Parse) کد JSON-LD شما نیست. این مثل این است که یک کتاب با صفحات به هم چسبیده به گوگل بدهید. گوگل بلافاصله آن را رها می‌کند.

۱. خطای Parsing error (خطای تجزیه)

این خطا تقریباً همیشه یک خطای سینتکس (Syntax Error) در کد اسکیما JSON-LD شماست. JSON-LD به کاما، براکت و گیومه بسیار حساس است. یک کاراکتر اشتباه کل ساختار را از بین می‌برد.

نمونه‌های رایج Parsing error اسکیما:

خطای کامای اضافه (Trailing Comma):
این رایج‌ترین خطای Parsing error اسکیما است. شما یک کاما در انتهای آخرین مورد یک لیست یا شیء قرار می‌دهGید.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "سوال اول؟",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "پاسخ اول."
      }
    },  <!-- این کاما صحیح است -->
    {
      "@type": "Question",
      "name": "سوال دوم؟",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "پاسخ دوم."
      }
    },  <!-- !! خطای تجزیه !! -->
  ]
}

خطای کامای جا افتاده (Missing Comma):
فراموش کردن قرار دادن کاما بین دو فیلد یا دو آیتم در یک لیست.

{
  "@type": "Article",
  "headline": "عنوان مقاله"  <!-- !! خطای تجزیه !! -->
  "author": {
    "@type": "Person",
    "name": "سارا"
  }
}

خطای گیومه یا براکت بسته نشده:
(مانند "name": "سارا به جای "name": "سارا" یا فراموش کردن } یا ] نهایی).

نحوه رفع Parsing error: گزارش GSC در نشان دادن *محل* دقیق این نوع خطاها بسیار ضعیف عمل می‌کند. برای عیب یابی اسکیما سینتکس، شما *باید* از ابزارهای تست اسکیما خارجی، به خصوص Schema.org Validator، استفاده کنید که دقیقاً به شما می‌گوید کدام خط کد شکسته است.

۲. خطای Unparsable structured data (داده‌های ساختاریافته غیرقابل تجزیه)

خطای Unparsable structured data مشابه Parsing error است اما اغلب عمومی‌تر است. این یعنی گوگل یک چیزی را پیدا کرده که *شبیه* اسکیما است، اما به هیچ وجه نمی‌تواند آن را بفهمد. دلایل رایج عبارتند از:

• اشتباه تایپی در نوع اسکریپت (مثلاً <script type="application/json"> به جای <script type="application/ld+json">).
• تزریق کد HTML (مانند <div>) در داخل اسکریپت JSON-LD.
• تداخل شدید پلاگین‌ها؛ مثلاً زمانی که دو پلاگین سئو سعی می‌کنند دو اسکیما Article متفاوت را در یک صفحه تزریق کنند و کدها با هم تداخل پیدا می‌کنند.

اینجاست که اهمیت کدنویسی تمیز وردپرس و استفاده از پلاگین‌های استاندارد مشخص می‌شود. یک پلاگین ضعیف می‌تواند کل خطاهای گزارش Enhancements شما را پر کند.

— پایان بخش ۱ —

دسته دوم: خطاهای اعتبارسنجی (Validation Errors)

این دسته از خطاهای اسکیما در سرچ کنسول، در واقع خبرهای خوبی هستند. این یعنی گوگل کد شما را با موفقیت «تجزیه» (Parse) کرده است! کد شما از نظر فنی شکسته نیست، اما از نظر «معنایی» (Semantically) ناقص است. گوگل کد شما را درک کرده، اما می‌گوید اطلاعات کافی برای کاری که می‌خواهید (مثلاً … ریچ اسنیپت) در آن وجود ندارد.

۱. خطای Missing field (فیلد اجباری حذف شده)

این رایج‌ترین خطا در خطاهای گزارش Enhancements است. Missing field اسکیما دقیقاً همان چیزی است که به نظر می‌رسد: گوگل برای واجد شرایط بودن یک نوع اسکیما خاص (مثلاً Product) به چند فیلد «اجباری» (Required) نیاز دارد و شما یکی از آن‌ها را ارائه نکرده‌اید.

نمونه‌های کلاسیک Missing field اسکیما:

خطا: Missing field "offers" (در اسکیما Product)
معنای فنی: گوگل می‌گوید: “من می‌بینم که این یک محصول است، اما تو قیمت یا وضعیت موجودی (offers) را به من نگفته‌ای. بنابراین، من نمی‌توانم ریچ اسنیپت قیمت را نشان دهم.” این یکی از حیاتی‌ترین خطاهای Rich Results است.

خطا: Missing field "headline" (در اسکیما Article)
معنای فنی: شما یک اسکیما Article تعریف کرده‌اید، اما فیلد اجباری headline (عنوان) را فراموش کرده‌اید. گوگل نمی‌تواند آن را به عنوان یک مقاله معتبر بپذیرد.

خطا: Missing field "acceptedAnswer" (در اسکیما FAQPage)
معنای فنی: شما یک Question تعریف کرده‌اید، اما acceptedAnswer (پاسخ پذیرفته‌شده) را برای آن ارائه نکرده‌اید. هر سوال باید یک پاسخ داشته باشد.

نحوه رفع Missing field: برخلاف Parsing errors، گزارش GSC در اینجا *فوق‌العاده* مفید است. GSC دقیقاً به شما می‌گوید کدام فیلد و در کدام URLها جا افتاده است. شما باید به مستندات رسمی گوگل (Search Gallery) مراجعه کنید، ببینید فیلدهای اجباری برای نوع اسکیمای شما چیست، و سپس کد JSON-LD خود را برای گنجاندن آن فیلدها اصلاح کنید.

۲. هشدار ‘… field is recommended’ (فیلد توصیه شده)

این یک «خطا» نیست، بلکه یک «هشدار» (Warning) است که در بخش “Valid with warnings” ظاهر می‌شود. اما «سارا» به عنوان یک مدیر فنی حرفه‌ای، باید این هشدارها را به عنوان رفع خطاهای اسکیما در اولویت دوم در نظر بگیرد.

این هشدار یعنی: “کد شما معتبر است و واجد شرایط هستید، اما اگر این فیلدهای «توصیه‌شده» (Recommended) را اضافه کنید، اسکیما شما بسیار قوی‌تر می‌شود و شانس بیشتری برای نمایش بهتر خواهید داشت.”

• مثال: در اسکیما Product، فیلدهای review یا aggregateRating «توصیه‌شده» هستند. اضافه کردن آن‌ها به شما «ریچ اسنیپت ستاره‌ها» را می‌دهد.
• مثال: در اسکیما Article، فیلد dateModified «توصیه‌شده» است. اضافه کردن آن به گوگل سیگنال «تازگی» (Freshness) می‌دهد.

استراتژی صحیح، رفع تمام «خطاها» و سپس تلاش برای رفع تمام «هشدارها» برای دستیابی به حداکثر پتانسیل خطاهای Rich Results است.

۳. خطای Invalid value type (نوع مقدار نامعتبر)

این یک خطای فنی رایج دیگر در عیب یابی اسکیما است. گوگل کد شما را خوانده، فیلدها را هم پیدا کرده، اما «محتوای» داخل فیلد با چیزی که انتظار داشته مطابقت ندارد.

مثال ۱: خطای فرمت تاریخ
گوگل برای فیلد datePublished انتظار یک فرمت خاص (ISO 8601) دارد، اما شما یک متن ساده وارد کرده‌اید.

کد اشتباه (Invalid):

"datePublished": "۸ نوامبر ۲۰۲۵"

کد صحیح (Valid):

"datePublished": "2025-11-08T08:00:00+01:00"

مثال ۲: خطای نوع شیء (Object Type)
گوگل برای فیلد author انتظار یک شیء Person یا Organization را دارد، اما شما فقط یک نام (Text) وارد کرده‌اید.

کد اشتباه (Invalid):

"author": "سارا"

کد صحیح (Valid):

"author": {
  "@type": "Person",
  "name": "سارا"
}

برای رفع این خطاها، باید به مستندات Schema.org (یا مستندات گوگل) مراجعه کنید و ببینید هر فیلد دقیقاً چه نوع مقداری را می‌پذیرد (Text, Number, Date, یا یک Object دیگر).

ورک‌فلو گام به گام: فرآیند عیب‌یابی و رفع خطاهای اسکیما

اکنون که انواع خطاهای اسکیما در سرچ کنسول را می‌شناسیم، «سارا» به یک ورک‌فلو مشخص برای رفع خطاهای اسکیما نیاز دارد.

1. گام ۱: شناسایی خطا در GSC (GSC Error Identification) به طور منظم (هفتگی) به بخش “Enhancements” در GSC سر بزنید. روی یک نوع خطای خاص کلیک کنید (مثلاً “Product snippets”) و لیست خطاهای قرمز (Error) را باز کنید. روی یک نوع خطا کلیک کنید (مثلاً Missing field "offers"). GSC لیستی از تمام URLهای متاثر را به شما نشان می‌دهد.
2. گام ۲: تست و عیب‌یابی با ابزارهای تست اسکیما یکی از URLهای نمونه را از GSC انتخاب کنید. روی دکمه “Test” در کنار آن کلیک کنید (یا URL را کپی کرده و مستقیماً به ابزار Rich Results Test ببرید). این مهم‌ترین مرحله عیب یابی اسکیما است. ابزار Rich Results Test صفحه شما را رندر می‌کند و خطا را به شما نشان می‌دهد. اینجاست که باید از دانش خود از ابزارهای تست اسکیما استفاده کنید. اگر RRT می‌گوید Parsing error، بهتر است کد را به Schema.org Validator ببرید تا محل دقیق خطای سینتکس را پیدا کند.
3. گام ۳: اصلاح کد (Fix the Code) پس از شناسایی دقیق خطا (مثلاً کامای اضافه، یا نبود فیلد offers)، به منبع کد خود بروید. این می‌تواند پلاگین اسکیمای شما، فایل‌های تم (Theme) یا کدنویسی تمیز وردپرس سفارشی شما باشد. تغییرات لازم را اعمال کنید. (مثلاً فیلد offers را با قیمت و موجودی اضافه کنید).
4. گام ۴: تست مجدد قبل از انتشار (Pre-Deployment Test) قبل از اینکه کد اصلاح‌شده را منتشر کنید، کد *جدید* را کپی کرده و در تب “Code” ابزار Rich Results Test و Schema.org Validator قرار دهید تا مطمئن شوید همه خطاها (قرمز) و هشدارها (نارنجی) برطرف شده‌اند.
5. گام ۵: انتشار و اعتبارسنجی (Deploy & Validate Fix) کد نهایی و تمیز را در سایت زنده خود منتشر کنید. به GSC بازگردید. به همان گزارش خطا بروید و اکنون روی دکمه “Validate Fix” (اعتبارسنجی اصلاح) کلیک کنید. این دکمه به گوگل سیگنال می‌دهد که شما فکر می‌کنید مشکل را حل کرده‌اید و باید صفحات شما را مجدداً بخزد. این فرآیند «اعتبارسنجی» آغاز می‌شود که می‌تواند از چند روز تا چند هفته طول بکشد. پس از آن، GSC به شما ایمیل می‌زند که آیا فرآیند رفع خطاهای اسکیما موفقیت‌آمیز بوده است یا خیر.

نتیجه‌گیری: خطاهای اسکیما به عنوان فرصت

برای «سارا»، خطاهای اسکیما در سرچ کنسول نباید منبع ترس یا ناامیدی باشند. هر خطا یک «فرصت» است؛ فرصتی برای شفاف‌سازی سیگنال‌های ارسالی به گوگل، بهبود نمایش در SERP و تقویت پایه‌های فنی E-E-A-T.

خطاهای گزارش Enhancements مانند یک چک‌لیست رایگان از طرف گوگل برای بهبود سایت شما هستند. با دنبال کردن یک ورک‌فلو سیستماتیک برای شناسایی، عیب یابی اسکیما و اعتبارسنجی، شما نه تنها خطاها را برطرف می‌کنید، بلکه تسلط فنی خود را به گوگل اثبات می‌نمایید. یک گزارش Enhancements تمیز و «سبز»، نشانه‌ای از یک پیاده‌سازی اسکیما سالم و حرفه‌ای است.