البيانات المنظّمة للفيديوهات (VideoObject وClip وBroadcastEvent)

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

محتوى فيديو في نتائج البحث على Google وعلامة تبويب الفيديو وميزة "اقتراحات"

استنادًا إلى طريقة ترميز صفحة المشاهدة، قد تكون فيديوهاتك مؤهَّلة أيضًا للاستفادة من الميزات التالية الخاصة بالفيديوهات:

الميزات الخاصة بالفيديوهات

شارة "مباشر": يمكن إضافة شارة "مباشر" إلى الفيديو عن طريق وضع علامة ‫BroadcastEvent على الفيديو. ويمكن إضافة شارة "مباشر" على أي فيديو علني يتم بثه مباشرةً لأي فترة زمنية. وفي ما يلي بعض الأمثلة على ذلك:

  • الفعاليات الرياضية
  • عروض توزيع الجوائز
  • فيديوهات الأشخاص المؤثرين
  • البث المباشر لألعاب الفيديو

تأكَّد من اتّباع الإرشادات المتعلقة بشارة "مباشر" واستخدام Indexing API لضمان زحف محرّك بحث Google إلى صفحتك في الوقت المناسب.

فيديو يحمل شارة "مباشر" في نتائج البحث

المقاطع الرئيسية

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

  • إذا كان الفيديو مضمّنًا في صفحتك على الويب أو إذا كنت تدير منصةً للفيديو، تتوفّر طريقتان لتفعيل المقاطع الرئيسية:
    • بيانات Clip المنظَّمة: يمكنك تحديد نقطتَي البداية والانتهاء بدقّة لكل قسم والتصنيفات المطلوب عرضها لكل قسم. هذا الخيار متاح بجميع اللغات التي يتوفّر بها "بحث Google".
    • بيانات SeekToAction المنظَّمة: يمكنك إبلاغ محرّك بحث Google بالمكان الذي تظهر فيه الطوابع الزمنية عادةً في بنية عنوان URL ليتمكّن من تحديد المقاطع الرئيسية بشكل تلقائي وربط المستخدمين بتلك النقاط في الفيديو. هذا الخيار متاح باللغات التالية: الإنجليزية والإسبانية والبرتغالية والإيطالية والصينية والفرنسية واليابانية والألمانية والتركية والكورية والهولندية والروسية.
  • إذا كان الفيديو مستضافًا على YouTube، يمكنك تحديد الطوابع الزمنية والتصنيفات بدقّة في وصف الفيديو على YouTube. اطّلِع على أفضل الممارسات لوضع علامات على الطوابع الزمنية في الأوصاف على YouTube. هذا الخيار متاح بجميع اللغات التي يتوفّر بها "بحث Google". إذا أردت تفعيل ميزة "فصول الفيديو" على YouTube، يُرجى اتّباع هذه الإرشادات الإضافية.

لإيقاف ميزة "المقاطع الرئيسية" بالكامل (بما في ذلك أي جهود قد يبذلها محرّك بحث Google لعرض المقاطع الرئيسية تلقائيًا للفيديو)، استخدِم علامة meta المسماة nosnippet.

فيديو يتضمّن مقاطع رئيسية في نتائج البحث

如何添加结构化数据

结构化数据是一种提供网页相关信息并对网页内容进行分类的标准化格式。如果您不熟悉结构化数据，可以详细了解结构化数据的运作方式。

下面概述了如何构建、测试和发布结构化数据。如需获得向网页添加结构化数据的分步指南，请查看结构化数据 Codelab。

  1. 添加必要属性。根据您使用的格式，了解在网页上的什么位置插入结构化数据。
  2. 遵循指南。
  3. 使用富媒体搜索结果测试验证您的代码，并修复所有严重错误。此外，您还可以考虑修正该工具中可能会标记的任何非严重问题，因为这些这样有助于提升结构化数据的质量（不过，要使内容能够显示为富媒体搜索结果，并非必须这么做）。
  4. 部署一些包含您的结构化数据的网页，然后使用网址检查工具测试 Google 看到的网页样貌。请确保您的网页可供 Google 访问，不会因 robots.txt 文件、noindex 标记或登录要求而被屏蔽。如果网页看起来没有问题，您可以请求 Google 重新抓取您的网址。
  5. 为了让 Google 随时了解日后发生的更改，我们建议您提交站点地图。Search Console Sitemap API 可以帮助您自动执行此操作。

