# بررسی داده‌های ساختاریافته

<https://www.fixreports.com/fa/structured-data-checker>

آدرس یک صفحه را وارد کنید تا JSON-LD آن همان‌طور که مرورگر پس از اجرای اسکریپت‌ها می‌بیند خوانده شود. این ابزار همه انواع schema.org را فهرست می‌کند، بلوک‌هایی را که موتورهای جست‌وجو نمی‌توانند تجزیه کنند پیدا می‌کند و هر مورد را با ویژگی‌های الزامی و توصیه‌شده در مستندات گوگل مقایسه می‌کند.

## این ابزار چه چیزهایی را بررسی می‌کند
- خطاهای نحوی JSON: هر بلوک JSON-LD همان‌طور تجزیه می‌شود که یک موتور جست‌وجو تجزیه می‌کند. بلوکی که یک ویرگول یا علامت نقل‌قول نابجا دارد همراه با پیام تجزیه‌گر گزارش می‌شود، چون موتورهای جست‌وجو کل بلوک را نادیده می‌گیرند.
- زمینه schema.org: بلوک‌هایی که "@context": "https://schema.org" ندارند علامت‌گذاری می‌شوند، چون موتورهای جست‌وجو نمی‌توانند تشخیص دهند از کدام واژگان استفاده می‌کنند.
- همه موارد، از جمله @graph: موارد سطح بالا و داخل @graph، به‌علاوه mainEntity و breadcrumb صفحه، هر کدام با نوع و نام یا عنوان (headline) آن.
- ویژگی‌های الزامی گوگل: موارد Product، Article، Breadcrumb، Organization، کسب‌وکار محلی (Local business)، Event، Video، Recipe، اپلیکیشن نرم‌افزاری (Software app)، آگهی شغلی (Job posting) و نام سایت (WebSite) با آنچه گوگل الزامی اعلام کرده مقایسه می‌شوند.
- ویژگی‌های توصیه‌شده: آنچه گوگل برای هر نتیجه غنی توصیه می‌کند، مانند image و availability برای محصولات، یا datePublished و author برای مقالات.
- نتایج غنی کنارگذاشته‌شده: موارد FAQPage و HowTo با یک یادداشت فهرست می‌شوند: گوگل دیگر این نتایج غنی را نمایش نمی‌دهد، بنابراین این نشانه‌گذاری نتیجه غنی به دست نمی‌آورد.
- نشانه‌گذاری اضافه‌شده با JavaScript: صفحه پیش از آنکه آن را بخوانیم در Chrome اجرا می‌شود، بنابراین JSON-LD که اسکریپت‌ها یا تگ منیجر (tag manager) اضافه می‌کنند هم در نظر گرفته می‌شود.

## آنچه نمی‌تواند بررسی کند
- تضمین نتیجه غنی. گوگل تصمیم می‌گیرد آن را نمایش دهد یا نه؛ نشانه‌گذاری معتبر فقط صفحه را واجد شرایط می‌کند.
- بررسی همه قواعد راهنماهای گوگل. برخی به مقادیر بستگی دارند، مانند اندازه تصاویر و قالب قیمت‌ها و تاریخ‌ها؛ مرجع در این موارد Rich Results Test گوگل است.
- بررسی ویژگی‌های microdata یا RDFa. این‌ها فقط بر اساس نوع فهرست می‌شوند.
- تأیید اینکه نشانه‌گذاری با آنچه صفحه نشان می‌دهد مطابقت دارد. گوگل این را الزامی می‌داند و فقط یک انسان می‌تواند این دو را مقایسه کند.
- تست چیزی بیش از صفحه‌ای که وارد می‌کنید.

## چرا اهمیت دارد
داده‌های ساختاریافته صفحه را به روشی استاندارد برای ماشین‌ها توصیف می‌کنند: این یک محصول با این قیمت است، این مقاله‌ای از این نویسنده است، این سازمانی است که پشت سایت قرار دارد. گوگل از آن‌ها برای درک صفحات و نمایش نتایج غنی مانند قیمت، امتیاز و مسیر راهنما (breadcrumb) استفاده می‌کند.

