Command Palette

Search for a command to run...

مولد ترميز المخطط: قم ببناء بيانات منظمة JSON-LD صالحة بدون التخمين

مولد ترميز المخطط: قم ببناء بيانات منظمة JSON-LD صالحة بدون التخمين

T
Toolz Team
|Aug 23, 2026|17 دقيقة قراءة

جزء من مجموعة أدوات تحسين محركات البحث

في المرة الأولى التي أضفت فيها ترميز المخطط إلى موقع العميل، قمت بكتابة ملف يدويًا Product قم بحظر رأس الموضوع، وقم بنشره، واستمر في الشعور بالذكاء. بعد أسبوعين، أخبرني اختبار النتائج الغنية أن كائن العرض كان يفتقده @type، كان السعر رقمًا أرادت Google سلسلة فيه، وكانت الفاصلة الزائدة الضالة قد أبطلت الكتلة بأكملها بهدوء. لقد كانت جوجل تتجاهل ذلك طوال الوقت. هذا هو الشيء الذي لا يحذرك منه أحد بالبيانات المنظمة: JSON-LD غير الصالح لا يلقي خطأ أو يحول أي شيء إلى اللون الأحمر. إنه لا يفعل شيئًا بصمت، وتكتشف بعد أشهر متى لم تظهر النتيجة الغنية التي كنت تعتمد عليها أبدًا.

يتم نشر المفردات نفسها في schema.orgوما ستعرض Google نتيجة غنية له هو قائمة أضيق في قائمتها توثيق البيانات المنظمة.

أقوم ببناء أدوات لكسب لقمة العيش - Toolz.dev، والمكون الإضافي WP Adminify، ومجموعة من تطبيقات Laravel وReact - والبيانات المنظمة هي إحدى تلك المهام التي أقوم بها كثيرًا بما يكفي للاستياء من القيام بذلك يدويًا ونادرًا ما يكفي لنسيانها بالضبط أسماء العقارات في كل مرة. لذلك قمت ببناء مولد ترميز المخطط لإزالة وضعي الفشل اللذين كلفاني أكثر: التداخل الخاطئ والبطلان الصامت. يتتبع هذا الدليل ما يفعله ترميز المخطط فعليًا، وكيف يقوم المولد ببنائه، والأخطاء المحددة التي تمنع الترميز ذي المظهر الصحيح من الحصول على نتائج غنية.

ليرة تركية؛DR: ترميز المخطط عبارة عن بيانات منظمة (باستخدام مفردات schema.org) تخبر محركات البحث بالضبط عن موضوع الصفحة، مما يجعلها مؤهلة للحصول على نتائج غنية مثل الأسئلة الشائعة حول الأكورديون وأسعار المنتجات وفتات الخبز. توصي Google بتنسيق JSON-LD - وهو تنسيق قائم بذاته <script type="application/ld+json"> كتلة. يقوم المولد ببناء JSON-LD صالح لتسعة أنواع شائعة، مثل الكائنات الفرعية للأعشاش PostalAddress و Offer بشكل صحيح، تشير العلامات إلى فقدان الحقول المطلوبة والموصى بها، وتعمل بنسبة 100% في متصفحك حتى لا يتم تحميل أي شيء تكتبه.

ما هو ترميز المخطط، ولماذا يهم؟

يعد ترميز المخطط طريقة موحدة لوصف محتوى الصفحة حتى تتمكن الأجهزة من فهمها، وليس عرضها فقط. تأتي المفردات من schema.org، وهو مشروع مشترك مدعوم من Google وMicrosoft وYahoo وYandex. عندما تقوم بترميز الصفحة كـ Articleأنت تخبر محرك البحث &quot؛ هذه مقالة إخبارية أو مدونة، هذا هو عنوانها الرئيسي، هنا من كتبها، وهنا متى تم نشرها.&quot؛ هذا الوصف المنظم هو ما يجعل الصفحة مؤهلة للحصول على نتائج غنية - القوائم المحسنة مع تقييمات النجوم والأسعار والأسئلة الشائعة المنسدلة وتواريخ الأحداث ومسارات التنقل التي تشغل مساحة أكبر وتكسب نقرات أكثر من الرابط الأزرق العادي.