أمثلة

نتيجة لفيديو عادي

مثال لنتائج بحث عن فيديو عادي

في ما يلي مثال على VideoObject واحد.

JSON-LD

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "name": "Introducing the self-driving bicycle in the Netherlands",
      "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
      "thumbnailUrl": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "uploadDate": "2024-03-31T08:00:00+08:00",
      "duration": "PT1M54S",
      "contentUrl": "https://www.example.com/video/123/file.mp4",
      "embedUrl": "https://www.example.com/embed/123",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 5647018
      },
      "regionsAllowed": ["US", "NL"]
    }
    </script>
  </head>
  <body>
  </body>
</html>
البيانات الجزئية

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Introducing the self-driving bicycle in the Netherlands</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-03-31T08:00:00+08:00" />
  <meta itemprop="duration" content="PT1M54S" />
  <p itemprop="description">This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="5647018" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <link itemprop="embedUrl" href="https://www.example.com/embed/123" />
  <meta itemprop="contentUrl" content="https://www.example.com/video/123/file.mp4" />
  <meta itemprop="regionsAllowed" content="US" />
  <meta itemprop="regionsAllowed" content="NL" />
  <meta itemprop="thumbnailUrl" content="https://example.com/photos/1x1/photo.jpg" />
</body>
</html>

شارة &quot;مباشر&quot;

مثال لفيديو يظهر ضمن نتائج البحث مع شارة &quot;مباشر&quot;

في ما يلي مثال على السمة VideoObject والسمة BroadcastEvent.

JSON-LD

<html>
  <head>
    <title>Bald Eagle at the Park - Livestream</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "contentURL": "https://example.com/bald-eagle-at-the-park.mp4",
      "description": "Bald eagle at the park livestream.",
      "duration": "PT37M14S",
      "embedUrl": "https://example.com/bald-eagle-at-the-park",
      "expires": "2024-10-30T14:37:14+00:00",
      "regionsAllowed": "US",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 4756
      },
      "name": "Bald eagle nest livestream!",
      "thumbnailUrl": "https://example.com/bald-eagle-at-the-park",
      "uploadDate": "2024-10-27T14:00:00+00:00",
      "publication": [
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T14:00:00+00:00",
          "endDate": "2024-10-27T14:37:14+00:00"
        },
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T18:00:00+00:00",
          "endDate": "2024-10-27T18:37:14+00:00"
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>
البيانات الجزئية

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Bald Eagle at the Park - Livestream</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-10-27T14:00:00+00:00" />
  <meta itemprop="duration" content="PT37M14S" />
  <p itemprop="description">Bald eagle at the park livestream.</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="4756" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <link itemprop="embedUrl" href="https://example.com/bald-eagle-at-the-park" />
  <meta itemprop="expires" content="2024-10-30T14:37:14+00:00" />
  <meta itemprop="contentUrl" content="https://example.com/bald-eagle-at-the-park.mp4" />
  <meta itemprop="regionsAllowed" content="US" />
  <meta itemprop="thumbnailUrl" content="https://example.com/bald-eagle-at-the-park" />
  <div itemprop="publication" itemtype="https://schema.org/BroadcastEvent" itemscope>
    <meta itemprop="isLiveBroadcast" content="true" />
    <meta itemprop="startDate" content="2024-10-27T14:00:00+00:00" />
    <meta itemprop="endDate" content="2024-10-27T14:37:14+00:00" />
  </div>
  <div itemprop="publication" itemtype="https://schema.org/BroadcastEvent" itemscope>
    <meta itemprop="isLiveBroadcast" content="true" />
    <meta itemprop="startDate" content="2024-10-27T18:00:00+00:00" />
    <meta itemprop="endDate" content="2024-10-27T18:37:14+00:00" />
  </div>