خطاهای آن بی‌صدا هستند. یک بلوک JSON-LD خراب در صفحه سالم به نظر می‌رسد، و نبود یک ویژگی الزامی بی‌سروصدا یک مورد را از نتیجه غنی‌اش محروم می‌کند. Search Console بخشی از این را گزارش می‌دهد، اما فقط برای صفحاتی که گوگل قبلاً خزیده است.

این داده‌ها میان‌بری به پاسخ‌های هوش مصنوعی نیستند. گوگل می‌گوید AI Overviews و AI Mode به هیچ نشانه‌گذاری خاص schema.org نیاز ندارند. آنچه اهمیت دارد این است که نشانه‌گذاری معتبر باشد و با آنچه صفحه نشان می‌دهد مطابقت داشته باشد.

## نحوه خواندن نتایج
- JSON معتبر یا غیرقابل خواندن: اینکه بلوک قابل تجزیه است یا نه. بلوکی که قابل خواندن نیست، فارغ از محتوایش، کاملاً نادیده گرفته می‌شود.
- ویژگی‌های الزامی موجود نیست: تا این ویژگی‌ها اضافه نشوند، مورد نمی‌تواند نتیجه غنی خود را بگیرد و Search Console آن را نامعتبر فهرست خواهد کرد.
- ویژگی‌های توصیه‌شده برای افزودن: مورد واجد شرایط است؛ این ویژگی‌ها می‌توانند نتیجه را غنی‌تر کنند. فقط مقادیری را اضافه کنید که درست هستند و در صفحه نمایش داده می‌شوند.
- کامل: ویژگی‌های الزامی و توصیه‌شده وجود دارند. مقادیرشان هنوز باید درست باشند.
- بدون بررسی نتیجه غنی: یک نوع معتبر، مانند WebPage یا ImageObject، که گوگل برای آن نتیجه غنی با ویژگی‌های الزامی ندارد.
- گوگل دیگر این نتیجه غنی را نمایش نمی‌دهد: FAQ (از 7 مه 2026) و How-to (از سپتامبر 2023). نگه داشتن نشانه‌گذاری ضرری ندارد.
- a / b: هر کدام از این ویژگی‌ها الزام را برآورده می‌کند، مثلاً offers / review / aggregateRating برای محصول.

## نحوه رفع رایج‌ترین مشکلات
- ویرگول اضافه در انتها یا نقل‌قول escape نشده: رایج‌ترین خطاهای نحوی. بلوک را در یک اعتبارسنج JSON بچسبانید تا محل خطا را پیدا کنید، و نقل‌قول‌های دوتایی داخل مقادیر متنی را با بک‌اسلش escape کنید.
- Product بدون offers، review یا امتیاز: اسنیپت محصول گوگل به name به‌علاوه offers، review یا aggregateRating نیاز دارد. پلتفرم‌های فروشگاهی معمولاً offers را با قیمت و موجودی خروجی می‌دهند؛ اگر پلتفرم شما این کار را نمی‌کند، قالب یا اپلیکیشن سئوی خود را بررسی کنید.
- امتیاز بدون تعداد: aggregateRating به ratingValue به‌علاوه ratingCount یا reviewCount نیاز دارد. فقط امتیازهایی را نشانه‌گذاری کنید که بازدیدکنندگان در صفحه می‌بینند: رهنمودهای گوگل نشانه‌گذاری محتوای نامرئی را مجاز نمی‌دانند.
- دو افزونه، دو مجموعه نشانه‌گذاری: قالب‌ها، افزونه‌های سئو و اپلیکیشن‌ها هر کدام می‌توانند داده Product یا Organization اضافه کنند. موارد تکراری با مقادیر متفاوت به هیچ‌کس کمک نمی‌کنند: یک منبع را نگه دارید و بقیه را خاموش کنید.
- موارد breadcrumb بدون آدرس: هر ListItem به یک URL در item (به‌جز آخرین مورد، که می‌تواند صفحه فعلی باشد) و یک name نیاز دارد، و فهرست باید دست‌کم دو مورد داشته باشد.
- نام سایت و سازمان در صفحه اصلی: در صفحه اصلی WebSite را با name و url اضافه کنید تا نام سایتتان را به گوگل بگویید، و Organization را با url، logo و لینک‌های sameAs به پروفایل‌های رسمی‌تان.

