عندما يبدأ المستخدم إجراءات متعلقة بالوسائط على المحتوى (على سبيل المثال، عندما ينقر المستخدم على رمزك في "بحث 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) للمخطط المخصّص. يضمن ذلك
يتم نقل المستخدم إلى صفحة تطبيقك على "متجر 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 أو App Store لتثبيت التطبيق. لإعادة التوجيه، استخدِم روابط Firebase الديناميكية. أو منصات روابط ذكية تابعة لجهات خارجية
في حال لم يكن تطبيقك مثبّتًا وكان لديك مشغّل على الويب، توفير رابط أو إعلان بانر ذكي إلى متجر Android أو App Store للمستخدمين تثبيت تطبيقك. في ما يلي مثال على إعلان بانر ذكي تم تنفيذه:
ملخّص متطلبات الربط بصفحة معيّنة وقيودها
يوضّح الجدول التالي المتطلبات والقيود المتعلقة بالروابط لصفحات في التطبيق، حيث أنظمة التشغيل iOS وAndroid وAndroidTV:
iOS | Android وAndroidTV | |
---|---|---|
http:// أو https:// | مطلوب | ويُنصح بهذا الإجراء إذا كان الموقع الإلكتروني للأجهزة الجوّالة يتيح التشغيل. |
android-app:// أو intent:// | لا ينطبق | يُنصح بهذا الخيار إذا كان الموقع الإلكتروني للأجهزة الجوّالة لا يتيح التشغيل. |
foo:// (سلسلة عشوائية) | غير مسموح به | غير مسموح به |
أنواع المنصات
لضمان توفُّر المحتوى الخاص بك على منصات Google المتعددة ("بحث Google" و"مساعد Google" وAndroid TV وChromecast)، عليك استيفاء المتطلبات التالية:
- تتطلّب جميع المنصات المتوافقة مع الشركاء رابطًا لموضع معيّن في المحتوى الخاص بك.
- بالنسبة إلى أنظمة Chromecast الأساسية، عليك إنشاء جهاز استقبال باستخدام أحدث إصدار من حزمة تطوير البرامج (SDK) الخاصة باستقبال إطار عمل تطبيق البث (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
|
منصّتا "البث" و"المنزل" على جهاز Chromecast |
http://schema.googleapis.com/GoogleAudioCast
|
إجراءات الاستماع فقط: منصّتا "البث" و"المنزل" على جهاز 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 وTV وTVSeries وTVSeason
سلوك المستخدمين في تسجيل الدخول أو الشراء: إذا كانت خدمتك تتطلّب تسجيل الدخول أو الذي تشتريه، فيجب تشغيل الفيلم أو الحلقة، على النحو المناسب الكتابة بعد ذلك. ولمعرفة مزيد من التفاصيل، يُرجى الاطّلاع على إرشادات الروابط المؤدية إلى صفحات في التطبيق اتباعها.
التشغيل: إذا كانت الخدمة تتتبّع حالة المستخدم، يجب أن يبدأ التشغيل من علامة المستخدم السابقة على الفيلم أو الحلقة. وبخلاف ذلك، يجب أن يكون التشغيل البدء من بداية المحتوى.
التشغيل التلقائي: وفقًا للمنصّة التي تستخدمها، يجب أن تعرض الخدمة المحتوى بشكل بارز بعد أن يختار المستخدم الحلقة أو الفيلم المستهدفَين.
- البحث: ننصح بشدة باستخدام ميزة "التشغيل التلقائي"، ولكنّها ليست مطلوبة. إذا لم تكن ميزة التشغيل التلقائي متاحة، يجب تشغيل المحتوى بنقرة واحدة بعد نقل المستخدم إلى تطبيقك أو خدمتك.
- Android TV: يجب تفعيل ميزة "التشغيل التلقائي" للأفلام والحلقات.
روابط لصفحات معيّنة في قناة TVSeries وTVSeason فقط
اختيار الحلقة المستهدَفة: يجب اختيار الحلقة المستهدَفة المناسبة. في حال حذف خدمتك تتتبّع حالة المستخدم، يجب أن تكون الحلقة المستهدَفة هي الحلقة التي توقف المستخدم عن مشاهدتها آخر مرة. أو، إذا أنهى المستخدم عملية آخر حلقة شاهدوها، جعل الحلقة المستهدفة حلقة بدلاً من ذلك. وبخلاف ذلك، يجب أن تكون الحلقة المستهدَفة واحدة مما يلي: حسب تقديرك:
TVSeries
- تمثّل هذه السمة الحلقة الأولى من المسلسل. يُنصح به للعروض المتسلسلة.
- الحلقة الأولى من الموسم الأخير. مُقترَحة لـ برامج متسلسلة وطويلة الأمد
- الحلقة الأخيرة يُنصح به للبرامج اليومية أو البرامج ذات الصلة بالأخبار.
TVSeason
- تمثّل هذه السمة الحلقة الأولى من الموسم. يُنصح به للعروض المتسلسلة.
- الحلقة الأخيرة يُنصح به للبرامج اليومية أو البرامج ذات الصلة بالأخبار.
يجب أن يكون الرابط لصفحة في التطبيق
TVSeries
أوTVSeason
ثابتًا (غير متغير). ثم الانتقال إلى الحلقة المستهدفة. لا تستخدم رابط الصفحة في التطبيق حلقة محددة.يقدم الجدول التالي عدة أمثلة توضح المتطلبات منطق اختيار الحلقة المستهدَفة لكل من
TVSeries
وTVSeason
نوعان (TVEpisode
) من الكيانات:الحلقة المستهدفة إذا شاهد المستخدم آخر مرة S6E24 الحلقة المستهدفة إذا لم يشاهد المستخدم أي حلقات. رابط لصفحة معيّنة في السلسلة - S6E24 (إذا لم يكمل المستخدم S6E24)
- S6E25 (إذا انتهى المستخدم من مشاهدة S6E24)
يجب استخدام إحدى السمات التالية:
- الحلقة الأولى من المسلسل
- الحلقة الأولى من أحدث موسم
- الحلقة الأخيرة
رابط لصفحة في التطبيق خلال الموسم (S1-S5) - الحلقة التي شاهدها المستخدم آخر مرة في هذا الموسم الحلقة الأولى من الموسم إذا لم يشاهد المستخدم أيًّا منها الحلقات في هذا الموسم.
- الحلقة الأولى من الموسم
رابط لصفحة في التطبيق ضمن الموسم (S6) - S6E24 (إذا لم يكمل المستخدم S6E24)
- S6E25 (إذا انتهى المستخدم من مشاهدة S6E24)
يجب استخدام إحدى السمات التالية:
- الحلقة الأولى من الموسم
- الحلقة الأخيرة
رابط لصفحة معيّنة في التطبيق - الحلقة المحدّدة التي تم النقر عليها
- الحلقة المحدّدة التي تم النقر عليها
سلوك تشغيل إجراءات الاستماع
بالنسبة إلى "إجراءات الاستماع"، يجب اتّباع سلوك التشغيل التالي:
- يجب تشغيل المحتوى بنقرة واحدة بعد نقل المستخدِم إلى تطبيقك أو خدمتك.
- إذا كان التطبيق أو النظام الأساسي يتطلب تسجيل الدخول، يجب تشغيل المحتوى على الفور أو بنقرة واحدة بعد تسجيل الدخول.
- يجب أن يوفّر تطبيقك أو نظامك الأساسي طريقة واحدة على الأقل ليتمكّن جميع المستخدمين من تشغيل الأغنية أو الألبوم أو الفنّان أو قائمة التشغيل نفسها.
- بالنسبة إلى المستخدمين غير المؤهَّلين لتشغيل المحتوى المحدّد (على سبيل المثال، ليس لديهم الاشتراك المطلوب)، يجب أن توضّح الخدمة الإجراءات التي يجب أن يتّخذها المستخدم ليصبح مؤهّلاً لتشغيل المحتوى المحدّد عند وصوله إلى تطبيقك أو منصتك.
ننصح باتّباع أفضل الممارسات التالية لتطبيقك أو نظامك الأساسي:
- بالنسبة إلى
MusicGroup
، شغِّل محتوى مختلفًا عن الفنّان في كل مرة يختار فيها المستخدم الفنّان. - مقابل
MusicAlbum
، شغِّل المحتوى حسب ترتيب ظهوره في الألبوم. - بالنسبة إلى
MusicPlaylist
، شغِّل محتوى مختلفًا من قائمة التشغيل في كل مرة يختار فيها المستخدم قائمة التشغيل.
تحديد الروابط لصفحات معيّنة
فعليك إجراء ما يلي:
- في كل محتوى، تحقق مما إذا كان يتضمن روابط مختلفة لصفحات في التطبيق بناءً على الأنظمة الأساسية.
- بالنسبة إلى كل رابط لصفحة في التطبيق، اطرح الأسئلة التالية حول نقطة دخوله (الصفحة على تطبيقك أو نظامك الأساسي التي ينقلك إليها الرابط لصفحة في التطبيق):
- هل نقطة الدخول (وليس المحتوى) تدعم لغات متعددة؟
- هل تدعم نقطة الدخول لغات الترجمة المتعددة؟
- هل نقطة الدخول متوافقة مع زوايا متعددة للكاميرا؟
- هل تتيح نقطة الدخول تنسيقات فيديو متعددة؟
إذا كانت إجابتك "نعم" على أي من هذه الأسئلة، عليك توفير السمة additionalProperty
لهذا الرابط لصفحة في التطبيق. اطّلِع على مثال additionalProperty.