</body>
</html>

Clip

مثال على فيديو في نتائج البحث يتضمّن مقاطع رئيسية

إليك مثال على السمة VideoObject والسمة Clip.

JSON-LD

<html>
  <head>
    <title>Cat jumps over the fence</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "VideoObject",
      "name": "Cat video",
      "duration": "PT10M",
      "uploadDate": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://www.example.com/cat.jpg",
      "description": "Watch this cat jump over a fence!",
      "contentUrl": "https://www.example.com/cat_video_full.mp4",
      "ineligibleRegion": "US",
      "hasPart": [{
        "@type": "Clip",
        "name": "Cat jumps",
        "startOffset": 30,
        "endOffset": 45,
        "url": "https://www.example.com/example?t=30"
      },
      {
        "@type": "Clip",
        "name": "Cat misses the fence",
        "startOffset": 111,
        "endOffset": 150,
        "url": "https://www.example.com/example?t=111"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>
البيانات الجزئية

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Cat jumps over the fence</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-07-19" />
  <meta itemprop="duration" content="P10M" />
  <p itemprop="description">Watch this cat jump over a fence!</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="5647018" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <div itemprop="hasPart" itemtype="https://schema.org/Clip" itemscope>
    <meta itemprop="name" content="Cat jumps" />
    <meta itemprop="startOffset" content="30" />
    <meta itemprop="endOffset" content="45" />
    <meta itemprop="url" content="https://www.example.com/example?t=30" />
  </div>
  <div itemprop="hasPart" itemtype="https://schema.org/Clip" itemscope>
    <meta itemprop="name" content="Cat misses the fence" />
    <meta itemprop="startOffset" content="111" />
    <meta itemprop="endOffset" content="150" />
    <meta itemprop="url" content="https://www.example.com/example?t=111" />
  </div>
  <link itemprop="embedUrl" href="https://www.example.com/embed/123" />
  <meta itemprop="contentUrl" content="https://www.example.com/cat_video_full.mp4" />
  <meta itemprop="ineligibleRegion" content="US" />
  <meta itemprop="thumbnailUrl" content="https://www.example.com/cat.jpg" />
</body>
</html>

SeekToAction

إليك مثال على سمة VideoObject واحدة تشمل السمات الإضافية المطلوبة لترميز SeekToAction.

JSON-LD

<html>
  <head>
    <title>John Smith (@johnsmith123) on VideoApp: My daily workout! #stayingfit</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "potentialAction" : {
        "@type": "SeekToAction",
        "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
        "startOffset-input": "required name=seek_to_second_number"
      },
      "name": "My daily workout!",
      "uploadDate": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://www.example.com/daily-workout.jpg",
      "description": "My daily workout!",
      "embedUrl": "https://example.com/daily-workout"
    }
    </script>
  </head>
  <body>
  </body>
</html>
البيانات الجزئية

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">John Smith (@johnsmith123) on VideoApp: My daily workout! #stayingfit</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-07-19" />
  <p itemprop="description">My daily workout!</p>
  <div itemprop="potentialAction" itemtype="https://schema.org/SeekToAction" itemscope>
    <meta itemprop="target" content="https://video.example.com/watch/videoID?t={seek_to_second_number}" />
    <meta itemprop="startOffset-input" content="required name=seek_to_second_number" />
  </div>
  <link itemprop="embedUrl" href="https://example.com/daily-workout" />
  <meta itemprop="thumbnailUrl" content="https://www.example.com/daily-workout.jpg" />
</body>
</html>

الإرشادات

لتصبح البيانات المنظَّمة للفيديوهات مؤهَّلة للاستخدام في &quot;بحث Google&quot;، يجب اتّباع أساسيات &quot;بحث Google&quot; والإرشادات العامة حول البيانات المنظَّمة ومتطلبات فهرسة الفيديوهات.