لقد تغير سبب أهميته خلال السنوات القليلة الماضية. كان الأمر يتعلق فقط بالنتائج الغنية في Google. الآن تغذي البيانات المنظمة أيضًا محركات إجابات الذكاء الاصطناعي ونظرات عامة على الذكاء الاصطناعي من Google&#39؛s. عندما يحاول ChatGPT أو Perplexity أو Gemini تلخيص ما يفعله عملك أو المنتج الذي يطابق الاستعلام، فإن البيانات المنظمة النظيفة هي إحدى الإشارات التي تساعدهم في الحصول على الحقائق الصحيحة. صفحة تعلن عن نفسها بوضوح Organization يعد استخدام الاسم والشعار والملفات الشخصية الاجتماعية أسهل بكثير لأي جهاز للتفكير فيه من الجهاز الذي يترك كل شيء ضمنيًا في HTML.

المشكلة هي أن البيانات المنظمة لا ترحم. إنه رمز، ويجب أن يكون الرمز صحيحًا تمامًا. خاصية مكتوبة datePublish بدلا من datePublished يتم تجاهله ببساطة. ان Offer بدون @type لم يتم التعرف عليه كعرض. ولأن أيًا من هذه الأخطاء لا يكسر الصفحة المرئية، فإنها تختبئ في الإنتاج إلى أجل غير مسمى. هذه هي الفجوة التي يملأها المولد - ليس كتابة المفاهيم لك، ولكن الحصول على بناء الجملة والبنية بشكل صحيح في كل مرة.

لماذا JSON-LD بدلاً من Microdata أو RDFa؟

هناك ثلاث طرق لإضافة بيانات schema.org إلى الصفحة، ويساعد ذلك على فهم سبب إنتاج المولد لواحدة منها فقط.

البيانات الجزئية و ردفا انسج البيانات المنظمة مباشرة في HTML المرئي الخاص بك باستخدام سمات إضافية - itemscope، itemprop، property، وهكذا. خاصتك <div> للحصول على مراجعة للمنتج، تكتسب سمات تحدد كل جزء من النص المرئي. ينجح هذا، ولكنه يربط ترميزك بإحكام ببنية صفحتك. قم بتغيير التخطيط وستخاطر بكسر المخطط. كما أنها مطولة ويصعب قراءتها.

JSON-LD يأخذ النهج المعاكس. فهو يضع جميع البيانات المنظمة في مكان واحد قائم بذاته <script type="application/ld+json"> كتلة، عادة في <head>منفصل تمامًا عن HTML المرئي. أوصت Google بـ JSON-LD لسنوات على وجه التحديد بسبب هذا الفصل: يمكنك إضافته أو تحديثه أو إدخاله من خلال مدير العلامات دون لمس القوالب الخاصة بك. إنه التنسيق الذي يعلمه كل برنامج تعليمي للمخطط الحديث، وهو ما يخرجه المولد.

تنسيق حيث يعيش سهولة الصيانة موقف Google&#39؛s
JSON-LD أعزب <script> كتلة، منفصلة عن HTML الأسهل - تحرير كتلة واحدة موصى به
البيانات الجزئية السمات داخل HTML المرئي أصعب - إلى جانب التخطيط مدعوم
ردفا السمات داخل HTML المرئي أصعب - إلى جانب التخطيط مدعوم

إذا كنت تعمل في WordPress، فإن JSON-LD هو أيضًا ما تقدمه معظم مكونات تحسين محركات البحث الإضافية، وما هي أداة مثل WP Adminify التي يمكن وضعها جنبًا إلى جنب بشكل نظيف. نظرًا لأنها كتلة مستقلة، يمكنك إنشاؤها هنا ولصقها في حقل HTML مخصص، أو مدير علامات، أو تخطيط Laravel Blade دون أي جمباز خاص بإطار العمل.

كيف يمكنني استخدام مولد ترميز المخطط؟

تم تصميم سير العمل حول اختيار نوع وملء نموذج قصير، مع معاينة مباشرة حتى تتمكن من رؤية تجميع JSON-LD أثناء الكتابة.

