عندما يبدأ المستخدم مهام لمحتوى الوسائط على المحتوى (على سبيل المثال، ينقر المستخدم على الرمز الخاص بك على "بحث 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
على أجهزة 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 المتعددة التي تتيح مهام لمحتوى الوسائط، يجب استيفاء المتطلبات التالية:
- تتطلّب جميع المنصات المتوافقة مع الشركاء رابطًا لصفحة معيّنة في المحتوى.
- بالنسبة إلى منصات Chromecast، عليك إنشاء جهاز استقبال باستخدام أحدث إصدار من حزمة تطوير البرامج (SDK) لجهاز استقبال Cast Application Framework (CAF).
- بالنسبة إلى الأنظمة الأساسية للأجهزة الجوّالة (Android وiOS)، اطّلِع على المتطلبات في قسم استخدام الروابط لصفحات معيّنة لبدء التشغيل.
يحتوي الجدول التالي على قائمة بالمنصات التي تتوافق مع "مهام لمحتوى الوسائط":
| النظام الأساسي | الوصف |
|---|---|
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، شغِّل محتوًى مختلفًا من قائمة التشغيل في كل مرة يختار فيها المستخدم قائمة التشغيل.
تحديد الروابط لصفحات معيّنة في التطبيق
فعليك إجراء ما يلي:
- بالنسبة إلى كل محتوى، تحقَّق مما إذا كان يتضمّن روابط لصفحات في التطبيق مختلفة استنادًا إلى الأنظمة الأساسية.
- بالنسبة إلى كل رابط لصفحة معيّنة، اطرح الأسئلة التالية حول نقطة الدخول (الصفحة على تطبيقك أو منصتك التي ينقلك إليها الرابط):
- هل تتيح نقطة الدخول (وليس المحتوى) استخدام لغات متعددة؟
- هل تتيح نقطة الدخول استخدام لغات ترجمة وشرح متعددة؟
- هل تتيح نقطة الدخول زوايا كاميرا متعددة؟
- هل تتيح نقطة الدخول استخدام تنسيقات فيديو متعددة؟
إذا كانت إجابتك بنعم على أيّ من هذه الأسئلة، عليك تقديم السمة additionalProperty لذلك الرابط لصفحة في التطبيق. اطّلِع على مثال additionalProperty.