بالإضافة إلى ذلك، ننصحك بالاطّلاع على هذه الإرشادات لمعرفة ما إذا كانت سارية على محتوى الفيديو الخاص بك:

الإرشادات المتعلقة بشارة &quot;مباشر&quot;

في حال إضافة السمة BroadcastEvent إلى فيديوهات البثّ المباشر، يُرجى اتباع الإرشادات التالية:

  • لا تستخدم لغة بذيئة أو مسيئة في البيانات المنظَّمة.
  • للتأكّد من أنّ محرّك بحث Google يزحف إلى فيديو البث المباشر في الوقت المناسب، استخدِم Indexing API. ويمكنك طلب واجهة برمجة التطبيقات للأحداث التالية:
    • عندما يكون الفيديو قيد البث المباشر
    • عند إيقاف البث المباشر للفيديو وتعديل صفحة الترميز للإشارة إلى endDate
    • عند حدوث تغيير في الترميز ويلزم إبلاغ Google به

أفضل الممارسات لوضع علامات على الطوابع الزمنية في YouTube

إذا تمت استضافة الفيديو الخاص بك على YouTube، قد يعرض &quot;بحث Google&quot; مقاطع رئيسية من الفيديو تلقائيًا استنادًا إلى وصف الفيديو على YouTube، وقد لا تحتاج إلى وضع علامات على طوابع زمنية معيّنة في الوصف على YouTube. ومع ذلك، يمكنك إخبارنا بشكل صريح بالنقاط المهمّة في الفيديو الخاص بك وسوف نعطي أفضلية لهذه المعلومات. يوضّح المخطّط التالي شكل ظهور الطوابع الزمنية والتصنيفات المضمّنة في وصف فيديو على YouTube في نتائج البحث:

فيديو في نتائج البحث يضم طوابع زمنية وتصنيفات
1. التصنيف: اسم مقطع الفيديو
2. الطابع الزمني: عندما يبدأ مقطع فيديو

يُرجى أخذ الإرشادات التالية بعين الاعتبار عند تنسيق الطوابع الزمنية والتصنيفات للأوصاف على YouTube:

  • تنسيق الطابع الزمني بالتنسيق التالي: [hour]:[minute]:[second]. إذا لم يكن هناك ساعة، لن تحتاج إلى تضمينها.
  • تحديد تصنيف الطابع الزمني على سطر الطابع الزمني نفسه.
  • وضْع كل طابع زمني على سطر جديد في وصف الفيديو.
  • ربط الطابع الزمني بالنقطة المُحددَّة في الفيديو.
  • التأكُّد من أنّ التصنيف يحتوي على كلمة واحدة على الأقل
  • ترتيب الطوابع الزمنية حسب التسلسل الزمني

إذا أردت تفعيل ميزة &quot;فصول الفيديو&quot; على YouTube، يُرجى اتّباع هذه الإرشادات الإضافية.

الإرشادات المتعلقة بالعلامتَين Clip وSeekToAction

إذا كنت تضيف بيانات Clip أو SeekToAction المنظَّمة لوضع علامة على أقسام الفيديو، يُرجى اتّباع الإرشادات التالية:

  • يجب أن يوفّر الفيديو إمكانية إنشاء رابط لصفحة معيّنة في نقطة غير نقطة البداية على عنوان URL الخاص بالفيديو. على سبيل المثال، تسمح السمة https://www.example.com/example?t=30 بفتح الفيديو بعد مرور 30 ثانية من بدايته.
  • يجب إضافة بيانات VideoObject المنظَّمة إلى صفحة يمكن للمستخدمين من خلالها مشاهدة الفيديو. ومن بين التجارب السيئة التي يتعرض لها المستخدمون، توجيههم إلى صفحة لا تتيح لهم مشاهدة الفيديو.
  • يجب ألّا تقلّ المدة الإجمالية للفيديو عن 30 ثانية.
  • يجب أن يتضمّن الفيديو السمات المطلوبة المدرَجة في مستندات بيانات VideoObject المنظَّمة.
  • بالنسبة إلى بيانات Clip المنظَّمة فقط: احرص على عدم تكرار وقت البدء في مقطعَين على الفيديو نفسه المحدّد في الصفحة نفسها.
  • بالنسبة إلى بيانات SeekToAction المنظَّمة فقط: يجب أن يكون محرّك بحث Google قادرًا على جلب ملفات محتوى الفيديو.

