پرش به محتوای اصلی

راهنمای پیش‌نمایش اشتراک‌گذاری (Open Graph)

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

وقتی پیوند صفحه‌ای را در تلگرام، واتس‌اپ یا X می‌فرستید، کارتی با عنوان، توضیح و تصویر ساخته می‌شود. این کارت از برچسب‌های Open Graph و Twitter Card درون head صفحه خوانده می‌شود و اگر آن‌ها نباشند یا ناقص باشند، پیوند بی‌تصویر و با عنوان نامرتب نمایش داده می‌شود. این ابزار صفحه را می‌خواند و پیش‌نمایش کارت را برای تلگرام، واتس‌اپ و X کنار هم نشان می‌دهد.

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

گام‌به‌گام

  1. نشانی را بدهید

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

  2. پیش‌نمایش را ببینید

    کارت هر سه پیام‌رسان با عنوان، توضیح، نام سایت و تصویر نمایش داده می‌شود.

  3. ایرادها را رفع کنید

    فهرست مشکل‌ها و هشدارها را بخوانید؛ مثلاً نبود og:image یا twitter:card. پس از اصلاح صفحه، دوباره بررسی کنید.

  4. همه‌ی برچسب‌ها را بررسی کنید

    در «همه‌ی برچسب‌ها» مقدار هر برچسب را دقیقاً همان‌طور که در صفحه است می‌بینید.

نمونه‌های کاربردی

  • صفحه‌ای بدون تصویر

    صفحه‌ای که og:title و og:description دارد اما og:image، og:url و twitter:card ندارد.

    نتیجه: مشکل: og:image نیست؛ کارت اشتراک بدون تصویر نمایش داده می‌شود.

اشتباه‌های رایج

  • تصویر با نشانی نسبی: og:image باید نشانی کامل با https باشد؛ /img/cover.jpg را پیام‌رسان‌ها پیدا نمی‌کنند.
  • انتظار به‌روز شدن فوری کارت: پیام‌رسان‌ها کارت را کش می‌کنند. پس از اصلاح، ممکن است پیوندهای قبلی تا مدتی همان کارت قدیمی را نشان دهند.
  • تصویر خیلی بزرگ یا خیلی کوچک: تصویر افقی با نسبت حدود ۱٫۹ به ۱، مثلاً ۱۲۰۰ در ۶۳۰ پیکسل، در بیشتر پیام‌رسان‌ها خوب نمایش داده می‌شود.
  • گذاشتن برچسب‌ها با جاوااسکریپت: خزنده‌های پیام‌رسان‌ها معمولاً جاوااسکریپت اجرا نمی‌کنند؛ برچسب‌ها باید در HTML اولیه‌ی صفحه باشند.

Open Graph و Twitter Card

Open Graph مجموعه‌ای از برچسب‌های meta با property="og:…" است که بیشتر پیام‌رسان‌ها و شبکه‌ها می‌خوانند: og:title، og:description، og:image و og:url مهم‌ترین‌اند. X برچسب‌های twitter:… خودش را دارد، اما اگر نباشند از Open Graph استفاده می‌کند؛ فقط twitter:card را باید جدا بگذارید تا کارت بزرگ نمایش داده شود.

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

چرا تصویر کارت نمایش داده نمی‌شود؟
برای حفظ حریم خصوصی شما، مرورگرتان هیچ فایلی از سایت مقصد بارگیری نمی‌کند؛ فقط نشانی تصویر نشان داده می‌شود تا درستی آن را بررسی کنید.
پیش‌نمایش دقیقاً مثل خود تلگرام است؟
نه کاملاً؛ هر پیام‌رسان کش و قواعد بریدن متن خودش را دارد. این ابزار برچسب‌هایی را نشان می‌دهد که آن‌ها می‌خوانند.
چه مقدار از صفحه خوانده می‌شود؟
فقط تا یک مگابایت اول صفحه و فقط بخش head؛ محتوای صفحه نگه‌داری یا نمایش داده نمی‌شود.

ابزارهای مرتبط