نحوه استفاده
- هر پرسش و پاسخ آن را همانطور که در صفحهتان ظاهر میشود تایپ کنید.
- جفتهای بیشتری اضافه کنید، آنها را بالا یا پایین ببرید یا مواردی را که نیاز ندارید حذف کنید. جفتهای ناقص کنار گذاشته و علامتگذاری میشوند.
- اسکریپت را کپی کنید و در HTML صفحه، در بخش head یا body جایگذاری کنید.
- صفحه را با یک اعتبارسنج داده ساختاریافته آزمایش کنید تا از خواندهشدن درست نشانهگذاری مطمئن شوید.
نحوه کار
این سازنده یک شیء FAQPage از schema.org با یک Question برای هر جفت می‌سازد که هر کدام یک acceptedAnswer از نوع Answer دارند. JSON با یک سریالایزر واقعی JSON تولید میشود؛ بنابراین علامت‌های نقل‌قول، بک‌اسلش و شکستگی خط در متن شما به‌درستی escape میشوند. به‌علاوه، هر «<»، «>» و «&» به‌صورت escape نویسی \u نوشته میشود. این کار مانع از آن میشود که متنی مانند «</script>» یا «<!--» در یک پاسخ، عنصر script را زودتر از موعد ببندد و صفحه را خراب کند، در حالی که تجزیه‌گرهای JSON همچنان نویسه‌های اصلی را می‌خوانند.
دربارهٔ نتایج غنی: در اوت ۲۰۲۳ گوگل نتایج غنی FAQ را به وب‌سایت‌های شناخته‌شده و معتبر دولتی و سلامت محدود کرد. برای بیشتر سایت‌های دیگر، نشانهگذاری FAQPage دیگر پرسش‌های بازشونده را در جستجوی گوگل تولید نمی‌کند. این نشانهگذاری همچنان دادهٔ ساختاریافتهٔ معتبری است که صفحه را توصیف میکند و دیگر مصرف‌کنندگان داده‌های schema.org می‌توانند از آن استفاده کنند.
قواعدی که ارزش رعایت دارند: پرسشها و پاسخهای موجود در نشانهگذاری باید در صفحه نیز قابل مشاهده باشند؛ هر پرسش باید یک پاسخ واحد نوشته‌شده توسط سایت داشته باشد (برای صفحاتی که کاربران در آنها پاسخ ارسال می‌کنند، QAPage نوع مناسبی است)؛ و نشانهگذاری نباید برای تبلیغات استفاده شود. پاسخ‌ها می‌توانند شامل HTML ساده‌ای مانند پیوندها و فهرست‌ها باشند که دستورالعمل‌های گوگل در متن پاسخ مجاز می‌داند.
نمونه‌ها
صفحهٔ پشتیبانی محصول
سه پرسش دربارهٔ ارسال، بازگشت کالا و گارانتی به یک FAQPage با سه آیتم Question تبدیل میشوند. اسکریپت را یک‌بار در صفحهٔ پشتیبانی که آن پرسشها را نشان می‌دهد قرار دهید.
پاسخی شامل کد
پاسخی که به «</script>» اشاره میکند درون JSON به‌صورت \u003c/script\u003e خروجی داده میشود؛ بنابراین تگ اسکریپت صفحه دست‌نخورده باقی می‌ماند و متن قابل‌مشاهده تغییر نمی‌کند.
پرسش‌های متداول
آیا نشانهگذاری FAQ به صفحهٔ من نتایج غنی در گوگل می‌دهد؟
احتمالاً نه، مگر اینکه یک وب‌سایت دولتی یا سلامت معتبر و شناخته‌شده باشد. گوگل در سال ۲۰۲۳ نتایج غنی FAQ را به این سایت‌ها محدود کرد. نشانهگذاری همچنان معتبر است و سرویس‌های دیگر می‌توانند آن را بخوانند.
اسکریپت JSON-LD را کجا قرار دهم؟
هر جایی در HTML، در head یا body. چیزی نمایش نمی‌دهد. آن را فقط به صفحه‌ای اضافه کنید که واقعاً این پرسشها و پاسخ‌ها را نشان می‌دهد.
آیا می‌توانم در پاسخ‌ها پیوند قرار دهم؟
بله. دستورالعمل‌های FAQ گوگل مجموعه‌ای محدود از تگ‌های HTML را در متن پاسخ مجاز می‌داند؛ مانند پیوندها، فهرست‌ها و پاراگراف‌ها. HTML را در پاسخ تایپ کنید؛ به‌صورت امن برای اسکریپت escape میشود.
چرا دنبالههای \u003c در خروجی وجود دارند؟
اینها escape مربوط به «<» در JSON هستند. نوشتن آن به این شکل مانع بستهشدن تگ script توسط متن داخل پاسخهای شما میشود. هر خواننده JSON-LD آن را دوباره به «<» تبدیل میکند.
حریم خصوصی
نشانهگذاری در مرورگر شما تولید میشود. پرسشها و پاسخهای شما به هیچجا ارسال یا ذخیره نمیشوند.