تعريفات أنواع البيانات المنظّمة

يوضّح هذا القسم أنواع البيانات المنظَّمة ذات الصلة بميزات الفيديو في &quot;بحث Google&quot;. يجب تضمين سمات VideoObject المطلوبة لكي يصبح الترميز مؤهّلاً للاستخدام في &quot;بحث Google&quot;. ويمكنك أيضًا تضمين السمات التي يُنصح بها لإضافة المزيد من المعلومات المتعلقة بـ VideoObject، ما يؤدي إلى تحسين تجربة المستخدم. فضلاً عن VideoObject، يمكنك إضافة أنواع البيانات التالية لتفعيل تحسينات الفيديو في &quot;بحث Google&quot;:

  • ‫BroadcastEvent: استخدِم هذه العلامة لترميز فيديوهات البثّ المباشر لتفعيل شارة &quot;مباشر&quot; على الفيديو.
  • ‫Clip: ضَع علامة على الأقسام المهمة في الفيديو لمساعدة المستخدمين على التنقّل بسرعة إلى نقاط محدّدة فيه.
  • ‫SeekToAction: فعِّل &quot;المقاطع الرئيسية&quot; من خلال الإشارة إلى كيفية عمل بنية عنوان URL، ليتمكّن محرّك بحث Google من تحديد المقاطع الرئيسية بشكل تلقائي وربط المستخدمين بتلك النقاط في الفيديو.

VideoObject

يتوفّر تعريف VideoObject الكامل على schema.org/VideoObject. إذا لم يتم تضمين السمات المطلوبة، قد يتعذَّر على Google استخلاص أي معلومات عن الفيديو. ويمكنك أيضًا تضمين السمات المقترَحة لإضافة المزيد من المعلومات المتعلقة بالمحتوى، ما يؤدي إلى تحسين تجربة المستخدم.

السمات المطلوبة
name

Text

تمثّل هذه السمة عنوان الفيديو. احرص على استخدام نص فريد في السمة name لكل فيديو على موقعك الإلكتروني.
thumbnailUrl

‫URL مكرّر

تمثّل هذه السمة عنوان URL يوجّه المستخدم إلى ملف الصورة المصغّرة الفريدة للفيديو. اتّبِع إرشادات الصور المصغّرة.
uploadDate

DateTime

تمثّل هذه السمة تاريخ ووقت نشر الفيديو لأول مرة بالتنسيق ISO 8601. ننصحك بتوفير معلومات عن المنطقة الزمنية. إذا لم توفّرها، سنعتمد المنطقة الزمنية التي يستخدمها Googlebot كخيار تلقائي.
السمات التي يُنصح بها
contentUrl

URL

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

"contentUrl": "https://www.example.com/video/123/file.mp4"

احرص على اتّباع أفضل الممارسات المتعلّقة بتحسين محرّكات البحث لظهور الفيديوهات في نتائج البحث.
description

Text

تمثل هذه السمة وصف الفيديو. احرص على استخدام نص فريد في السمة description لكل فيديو على موقعك الإلكتروني. يتم تجاهل علامات HTML.
duration

Duration

تمثّل هذه السمة مدة الفيديو بالتنسيق ISO 8601. على سبيل المثال، تمثّل السمة PT00H30M5S مدة "ثلاثين دقيقة وخمس ثوانٍ".
embedUrl

URL