الخطوة 1 - اختر نوع المخطط. اختر من المؤسسة، أو الأعمال المحلية، أو موقع الويب، أو المقالة، أو المنتج، أو صفحة الأسئلة الشائعة، أو قائمة التنقل، أو الشخص، أو الحدث. يتم تبديل النموذج على الفور إلى الحقول التي يحتاجها النوع. تغطي هذه المواقع التسعة الغالبية العظمى مما تحتاج المواقع الصغيرة والمتوسطة الحجم بالفعل إلى علامات عليه.

الخطوة 2 - املأ الحقول. يتم تمييز الحقول المطلوبة بعلامة النجمة. أثناء الكتابة، تقوم الأداة بتجميع JSON-LD وإسقاط أي حقل تتركه فارغًا، لذلك لا ينتهي بك الأمر فارغًا أبدًا "" الخصائص الملوثة للمخرجات. بالنسبة للأنواع المستندة إلى العناوين مثل LocalBusiness وEvent، يتم طي حقول العناوين الفردية في حقل مكتوب بشكل صحيح PostalAddress الكائن تلقائيا.

الخطوة 3 - شاهد التحقق من الصحة. يشير المولد إلى نوعين من المشاكل. الأخطاء (الحقول المطلوبة المفقودة، عناوين URL المشوهة) تمنع النتيجة النظيفة وتظهر باللون الأحمر. التحذيرات (الحقول المفقودة الموصى بها من Google مثل image أو datePublished، أو يظهر قالب عنوان URL للبحث الذي يفتقد العنصر النائب الخاص به) باللون الكهرماني - لا يزال الترميز صالحًا، ولكنك تترك إمكانات النتائج الغنية على الجدول.

الخطوة 4 - النسخ والنشر. التبديل بين الكامل <script> العلامة (جاهزة للصقها في الخاص بك <head>) وJSON الخام (لمديري العلامات وحقول CMS). يهرب إخراج البرنامج النصي من الأحرف التي قد تسمح لها بالضلوع </script> في بياناتك كسر الصفحة. ثم قم بالتحقق من صحة الصفحة المباشرة باستخدام اختبار النتائج الغنية لـ Google&#39؛s.

نظرًا لأن كل شيء يعمل من جانب العميل، فمن الآمن استخدامه على صفحات المنتجات غير المنشورة وبيئات العرض وعمل العميل بموجب NDA. لا تترك أسعارك وتفاصيل الأحداث وعناوين URL الداخلية المتصفح أبدًا - وهو نفس موقف الخصوصية وراء كل أداة على الموقع، والذي كتبت عنه في دليل خصوصية البيانات.

ما هي أنواع المخططات التي يجب أن أستخدمها بالفعل؟

لا تحتاج كل صفحة إلى علامات، كما أن تراكم الأنواع التي لا يمكنك دعمها أسوأ من لا شيء. إليكم كيف أفكر في التسعة التي يغطيها المولد.

منظمة ينتمي إلى صفحتك الرئيسية أو صفحة حول - وهو المخطط الذي يغذي لوحات المعرفة ويساعد Google على ربط علامتك التجارية بملفاتها الشخصية الاجتماعية عبر sameAs. موقع ويب يقترن به ويمكنه الإعلان عن مربع بحث Sitelinks من خلال ملف SearchActionالسماح للمستخدمين بالبحث في موقعك مباشرة من صفحة النتائج. الأعمال المحلية يعد ضروريًا إذا كان لديك موقع فعلي: فهو يحمل عنوانك وهاتفك ونطاق السعر وساعات العمل، ويدعم نتائج الحزمة المحلية والخريطة.

شرط (التي ينبعث منها المولد Article النوع، الصالح أيضًا لمشاركات المدونة) يحدد المحتوى التحريري بالعنوان الرئيسي والمؤلف والناشر وتواريخ النشر. منتج يصف شيئا للبيع، مع متداخلة Offer سعر الحمل والعملة والتوافر - هذا هو ما يعزز السعر ومقتطفات التوفر. حدث يغطي أي شيء له تاريخ ومكان، من مؤتمر إلى ندوة عبر الإنترنت.

