حدِّد الروابط لصفحات معيّنة خاصة بمنصة المحتوى الخاص بك.

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

في ما يلي متطلبات الروابط لصفحات في التطبيق:

  • يتطلّب urlTemplate (للكائن المستهدف) رابطًا لصفحة معيّنة.
  • يجب أن تفتح الروابط لصفحات في التطبيق المحتوى المستهدَف على جميع المنصات المحدّدة.
  • يمكن أن تتضمّن الروابط العميقة مَعلمات (&) أو علامات ارتساء (#).
    • إذا لم يتم تفعيل التشغيل التلقائي بشكل تلقائي، ننصحك بإضافة مَعلمة، مثل &autoplay=true، إلى الرابط لصفحة في التطبيق من أجل تفعيل ميزة التشغيل التلقائي على تطبيقك أو منصتك.

مثال على @id وurl وurlTemplate:

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "Movie",
   "@id": "http://www.example.com/my_favorite_movie",
   "url": "http://www.example.com/my_favorite_movie",
   "name": "My Favorite Movie",
   "potentialAction": {
     "@type": "WatchAction",
     "target": {
       "@type": "EntryPoint",
       "urlTemplate": "http://www.example.com/my_favorite_movie&autoplay=true",
       ...
     },
   ...
   },
   ...
}

يمثّل الرمز الزائف التالي السلوك المطلوب عندما يبدأ المستخدم تشغيل المحتوى:

if your app is installed
  open app and initiate playback
elseif your website supports playback
  open your website and initiate playback
else
  take user to your app's install page on the Play or App store and then
  initiate playback after your app is installed

لتحقيق سلوك التشغيل المطلوب، يجب الالتزام بالمتطلبات التالية الخاصة بكل منصة:

iOS
يجب استخدام الروابط العامة.
‫Android وAndroid TV
يمكنك استخدام روابط التطبيقات المتوافقة مع Android أو روابط المخطّطات المخصّصة.

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

android-app://{package_id}/{scheme}/{path}

على سبيل المثال:

android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

لمزيد من التفاصيل، يُرجى الاطّلاع على المواصفات الكاملة.

intent://{package_id}/{scheme}/{path}

على سبيل المثال:

intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

لا تُعدّ تنسيقات معرّفات موارد منتظمة (URI) الأخرى، مثل المثال التالي، روابط مخصّصة مقبولة للمخطط مهام لمحتوى الوسائط:

scheme://{path}

على سبيل المثال:

mynetwork://play?series=20114&title=21141&media=e90c89fa4

أفضل الممارسات

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

في حال عدم تثبيت تطبيقك وكان لديك مشغّل على الويب، قدِّم رابطًا أو بانر ذكيًا إلى متجر Android أو متجر التطبيقات ليتمكّن المستخدمون من تثبيت تطبيقك. إليك مثال على بانر ذكي تم تنفيذه:

مثال على بانر إعلاني ذكي تم تنفيذه

يوضّح الجدول التالي المتطلبات والقيود المفروضة على الروابط لصفحات معيّنة، وذلك حسب صلتها بأجهزة iOS وAndroid وAndroidTV:

iOS ‫Android وAndroidTV
http://‎ أو https://‎ مطلوب ننصح بهذا الإجراء إذا كان الموقع الإلكتروني المتوافق مع الأجهزة الجوّالة يتيح تشغيل المحتوى.
android-app://‎ أو intent://‎ لا ينطبق يُنصح بهذا الخيار إذا كان الموقع الإلكتروني المتوافق مع الأجهزة الجوّالة لا يتيح تشغيل المحتوى.
foo:// (سلسلة عشوائية) غير مسموح به غير مسموح به

أنواع المنصات

لضمان توفّر المحتوى على مساحات عرض Google المتعددة التي تتيح مهام لمحتوى الوسائط، يجب استيفاء المتطلبات التالية:

يحتوي الجدول التالي على قائمة بالمنصات التي تتوافق مع "مهام لمحتوى الوسائط":

النظام الأساسي الوصف
http://schema.org/DesktopWebPlatform منصة البحث على متصفّح الويب على الكمبيوتر المكتبي
http://schema.org/MobileWebPlatform ابحث عن المنصة على متصفّح الويب على الأجهزة الجوّالة.
http://schema.org/AndroidPlatform البحث عن منصات PlayGuide على تطبيق Android
http://schema.org/AndroidTVPlatform منصة Android TV على تطبيق Android TV
http://schema.org/IOSPlatform ابحث عن النظام الأساسي على تطبيق iOS.
http://schema.googleapis.com/GoogleVideoCast منصّتا البث وHome على جهاز Chromecast
http://schema.googleapis.com/GoogleAudioCast إجراءات الاستماع فقط منصّتا البث وHome على جهاز Chromecast

مثال على كيان يتضمّن رابطَين مختلفَين لصفحات معيّنة:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/standardView",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform"
      ]
    },
    {
      "@type":"EntryPoint",
      "urlTemplate":"http://example.com/multipleViews",
      "actionPlatform": [
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "videoFormat",
          "value": [ "HD", "4K" ]
        }
      ],
    }
  ],
  ...
}

سلوك التشغيل

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

سلوك التشغيل في "إجراءات المشاهدة"

بالنسبة إلى "إجراءات المشاهدة"، يجب أن يتوفّر سلوك التشغيل التالي.

جميع الروابط لصفحات معيّنة: Movie وTVEpisode وTVSeries وTVSeason

  • سلوك تسجيل الدخول أو الشراء: إذا كانت خدمتك تتطلّب تسجيل الدخول أو الشراء، يجب تشغيل الفيلم أو الحلقة، حسب نوع المحتوى. لمزيد من التفاصيل، يُرجى الاطّلاع على إرشادات الروابط لصفحات معيّنة أدناه.

  • التشغيل: إذا كانت خدمتك تتتبّع حالة المستخدم، يجب أن يبدأ التشغيل من العلامة السابقة التي وضعها المستخدم على الفيلم أو الحلقة. وفي حال عدم توفّرها، يجب أن يبدأ التشغيل من بداية المحتوى.

  • التشغيل التلقائي: استنادًا إلى النظام الأساسي، يجب أن تشغّل خدمتك المحتوى بشكل بارز بعد أن يختار المستخدم الحلقة أو الفيلم المستهدفَين.

    • البحث: يُنصح بشدة بتفعيل ميزة التشغيل التلقائي، ولكنّها ليست إلزامية. إذا لم تكن ميزة التشغيل التلقائي متاحة، يجب تشغيل المحتوى بنقرة واحدة بعد توجيه المستخدم إلى تطبيقك أو خدمتك.
    • ‫Android TV: يجب تفعيل التشغيل التلقائي للأفلام والحلقات.