تمثّل هذه السمة عنوان URL يوجّه إلى مشغّل الفيديو المحدد. لا تضمِّن رابطًا يؤدي إلى الصفحة التي يظهر فيها الفيديو، بل يجب أن يكون هذا الرابط عنوان URL لمشغّل الفيديو نفسه. ويكون محتوى هذه السمة عادةً المعلومات التي تتضمّنها السمة src لعنصر <embed>.

"embedUrl": "https://www.example.com/embed/123"

احرص على اتّباع أفضل الممارسات لظهور الفيديوهات في نتائج البحث.
expires DateTime

تمثّل هذه السمة التاريخ والوقت (في حال توفّرهما) اللذين لن يعود الفيديو متاحًا بعدهما بالتنسيق ISO 8601. لا توفّر هذه المعلومات إذا لم يكُن للفيديو تاريخ انتهاء صلاحية. ننصحك بتوفير معلومات عن المنطقة الزمنية. إذا لم توفّرها، سنعتمد تلقائيًا المنطقة الزمنية التي يستخدمها Googlebot.
hasPart

إذا كان الفيديو يحتوي على أقسام مهمة، يمكنك دمج سمات Clip المطلوبة في VideoObject. على سبيل المثال:

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "hasPart": {
    "@type": "Clip",
    "name": "Cat jumps",
    "startOffset": 30,
    "url": "https://www.example.com/example?t=30"
  }
}
</script>
ineligibleRegion

Place

تمثّل هذه السمة المنطقة التي لا يُسمح بعرض الفيديو فيها، إذا كان ذلك منطبقًا. في حال عدم تحديد هذه السمة، يفترض محرّك البحث Google أنّ الفيديو مسموح بعرضه في كل مكان. حدِّد البلدان بالتنسيق ISO 3166-1 المكوّن من حرفين أو ثلاثة أحرف. بالنسبة إلى القيم المتعددّة، استخدِم رموز بلدان متعدّدة (على سبيل المثال، مصفوفة JSON-LD أو عدة علامات meta في البيانات الجزئية).
interactionStatistic

InteractionCounter

تمثّل هذه السمة عدد مشاهدات الفيديو. على سبيل المثال:

"interactionStatistic":
  {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "WatchAction" },
    "userInteractionCount": 12345
  }
publication

في حال كان الفيديو الخاص بك سيُبثّ مباشرةً وأردت أن يحصل على شارة &quot;مباشر&quot;، عليك دمج سمات BroadcastEvent في VideoObject الخاص بك. على سبيل المثال:

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "publication": {
    "@type": "BroadcastEvent",
    "name": "First scheduled broadcast",
    "isLiveBroadcast": true,
    "startDate": "2018-10-27T14:00:00+00:00",
    "endDate": "2018-10-27T14:37:14+00:00"
  }
}
</script>
regionsAllowed

Place

تمثّل هذه السمة المناطق التي يُسمح فيها بعرض الفيديو، إذا كان ذلك منطبقًا. في حال عدم تحديد هذه السمة، يفترض محرّك البحث Google أنّ الفيديو مسموح بعرضه في كل مكان. حدِّد البلدان بالتنسيق ISO 3166-1 المكوّن من حرفين أو ثلاثة أحرف. بالنسبة إلى القيم المتعددّة، استخدِم رموز بلدان متعدّدة (على سبيل المثال، مصفوفة JSON-LD أو عدة علامات meta في البيانات الجزئية).

BroadcastEvent

لعرض شارة &quot;مباشر&quot; على الفيديو، عليك دمج السمات التالية في VideoObject. مع أنّ سمات BroadcastEvent غير مطلوبة، يجب إضافة السمات التالية إذا كنت تريد عرض شارة &quot;مباشر&quot; على الفيديو الخاص بك.

يتوفّر تعريف BroadcastEvent الكامل على schema.org/BroadcastEvent.

السمات المطلوبة
publication

BroadcastEvent

تصف هذه السمة وقت البث المباشر للفيديو. يمكن أن تكون قائمة أو عنصرًا واحدًا.
publication.endDate

DateTime