صفحة الأسئلة الشائعة و قائمة التنقل هي هيكلية وليست حول &quot؛ شيء.&quot؛ تحدد صفحة الأسئلة الشائعة محتوى الأسئلة والأجوبة؛ لاحظ أن Google قامت بتضييق نطاق النتائج الغنية بالأسئلة الشائعة لتشمل المواقع الحكومية والصحية الموثوقة، لكن العلامات لا تزال تساعد محركات البحث الأخرى ومحركات الإجابة بالذكاء الاصطناعي على تحليل Q&amp؛ أ. تنتج BreadcrumbList مسار التنقل الموضح تحت عنوانك في النتائج، مما يحسن كيفية قراءة بنية عنوان URL الخاص بك. شخص يحدد فردًا - مؤلفًا أو مؤسسًا أو شخصية عامة - وهو مفيد للسير الذاتية للمؤلف وإشارات EET.

القاعدة التي أتبعها: قم بترميز ماهية الصفحة حقًا، واطلب فقط الخصائص التي تعكس المحتوى المرئي بالفعل على الصفحة. توضح إرشادات Google&#39؛s أن البيانات المنظمة يجب أن تصف محتوى حقيقيًا ومرئيًا - يعد تحديد السعر الذي لا يظهر على الصفحة انتهاكًا وليس اختصارًا.

كيف يحافظ المولد على صحة العلامات؟

تكمن القيمة في التفاصيل التي يسهل الخطأ فيها يدويًا. عدد قليل يستحق الدعوة.

التعشيش الصحيح مع @type. في JSON-LD، الكائنات المتداخلة ليست كائنات فرعية عادية - كل منها يحتاج إلى كائن خاص به @type. العنوان هو أ PostalAddress، العرض هو Offerمقال &#39؛ المؤلف هو أ Person، ناشرها هو Organization الذي شعاره هو ImageObject. يقوم المولد ببناء كل واحدة منها بالنوع الصحيح بحيث يتعرف عليها المحلل اللغوي بدلاً من التعامل معها على أنها نقاط مجهولة المصدر.

تقليم الفراغات. يجب أن يؤدي ترك الحقل فارغًا إلى إزالة الخاصية، وليس إصدارها "telephone": "". يتم تجريد السلاسل الفارغة والمصفوفات الفارغة من الإخراج تلقائيًا، وبالتالي فإن ما تقوم بنسخه يكون نظيفًا دائمًا.

الهروب الآمن للبرنامج النصي. الشخصية الأكثر خطورة في JSON-LD المضمنة هي < - وتحديداً التسلسل </script> الظهور داخل بياناتك (على سبيل المثال، في الوصف)، مما يؤدي إلى إنهاء كتلة البرنامج النصي مبكرًا وكسر الصفحة. يهرب المولد <، >، و & في إخراج علامة البرنامج النصي باستخدام عمليات الهروب unicode، وهو بالضبط ما تفعله الأمثلة الخاصة بـ Google&#39؛.

الوعي المطلوب والموصى به. يحمل كل نوع قائمته الخاصة لما تطلبه Google مقابل ما توصي به. المادة تريد حقا image و datePublished؛ المنتج يريد أ price؛ الحدث يحتاج إلى startDate. تميز الأداة بين المتطلبات الصعبة (التي تتعامل معها على أنها أخطاء) والتوصيات (التحذيرات)، حتى تعرف الفرق بين &quot؛ هذا لن ينجح وquot؛ و&quot؛ هذا يمكن أن يعمل بشكل أفضل.&quot؛

إذا كنت تقوم بتجميع سير عمل فني أوسع، فإن مولد المخطط يقع بشكل طبيعي جنبًا إلى جنب مع أدوات تحسين محركات البحث الأخرى - مولد العلامات للحصول على العنوان والوصف والعلامات Open Graph، و مولد خريطة الموقع XML لإرسال عناوين URL الخاصة بك. وهي تغطي معًا معظم سطح تحسين محركات البحث الفني الموجود على الصفحة، وقمت بتجميعها لهذا السبب في نظرة عامة على مجموعة أدوات مطور الويب.

كيف يمكنني اختبار ونشر البيانات المنظمة؟

