إنشاء بيانات منظَّمة باستخدام JavaScript

تستخدم المواقع الإلكترونية الحديثة JavaScript لعرض الكثير من المحتوى الديناميكي. عليك مراعاة بعض النقاط عند استخدام JavaScript لإنشاء بيانات منظَّمة على مواقعك الإلكترونية، ويتناول هذا الدليل أفضل الممارسات واستراتيجيات التنفيذ. وإذا كنت لا تزال مبتدئًا في مجال البيانات المنظَّمة، يمكنك الاطّلاع على المزيد من المعلومات حول آلية عمل البيانات المنظَّمة.

ثمة طرق مختلفة لإنشاء بيانات منظَّمة باستخدام JavaScript، ولكن أكثرها شيوعًا هي:

استخدام أداة "إدارة العلامات من Google" لإنشاء JSON-LD بشكل ديناميكي

أداة "إدارة العلامات من Google" هي منصّة تتيح لك إدارة العلامات على موقعك الإلكتروني بدون تعديل الرمز. لإنشاء بيانات منظَّمة باستخدام أداة "إدارة العلامات من Google"، اتّبِع الخطوات التالية:

  1. إعداد وتثبيت أداة "إدارة العلامات من Google" على موقعك الإلكتروني
  2. إضافة علامة HTML مخصّصة جديدة إلى الحاوية
  3. لصق كتلة البيانات المنظَّمة المطلوبة في محتوى العلامة
  4. تثبيت الحاوية كما هو موضّح في القسم تثبيت أداة "إدارة العلامات من Google" ضمن قائمة مدير الحاوية.
  5. نشر الحاوية في واجهة أداة "إدارة العلامات من Google" لإضافة العلامة إلى موقعك الإلكتروني
  6. التحقق من نجاح العملية

استخدام المتغيّرات في أداة "إدارة العلامات من Google"

إنّ أداة "إدارة العلامات من Google" (أي GTM) تتيح استعمال المتغيّرات من أجل استخدام المعلومات المتوفّرة على الصفحة كجزء من بياناتك المنظَّمة. عليك استخدام المتغيّرات لاستخراج البيانات المنظَّمة من الصفحة بدلاً من إنشاء نسخة طبق الأصل من المعلومات في GTM. يؤدي إنشاء نسخة طبق الأصل من المعلومات في GTM إلى زيادة احتمال عدم تطابق محتوى الصفحة مع البيانات المنظَّمة التي يتم إدراجها عبر GTM.

على سبيل المثال، يمكنك بشكل ديناميكي إنشاء كتلة JSON-LD لوصفة طعام تستخدم عنوان الصفحة كاسم للوصفة، وذلك من خلال إنشاء المتغيّر المخصَّص التالي المُسمّى recipe_name:

function() { return document.title; }

يمكنك بعد ذلك استخدام {{recipe_name}} في علامة HTML المخصّصة.

نقترح إنشاء متغيّرات لاستخدامها من أجل جمع كل المعلومات الضرورية في الصفحة.

إليك مثال لمحتوى علامة HTML المخصّصة:

<script type="application/ld+json">
  {
    "@context": "https://schema.org/",
    "@type": "Recipe",
    "name": "{{recipe_name}}",
    "image": [ "{{recipe_image}}" ],
    "author": {
      "@type": "Person",
      "name": "{{recipe_author}}"
    }
  }
</script>

إنشاء بيانات منظَّمة باستخدام محتوى JavaScript مخصّص

يمكنك أيضًا إنشاء البيانات المنظَّمة باستخدام JavaScript إما لإنشاء جميع بياناتك المنظَّمة أو لإضافة مزيد من المعلومات إلى البيانات المنظَّمة المعروضة على جهة الخادم. وفي كلتا الحالتَين، بإمكان "بحث Google" فهم ومعالجة البيانات المنظَّمة المتوفّرة في نموذج كائن المستند (DOM) عند عرض الصفحة. للاطّلاع على مزيد من المعلومات حول كيفية معالجة JavaScript في "بحث Google"، يمكنك مراجعة دليل القواعد الأساسية في JavaScript.

في ما يلي مثال لبيانات منظَّمة تم إنشاؤها باستخدام JavaScript:

  1. ابحث عن نوع البيانات المنظَّمة الذي يهمّك.
  2. عدِّل HTML الخاص بموقعك الإلكتروني لتضمين مقتطف JavaScript كما هو وارد في المثال أدناه (راجِع المستندات التي يقدّمها موفّر "نظام إدارة المحتوى" (CMS) أو المستضيف، أو اطلب المعلومات من مطوّري البرامج).
    fetch('https://api.example.com/recipes/123')
    .then(response => response.text())
    .then(structuredDataText => {
      const script = document.createElement('script');
      script.setAttribute('type', 'application/ld+json');
      script.textContent = structuredDataText;
      document.head.appendChild(script);
    });
  3. تحقق من نجاح العملية باستخدام اختبار النتائج المنسّقة.

استخدام العرض على جهة الخادم

إذا كنت تستخدم العرض على جهة الخادم، يمكنك أيضًا تضمين البيانات المنظَّمة المطلوبة في الإخراج المعروض. راجِع مستندات إطار العمل الخاص بك لمعرفة كيفية إنشاء JSON-LDلنوع البيانات المنظَّمة الذي يهمّك.

التحقق من نجاح العملية

للتأكد من أنّ "بحث Google" يمكنه الزحف إلى بياناتك المنظَّمة وفهرستها، تحقق من نجاح العملية:

  1. افتح اختبار النتائج المنسّقة.
  2. أدخِل عنوان URL الذي تريد اختباره.
  3. انقر على اختبار عنوان URL.

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

    حاوِل مرة أخرى: إذا رأيت أخطاء أو تحذيرات، من المرجّح أنّ السبب يرجع إلى خطأ في البنية أو إلى عدم توفّر موقع إلكتروني. اطّلع على المستندات الخاصة بنوع البيانات المنظَّمة وتأكّد من إضافة جميع المواقع الإلكترونية. في حال استمرار المشكلة، تأكّد أيضًا من مراجعة الدليل بخصوص معالجة مشاكل JavaScript المرتبطة بالبحث.