تمثّل هذه السمة الوقت والتاريخ لموعد انتهاء البث المباشر أو لموعد انتهائه المتوقّع، بالتنسيق ISO 8601.

يجب توفير السمة endDate بعد انتهاء الفيديو وانتهاء بثه المباشر. إذا كانت القيمة المتوقّعة للسمة endDate غير معروفة قبل بدء البث المباشر، ننصح بتقديم قيمة تقريبية للسمة endDate.

إذا كانت قيمة السمة endDate في الحاضر أو في الماضي، يعني ذلك أنّ البث المباشر قد انتهى. وإذا كانت قيمة السمة endDate في المستقبل، يعني ذلك أنّ البث المباشر سينتهي في ذلك الوقت.
publication.isLiveBroadcast

منطقي

اضبط القيمة على سمة true إذا كان الفيديو قيد البث المباشر أو سيتم بثه بشكل مباشر.

publication.startDate

DateTime

تمثّل هذه السمة الوقت والتاريخ اللذين سيبدأ فيهما البث المباشر أو اللذين يُتوقع بدؤه فيهما بالتنسيق ISO 8601. إذا كانت قيمة السمة startDate في الحاضر أو في الماضي، يعني ذلك أنّ البث المباشر قد بدأ. وإذا كانت قيمة السمة startDate في المستقبل، يعني ذلك أنّ البث المباشر سيبدأ في ذلك الوقت.

Clip

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

يتوفّر التعريف الكامل للسمة Clip على schema.org/Clip.

السمات المطلوبة
name

Text

تمثّل هذه السمة عنوانًا وصفيًا لمحتوى المقطع.
startOffset

Number

تمثّل هذه السمة وقت بدء المقطع، ويتم التعبير عنه بعدد الثواني من بداية التشغيل.
url

URL

تمثّل هذه السمة عنوان URL يشير إلى وقت بدء المقطع.

يجب أن يشير عنوان URL الخاص بالمقطع إلى مسار عنوان URL نفسه الخاص بالفيديو مع تضمين مَعلمات طلب بحث إضافية تحدّد الوقت.

على سبيل المثال، يشير عنوان URL التالي إلى أنّ الفيديو يبدأ عند نقطة 2:00 دقيقة:

"url": "https://www.example.com/example?t=120"
السمات التي يُنصح بها
endOffset

Number

تمثّل هذه السمة وقت انتهاء المقطع الذي يتم التعبير عنه بعدد الثواني من بداية تشغيل الفيديو.

SeekToAction

لإبلاغ Google بطريقة عمل بنية عنوان URL (ليتمكّن محرّك بحث Google من عرض المقاطع الرئيسية التي يتم تحديدها تلقائيًا للفيديو الخاص بك)، عليك دمج السمات التالية في السمة VideoObject. وعلمًا أنّ سمات SeekToAction غير مطلوبة، يجب إضافة السمات التالية إذا كنت تريد من محرّك بحث Google فهم طريقة عمل بنية عنوان URL ليتمكّن من ربط المستخدمين بنقطة معيّنة في الفيديو.

يتوفّر تعريف SeekToAction الكامل على schema.org/SeekToAction.

السمات المطلوبة
potentialAction

SeekToAction

تشير هذه السمة إلى إجراء محتمل. يُرجى تضمين السمات المدمَجة التالية:

مثلاً: 

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "potentialAction" : {
    "@type": "SeekToAction",
    "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
    "startOffset-input": "required name=seek_to_second_number"
  }
}
potentialAction.startOffset-input

Text

تمثّل هذه السمة سلسلة العنصر النائب التي سيحدّدها محرّك بحث Google كبنية للطابع الزمني، لاستبدالها لاحقًا بعدد الثواني التي يجب التخطّي إليها. استخدِم القيمة التالية:

"startOffset-input": "required name=seek_to_second_number"

‫startOffset-input هي سمة تحتوي على تعليقات توضيحية. انتقِل إلى صفحة Potential Actions للحصول على مزيد من المعلومات.

potentialAction.target