يعد إنشاء JSON-LD صالح نصف المهمة؛ النصف الآخر يؤكد أن Google تقرأه بالطريقة التي تريدها.

ابدأ بـ Google&#39؛s اختبار النتائج الغنية، الذي يجلب عنوان URL أو يقبل التعليمات البرمجية الملصقة ويبلغ عن أنواع النتائج الغنية التي تكون الصفحة مؤهلة لها، بالإضافة إلى أي أخطاء أو تحذيرات. ثم قم بتشغيل نفس العلامات من خلال مدقق ترميز المخطط في validator.schema.org، الذي يتحقق من التوافق مع مفردات schema.org نفسها بدلاً من متطلبات النتائج الغنية لـ Google&#39؛. يلتقط الاثنان أشياء مختلفة: يخبرك اختبار النتائج الغنية بما إذا كنت مؤهلاً للحصول على ميزة Google محددة، بينما يخبرك المدقق ما إذا كانت العلامات سليمة من الناحية الهيكلية.org.

بمجرد أن تصبح الصفحة مباشرة، يتم الإبلاغ عن التعزيزات وحدة تحكم بحث جوجل تتبع الأداء بمرور الوقت ووضع علامة على الأخطاء التي يجدها Google أثناء الزحف. هذا هو المكان الذي تكتشف فيه المشكلات التي تظهر فقط على نطاق واسع - قالب يصدر مواضع فتات التنقل المكررة، على سبيل المثال، أو موجز منتج يحذف أحيانًا الحقل المطلوب.

للنشر، لصق <script> كتلة في <head> من الصفحة المحددة التي يصفها. لا تضع كتلة منتج واحدة في قالب عام يعمل على كل صفحة - يجب أن يتطابق الترميز مع الصفحة التي يعيش عليها. في نظام إدارة المحتوى، استخدم أي حقل مخصص بتنسيق HTML أو تحسين محركات البحث يوفره لك النظام الأساسي. في مدير العلامات، استخدم علامة HTML مخصصة وانسخ JSON. في تطبيق React أو Laravel، قم بإدخال جانب خادم الكتلة حتى تراه برامج الزحف في HTML الأولي وليس بعد الترطيب.

الأخطاء الشائعة ما زلت أرى

تظهر مجموعة من الأخطاء مرارًا وتكرارًا، وكل واحدة منها تنتج علامات تبدو جيدة ولكنها لا تفعل شيئًا.

الكلاسيكي هو ترميز المحتوى غير المرئي - إضافة تقييم مراجعة أو سعر لا يظهر في أي مكان على الصفحة. تحظر Google ذلك صراحةً ويمكنها إصدار إجراء يدوي له. والثاني هو النوع الخاطئ على كائن متداخل، عادة مفقود @type على عنوان أو عرض. والثالث هو الخلط بين الأنواع المماثلةمثل الاستخدام Product وضع العلامات على صفحة قائمة الفئات بدلاً من منتج واحد. والرابع، عدوي الشخصي، هو خطأ في بناء الجملة من التحرير اليدوي - فاصلة زائدة أو اقتباس غير مرفوض يبطل الكتلة بأكملها.

كل واحد من هذه هو السبب في أن المولد يكسب رزقه. لا يمكنه معرفة ما إذا كان سعرك مرئيًا على الصفحة - أي عليك - ولكنه لن يصدر أبدًا فاصلة زائدة، أو مفقودة @type، أو خاصية فارغة. وهذا وحده يزيل معظم الطرق التي تفشل بها البيانات المنظمة بصمت. للحصول على خلفية أعمق عن سير عمل المطور حول هذا النوع من الأدوات، فإن دليل أدوات الترميز هو رفيق جيد للقراءة.

الأسئلة المتداولة

ما هو ترميز المخطط؟

ترميز المخطط عبارة عن بيانات منظمة تصف محتوى الصفحة &#39؛s لمحركات البحث باستخدام مفردات schema.org المشتركة. يمكن أن تؤدي إضافتها إلى جعل الصفحة مؤهلة للحصول على نتائج غنية مثل الأسئلة الشائعة حول الأكورديون وأسعار المنتجات ونجوم المراجعة وفتات الخبز. JSON-LD، التنسيق الذي تنتجه هذه الأداة، هو بناء الجملة الذي توصي به Google لأنه موجود في علامة برنامج نصي واحدة منفصلة عن HTML المرئي.