الروابط العميقة الخاصة بـ TVSeries وTVSeason فقط

  • اختيار الحلقة المستهدَفة: يجب اختيار الحلقة المستهدَفة المناسبة. إذا كانت خدمتك تتتبّع حالة المستخدم، يجب أن تكون الحلقة المستهدَفة هي الحلقة التي توقّف المستخدم عن مشاهدتها آخر مرة. أو إذا أكمل المستخدم الحلقة التي كان يشاهدها، يمكنك عرض الحلقة التالية بدلاً منها. بخلاف ذلك، يجب أن تكون الحلقة المستهدَفة إحدى الحلقات التالية وفقًا لتقديرك:

    • TVSeries
      • تمثّل هذه السمة الحلقة الأولى من المسلسل. يُنصح به للعروض المتسلسلة.
      • الحلقة الأولى من أحدث موسم ننصحك باستخدامها مع البرامج المتسلسلة الطويلة.
      • الحلقة الأخيرة ننصحك باستخدامها مع البرامج اليومية أو البرامج الإخبارية.
    • TVSeason
      • تمثّل الحلقة الأولى من الموسم. يُنصح به للعروض المتسلسلة.
      • الحلقة الأخيرة ننصحك باستخدامها مع البرامج اليومية أو البرامج الإخبارية.

    يجب أن يكون الرابط لصفحة معيّنة في التطبيق الخاص بـ TVSeries أو TVSeason ثابتًا (غير قابل للتغيير) ويؤدي إلى الحلقة المستهدَفة. لا تستخدِم الرابط لصفحة معيّنة في التطبيق للوصول إلى حلقة معيّنة.

    يقدّم الجدول التالي عدة أمثلة توضّح منطق اختيار الحلقة المستهدَفة المطلوب لأنواع الكيانات TVSeries وTVSeason وTVEpisode:

    استهداف الحلقة إذا شاهد المستخدم آخر مرة الحلقة 24 من الموسم 6 استهداف حلقة إذا لم يشاهد المستخدم أي حلقات
    رابط عميق للمسلسل
    • S6E24 (إذا لم يكمل المستخدم الحلقة S6E24)
    • S6E25 (إذا انتهى المستخدم من مشاهدة S6E24)

    أحد ما يلي:

    • الحلقة الأولى من المسلسل
    • الحلقة الأولى من الموسم الأخير
    • الحلقة الأخيرة
    رابط عميق للموسم (من 1 إلى 5)
    • الحلقة التي شاهدها المستخدم آخر مرة في هذا الموسم، أو الحلقة الأولى من الموسم إذا لم يشاهد المستخدم أي حلقات في هذا الموسم
    • الحلقة الأولى من الموسم
    رابط عميق للموسم (S6)
    • S6E24 (إذا لم يكمل المستخدم الحلقة S6E24)
    • S6E25 (إذا انتهى المستخدم من مشاهدة S6E24)

    أحد ما يلي:

    • الحلقة الأولى من الموسم
    • الحلقة الأخيرة
    رابط عميق للحلقة
    • الحلقة المحدّدة التي تم النقر عليها
    • الحلقة المحدّدة التي تم النقر عليها

طريقة تشغيل "إجراءات الاستماع"

بالنسبة إلى "إجراءات الاستماع"، يجب أن يتوفّر سلوك التشغيل التالي:

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

ننصحك باتّباع أفضل الممارسات التالية في تطبيقك أو منصتك:

  • بالنسبة إلى MusicGroup، شغِّل محتوًى مختلفًا للفنّان في كل مرة يختاره فيها المستخدم.
  • بالنسبة إلى MusicAlbum، يتم تشغيل المحتوى بترتيب ظهوره في الألبوم.
  • بالنسبة إلى MusicPlaylist، شغِّل محتوًى مختلفًا من قائمة التشغيل في كل مرة يختار فيها المستخدم قائمة التشغيل.

فعليك إجراء ما يلي:

  1. بالنسبة إلى كل محتوى، تحقَّق مما إذا كان يتضمّن روابط لصفحات في التطبيق مختلفة استنادًا إلى الأنظمة الأساسية.
  2. بالنسبة إلى كل رابط لصفحة معيّنة، اطرح الأسئلة التالية حول نقطة الدخول (الصفحة على تطبيقك أو منصتك التي ينقلك إليها الرابط):
    • هل تتيح نقطة الدخول (وليس المحتوى) استخدام لغات متعددة؟
    • هل تتيح نقطة الدخول استخدام لغات ترجمة وشرح متعددة؟
    • هل تتيح نقطة الدخول زوايا كاميرا متعددة؟
    • هل تتيح نقطة الدخول استخدام تنسيقات فيديو متعددة؟

إذا كانت إجابتك بنعم على أيّ من هذه الأسئلة، عليك تقديم السمة additionalProperty لذلك الرابط لصفحة في التطبيق. اطّلِع على مثال additionalProperty.