## پرسش‌های متداول

### JSON-LD چیست؟

روشی برای نوشتن داده‌های ساختاریافته به‌صورت یک شیء JSON داخل یک عنصر script، جدا از HTML قابل مشاهده. گوگل هر جا که پیکربندی شما اجازه دهد آن را توصیه می‌کند، چون افزودن و نگهداری‌اش از همه قالب‌ها آسان‌تر است.

### چرا پس از افزودن نشانه‌گذاری نتایج غنی نمی‌بینم؟

گوگل باید صفحه را دوباره بخزد، و حتی بعد از آن برای هر جست‌وجو تصمیم می‌گیرد که نتیجه غنی نمایش دهد یا نه. گوگل حتی برای نشانه‌گذاری‌ای که از تست‌هایش قبول می‌شود هم نتیجه غنی را تضمین نمی‌کند.

### آیا داده‌های ساختاریافته رتبه را بهتر می‌کنند؟

مستندات گوگل داده‌های ساختاریافته را راهی برای درک محتوا و فعال کردن نتایج غنی توصیف می‌کند، نه یک عامل رتبه‌بندی. نتایج غنی می‌توانند یک نتیجه را در جست‌وجو برجسته‌تر کنند.

### آیا هنوز افزودن نشانه‌گذاری FAQ ارزش دارد؟

نه برای نتایج غنی گوگل: گوگل نمایش آن‌ها را در 7 مه 2026 متوقف کرد. این نشانه‌گذاری همچنان schema.org معتبر است، بنابراین نیازی به حذفش نیست، اما آن را به امید نتیجه غنی اضافه نکنید.

### آیا برای نمایش در AI Overviews یا ChatGPT به نشانه‌گذاری schema نیاز دارم؟

گوگل می‌گوید AI Overviews و AI Mode به هیچ نشانه‌گذاری خاص schema.org نیاز ندارند. سرویس‌های هوش مصنوعی دیگر الزاماتی منتشر نمی‌کنند. محتوای روشن با نشانه‌گذاری معتبر و دقیق، رویکرد مطمئن است.

### این ابزار چه تفاوتی با Rich Results Test گوگل دارد؟

Rich Results Test مرجع گوگل است و مقادیر را هم بررسی می‌کند. این ابزار همه موارد صفحه را به زبان ساده فهرست می‌کند، نشان می‌دهد هر کدام چه کم دارد و به راهنمای مربوط لینک می‌دهد.

## منابع
- [Google Search Central: آشنایی با نشانه‌گذاری داده‌های ساختاریافته](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data)
- [Google Search Central: رهنمودهای کلی داده‌های ساختاریافته](https://developers.google.com/search/docs/appearance/structured-data/sd-policies)
- [Google Search Central: گالری داده‌های ساختاریافته در جست‌وجو](https://developers.google.com/search/docs/appearance/structured-data/search-gallery)
- [Google Search Central: قابلیت‌های هوش مصنوعی و وب‌سایت شما](https://developers.google.com/search/docs/appearance/ai-features)
- [Google Search Central: آخرین به‌روزرسانی‌های مستندات](https://developers.google.com/search/updates)
- [Google: Rich Results Test](https://search.google.com/test/rich-results)
- [Schema.org: Schema Markup Validator](https://validator.schema.org/)