EntryPoint

تمثّل هذه السمة عنوان URL الخاص بالصفحة التي تحتوي على السمة VideoObject، بما في ذلك العنصر النائب في بنية عنوان URL الذي يشير إلى الموضع حيث يمكن أن يدرج محرّك بحث Google عدد الثواني التي يجب تخطّيها في الفيديو. بهذه الطريقة، يفهم محرّك بحث Google بنية عنوان URL وتستطيع تنسيق الطوابع الزمنية. استبدِل جزء الطابع الزمني لعنوان URL بسلسلة العنصر النائب التالية:

{seek_to_second_number}

على سبيل المثال، استبدِل جزء الطابع الزمني في عنوان URL: 

"target": "https://video.example.com/watch/videoID?t=30"

بحيث يظهر الطابع الزمني على النحو التالي:

"target": "https://video.example.com/watch/videoID?t={seek_to_second_number}"

使用 Search Console 监控富媒体搜索结果

Search Console 是一款工具，可帮助您监控网页在 Google 搜索结果中的显示效果。即使没有注册 Search Console，您的网页也可能会显示在 Google 搜索结果中，但注册 Search Console 能够帮助您了解 Google 如何查看您的网站并做出相应的改进。建议您在以下情况下查看 Search Console：

  1. 首次部署结构化数据后
  2. 发布新模板或更新代码后
  3. 定期分析流量时

首次部署结构化数据后

等 Google 将网页编入索引后，请在相关的富媒体搜索结果状态报告中查看是否存在问题。 理想情况下，有效项目数量会增加，而无效项目数量不会增加。如果您发现结构化数据存在问题，请执行以下操作：

  1. 修正无效项目。
  2. 检查实际网址，核实问题是否仍然存在。
  3. 使用状态报告请求验证。

发布新模板或更新代码后

如果对网站进行重大更改，请监控结构化数据无效项目的增幅。
  • 如果您发现无效项目增多了，可能是因为您推出的某个新模板无法正常工作，或者您的网站以一种新的错误方式与现有模板交互。
  • 如果您发现有效项目减少了（但无效项目的增加情况并不对应），可能是因为您的网页中未再嵌入结构化数据。请通过网址检查工具了解导致此问题的原因。

定期分析流量时

请使用效果报告分析您的 Google 搜索流量。数据将显示您的网页在 Google 搜索结果中显示为富媒体搜索结果的频率、用户点击该网页的频率以及网页在搜索结果中的平均排名。您还可以使用 Search Console API 自动提取这些结果。

问题排查

如果您在实施或调试结构化数据时遇到问题，请查看下面列出的一些实用资源。

  • 如果您使用了内容管理系统 (CMS) 或其他人负责管理您的网站，请向其寻求帮助。请务必向其转发列明问题细节的任何 Search Console 消息。
  • Google 不能保证使用结构化数据的功能一定会显示在搜索结果中。如需查看导致 Google 无法将您的内容显示为富媒体搜索结果的各种常见原因，请参阅结构化数据常规指南。
  • 您的结构化数据可能存在错误。请参阅结构化数据错误列表。
  • 如果您的网页受到结构化数据手动操作的影响，其中的结构化数据将会被忽略（但该网页仍可能会出现在 Google 搜索结果中）。如需修正结构化数据问题，请使用“人工处置措施”报告。
  • 再次查看相关指南，确认您的内容是否未遵循指南。问题可能是因为出现垃圾内容或使用垃圾标记导致的。不过，问题可能不是语法问题，因此富媒体搜索结果测试无法识别这些问题。
  • 针对富媒体搜索结果缺失/富媒体搜索结果总数下降进行问题排查。
  • 请等待一段时间，以便 Google 重新抓取您的网页并重新将其编入索引。请注意，网页发布后，Google 可能需要几天时间才会找到和抓取该网页。有关抓取和索引编制的常见问题，请参阅 Google 搜索抓取和索引编制常见问题解答。
  • 在 Google 搜索中心论坛中发帖提问。