ما هو الفرق بين JSON-LD و Microdata و RDFA؟

كلها ثلاث طرق لإضافة بيانات منظمة schema.org إلى صفحة. Microdata و RDFA هما سمات منسوجة في HTML المرئي ، بينما JSON-LD عبارة عن كتلة قائمة بذاتها من JSON في علامة البرنامج النصي. توصي Google بـ JSON-LD لأنه من الأسهل إضافة وتحديث وفصل علامة الصفحة. هذه الأداة تخرج JSON-LD لهذا السبب.

أين أضع json-ld الذي تم إنشاؤه؟

لصق كامل <script type="application/ld+json"> علامة في <head> من الصفحة التي يصفها، أو في أي مكان في <body> - جوجل يقرأها في أي من الموقعين. إذا كنت تستخدم Google Tag Manager، فانسخ JSON وأضفه من خلال علامة HTML مخصصة. ضع العلامات دائمًا على نفس الصفحة التي تصف محتواها، وليس على قالب يطبقها في كل مكان.

هل إضافة ترميز المخطط يضمن نتائج غنية؟

لا البيانات المهيكلة الصالحة تجعل الصفحة مؤهلة للحصول على نتائج غنية ، لكن Google تقرر ما إذا كانت ستعرضها بناءً على الجودة والملاءمة وإرشاداتها الخاصة. يجب أن يعكس ترميزك أيضًا محتوى مرئيًا بالفعل على الصفحة. فكر في المخطط على أنه مطلب للحصول على نتائج غنية ، وليس مفتاحًا يقوم بتشغيلها.

كيف أختبر بياناتي المنظمة؟

قم بتشغيل العلامات التي تم إنشاؤها من خلال اختبار النتائج الغنية لـ Google&#39؛s ومدقق ترميز المخطط (مدقق schema.org&#39؛s). يقوم كل من تحليل JSON-LD الخاص بك والإبلاغ عن الحقول المطلوبة المفقودة أو أخطاء بناء الجملة. بعد أن تصبح الصفحة مباشرة، تقوم تقارير تحسينات وحدة تحكم بحث Google بتتبع كيفية أداء بياناتك المنظمة بمرور الوقت.

ما هي الحقول المطلوبة لكل نوع؟

تختلف المتطلبات حسب النوع: المقالة تحتاج إلى عنوان ، يحتاج المنتج إلى اسم ، يحتاج الحدث إلى اسم وتاريخ البداية ، وتحتاج صفحة الأسئلة الشائعة إلى سؤال وإجابة واحدة على الأقل. تحدد هذه الأداة الحقول المطلوبة وتقوم بحظر الإخراج حتى يتم ملؤها ، بينما تحذر أيضًا من الحقول الموصى بها التي تحسن فرصك في الحصول على نتيجة غنية.

هل يمكنني إنشاء مخطط الأسئلة الشائعة لصفحتي؟

نعم. اختر نوع صفحة الأسئلة الشائعة ، وأضف كل سؤال بإجابته ، وستقوم الأداة ببناء مجموعة MaineEntity من كائنات الأسئلة والإجابة تلقائيًا. لاحظ أن Google Now تعرض نتائج غنية بالأسئلة الشائعة بشكل أساسي للحكومة والمواقع الصحية الموثوقة ، لكن الترميز يظل صالحًا ومفيدًا لمحركات البحث الأخرى ومحركات الإجابة على الذكاء الاصطناعي.

هل بياناتي تحتفظ بها خاصة؟

نعم. يتم تجميع JSON-LD بالكامل في متصفحك باستخدام JavaScript عادي. لا يتم نقل أو تسجيل أو تخزين أي شيء تكتبه - بما في ذلك الأسعار غير المنشورة أو تفاصيل الأحداث أو عناوين URL الخاصة - ويستمر المولد في العمل بدون اتصال بالشبكة بمجرد تحميله.


Comments

0 comments

0/2000 characters

No comments yet. Be the first to share your thoughts!