پیوندهای عمیق محتوای خود را برای پلتفرم مشخص کنید

وقتی کاربری روی محتوا، عملیات رسانه‌ای (Media Actions) را آغاز می‌کند (مثلاً روی آیکون شما در جستجوی گوگل کلیک می‌کند)، گوگل با استفاده از لینک عمیق محتوا، کاربر را مستقیماً به محتوای موجود در برنامه یا پلتفرم شما هدایت می‌کند.

الزامات مربوط به لینک‌های عمیق به شرح زیر است:

  • urlTemplate (از یک شیء هدف ) به یک لینک عمیق نیاز دارد.
  • لینک‌های عمیق باید محتوای مورد نظر خود را در تمام پلتفرم‌های مشخص شده باز کنند.
  • لینک‌های عمیق می‌توانند شامل پارامترها (&) یا تگ‌های لنگر (#) باشند.

مثالی از @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

برای دستیابی به رفتار پخش مطلوب، الزامات خاص پلتفرم زیر را رعایت کنید:

آی‌او‌اس
شما باید از لینک‌های جهانی استفاده کنید.
اندروید و تلویزیون اندروید
می‌توانید از لینک‌های برنامه اندروید یا لینک‌های طرح سفارشی استفاده کنید.

در اندروید و اندروید تی‌وی، می‌توانید از لینک‌های طرح سفارشی نیز استفاده کنید. 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

بهترین شیوه‌ها

در صورتی که برنامه شما نصب نشده است و پخش کننده وب ندارید، سرور وب خود را طوری پیکربندی کنید که به طور خودکار کاربر را برای نصب برنامه شما به فروشگاه اندروید یا اپ استور هدایت کند. برای هدایت، از لینک‌های پویای Firebase یا پلتفرم‌های لینک هوشمند شخص ثالث استفاده کنید.

در صورتی که برنامه شما نصب نشده است و پخش‌کننده وب دارید ، یک لینک یا بنر هوشمند به فروشگاه اندروید یا اپ استور ارائه دهید تا کاربران بتوانند برنامه شما را نصب کنند. در زیر نمونه‌ای از یک بنر هوشمند پیاده‌سازی شده آمده است:

نمونه‌ای از یک بنر هوشمند پیاده‌سازی شده

جدول زیر الزامات و محدودیت‌های مربوط به لینک‌های عمیق را در iOS، اندروید و AndroidTV نشان می‌دهد:

آی‌او‌اس اندروید و اندروید تی‌وی
http:// یا https:// مورد نیاز اگر وب‌سایت موبایل از پخش پشتیبانی می‌کند، توصیه می‌شود.
android-app:// یا intent:// ناموجود اگر وب‌سایت موبایل از پخش پشتیبانی نمی‌کند، توصیه می‌شود.
foo:// (رشته دلخواه) مجاز نیست مجاز نیست

انواع پلتفرم

برای اطمینان از اینکه محتوای شما در چندین سطح گوگل که از اقدامات رسانه‌ای پشتیبانی می‌کنند، در دسترس است، الزامات زیر را رعایت کنید:

جدول زیر لیستی از پلتفرم‌هایی را نشان می‌دهد که از اقدامات رسانه‌ای پشتیبانی می‌کنند:

پلتفرم توضیحات
http://schema.org/DesktopWebPlatform پلتفرم جستجو در مرورگر وب دسکتاپ.
http://schema.org/MobileWebPlatform پلتفرم جستجو در مرورگر وب موبایل.
http://schema.org/AndroidPlatform پلتفرم‌های جستجو و PlayGuide در اپلیکیشن اندروید.
http://schema.org/AndroidTVPlatform پلتفرم اندروید تی‌وی روی اپلیکیشن اندروید تی‌وی.
http://schema.org/IOSPlatform پلتفرم جستجو در اپلیکیشن iOS.
http://schema.googleapis.com/GoogleVideoCast پلتفرم‌های Cast و Home روی دستگاه Chromecast.
http://schema.googleapis.com/GoogleAudioCast فقط اقدامات شنیداری . پلتفرم‌های Cast و 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" ]
        }
      ],
    }
  ],
  ...
}

رفتار پخش

برای اکثر محتوا، وقتی گوگل کاربران را به برنامه یا پلتفرم شما هدایت می‌کند، از شما می‌خواهیم که محتوای انتخاب شده را به صورت خودکار پخش کنید. این به کاربران اجازه می‌دهد تا به سرعت شروع به تماشا یا گوش دادن به محتوا کنند.

رفتار پخش Watch Actions

برای اقدامات تماشا، به رفتار پخش زیر نیاز داریم.

همه پیوندهای عمیق: فیلم، قسمت تلویزیونی، سریال تلویزیونی و فصل تلویزیونی

  • رفتار ورود یا خرید: اگر سرویس شما نیاز به ورود یا خرید دارد، فیلم یا قسمت باید بعداً، متناسب با نوع آن، پخش شود. برای جزئیات بیشتر، به دستورالعمل‌های لینک عمیق که در ادامه آمده است، مراجعه کنید.

  • پخش: اگر سرویس شما وضعیت کاربر را ردیابی می‌کند، پخش باید از نشانگر قبلی کاربر روی فیلم یا قسمت شروع شود. در غیر این صورت، پخش باید از ابتدای محتوا شروع شود.

  • پخش خودکار: بسته به پلتفرم، لازم است سرویس شما پس از انتخاب قسمت یا فیلم مورد نظر توسط کاربر، محتوا را به طور برجسته پخش کند.

    • جستجو: پخش خودکار اکیداً توصیه می‌شود، اما الزامی نیست. اگر پخش خودکار پشتیبانی نمی‌شود، محتوا باید پس از انتقال کاربر به برنامه یا سرویس شما، با یک کلیک پخش شود.
    • اندروید تی‌وی: پخش خودکار برای فیلم و قسمت مورد نیاز است.

فقط لینک‌های عمیق TVSeries و TVSeason

  • انتخاب قسمت هدف: شما باید قسمت هدف درست را انتخاب کنید. اگر سرویس شما وضعیت کاربر را ردیابی می‌کند، قسمت هدف باید قسمتی باشد که کاربر آخرین بار تماشای آن را متوقف کرده است. یا اگر کاربر قسمتی را که آخرین بار تماشا می‌کرد به طور کامل تمام کرده است، قسمت هدف را به قسمت بعدی تبدیل کنید. در غیر این صورت، قسمت هدف باید به صلاحدید شما یکی از موارد زیر باشد:

    • TVSeries
      • قسمت اول سریال. برای نمایش‌های سریالی توصیه می‌شود.
      • قسمت اول از فصل آخر. برای سریال‌های طولانی مدت توصیه می‌شود.
      • آخرین قسمت. برای برنامه‌های روزانه یا برنامه‌های خبری توصیه می‌شود.
    • TVSeason
      • قسمت اول فصل. برای سریال‌های دنباله‌دار توصیه می‌شود.
      • آخرین قسمت. برای برنامه‌های روزانه یا برنامه‌های خبری توصیه می‌شود.

    یک لینک عمیق برای TVSeries یا TVSeason باید ایستا (بدون تغییر) باشد و به قسمت مورد نظر ختم شود. از لینک عمیق برای یک قسمت خاص استفاده نکنید.

    جدول زیر چندین مثال ارائه می‌دهد که منطق انتخاب قسمت هدف مورد نیاز را برای انواع موجودیت TVSeries ، TVSeason و TVEpisode نشان می‌دهد:

    اگر کاربر آخرین بار فصل ششم قسمت بیست و چهارم را تماشا کرده باشد، قسمت مورد نظر را انتخاب می‌کند اگر کاربر هیچ قسمتی را تماشا نکرده باشد، قسمت مورد نظر را انتخاب کنید
    لینک عمیق سریال
    • S6E24 (اگر کاربر S6E24 را تمام نکرده باشد)
    • فصل ۶ قسمت ۲۵ (اگر کاربر تماشای فصل ۶ قسمت ۲۴ را تمام کرده باشد)

    یکی از موارد زیر:

    • قسمت اول سریال
    • قسمت اول از فصل آخر
    • آخرین قسمت
    لینک عمیق فصل (فصل ۱ تا ۵)
    • هر قسمتی که کاربر آخرین بار در آن فصل تماشا کرده باشد، یا اولین قسمت فصل اگر کاربر هیچ قسمتی را در آن فصل تماشا نکرده باشد.
    • قسمت اول فصل
    لینک عمیق فصل (S6)
    • S6E24 (اگر کاربر S6E24 را تمام نکرده باشد)
    • فصل ۶ قسمت ۲۵ (اگر کاربر تماشای فصل ۶ قسمت ۲۴ را تمام کرده باشد)

    یکی از موارد زیر:

    • قسمت اول فصل
    • آخرین قسمت
    لینک عمیق قسمت
    • قسمت خاصی که کلیک خورد.
    • قسمت خاصی که کلیک خورد.

رفتار پخش اقدامات شنیداری

برای اقدامات گوش دادن، به رفتار پخش زیر نیاز داریم:

  • محتوا باید پس از انتقال کاربر به برنامه یا سرویس شما، با یک کلیک پخش شود.
  • اگر برنامه یا پلتفرم شما نیاز به ورود به سیستم دارد، باید بلافاصله یا با یک کلیک پس از ورود به سیستم، محتوا را پخش کند.
  • اپلیکیشن یا پلتفرم شما باید حداقل یک راه برای پخش دقیق آهنگ، آلبوم، هنرمند یا لیست پخش مورد نظر برای همه کاربران ارائه دهد.
    • برای کاربرانی که واجد شرایط پخش محتوای دقیق نیستند (برای مثال، آنها اشتراک لازم را ندارند)، سرویس شما باید توضیح دهد که کاربر برای واجد شرایط شدن برای پخش محتوای دقیق پس از ورود به برنامه یا پلتفرم شما، چه کاری باید انجام دهد.

ما بهترین شیوه‌های زیر را برای برنامه یا پلتفرم شما توصیه می‌کنیم:

  • برای MusicGroup ، هر بار که کاربر هنرمندی را انتخاب می‌کند، محتوای متفاوتی از آن هنرمند پخش شود.
  • برای MusicAlbum ، محتوا را به ترتیب ظاهر شدن در آلبوم پخش کنید.
  • برای MusicPlaylist ، هر بار که کاربر لیست پخش را انتخاب می‌کند، محتوای متفاوتی از لیست پخش پخش شود.

موارد زیر را انجام دهید:

  1. برای هر محتوا، بررسی کنید که آیا بر اساس پلتفرم‌ها، لینک‌های عمیق متفاوتی دارد یا خیر.
  2. برای هر لینک عمیق، سوالات زیر را در مورد نقطه ورود آن (صفحه‌ای در برنامه یا پلتفرم شما که لینک عمیق شما را به آن هدایت می‌کند) بپرسید:
    • آیا نقطه ورود (نه محتوا) از چندین زبان پشتیبانی می‌کند؟
    • آیا نقطه ورود از چندین زبان زیرنویس پشتیبانی می‌کند؟
    • آیا نقطه ورود از چندین زاویه دوربین پشتیبانی می‌کند؟
    • آیا نقطه ورود از فرمت‌های ویدیویی مختلف پشتیبانی می‌کند؟

اگر پاسخ شما به هر یک از این سؤالات مثبت است، باید ویژگی additionalProperty را برای آن لینک عمیق ارائه دهید. به مثال additionalProperty مراجعه کنید.

،

وقتی کاربری روی محتوا، عملیات رسانه‌ای (Media Actions) را آغاز می‌کند (مثلاً روی آیکون شما در جستجوی گوگل کلیک می‌کند)، گوگل با استفاده از لینک عمیق محتوا، کاربر را مستقیماً به محتوای موجود در برنامه یا پلتفرم شما هدایت می‌کند.

الزامات مربوط به لینک‌های عمیق به شرح زیر است:

  • urlTemplate (از یک شیء هدف ) به یک لینک عمیق نیاز دارد.
  • لینک‌های عمیق باید محتوای مورد نظر خود را در تمام پلتفرم‌های مشخص شده باز کنند.
  • لینک‌های عمیق می‌توانند شامل پارامترها (&) یا تگ‌های لنگر (#) باشند.

مثالی از @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

برای دستیابی به رفتار پخش مطلوب، الزامات خاص پلتفرم زیر را رعایت کنید:

آی‌او‌اس
شما باید از لینک‌های جهانی استفاده کنید.
اندروید و تلویزیون اندروید
می‌توانید از لینک‌های برنامه اندروید یا لینک‌های طرح سفارشی استفاده کنید.

در اندروید و اندروید تی‌وی، می‌توانید از لینک‌های طرح سفارشی نیز استفاده کنید. 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

بهترین شیوه‌ها

در صورتی که برنامه شما نصب نشده است و پخش کننده وب ندارید، سرور وب خود را طوری پیکربندی کنید که به طور خودکار کاربر را برای نصب برنامه شما به فروشگاه اندروید یا اپ استور هدایت کند. برای هدایت، از لینک‌های پویای Firebase یا پلتفرم‌های لینک هوشمند شخص ثالث استفاده کنید.

در صورتی که برنامه شما نصب نشده است و پخش‌کننده وب دارید ، یک لینک یا بنر هوشمند به فروشگاه اندروید یا اپ استور ارائه دهید تا کاربران بتوانند برنامه شما را نصب کنند. در زیر نمونه‌ای از یک بنر هوشمند پیاده‌سازی شده آمده است:

نمونه‌ای از یک بنر هوشمند پیاده‌سازی شده

جدول زیر الزامات و محدودیت‌های مربوط به لینک‌های عمیق را در iOS، اندروید و AndroidTV نشان می‌دهد:

آی‌او‌اس اندروید و اندروید تی‌وی
http:// یا https:// مورد نیاز اگر وب‌سایت موبایل از پخش پشتیبانی می‌کند، توصیه می‌شود.
android-app:// یا intent:// ناموجود اگر وب‌سایت موبایل از پخش پشتیبانی نمی‌کند، توصیه می‌شود.
foo:// (رشته دلخواه) مجاز نیست مجاز نیست

انواع پلتفرم

برای اطمینان از اینکه محتوای شما در چندین سطح گوگل که از اقدامات رسانه‌ای پشتیبانی می‌کنند، در دسترس است، الزامات زیر را رعایت کنید:

جدول زیر لیستی از پلتفرم‌هایی را نشان می‌دهد که از اقدامات رسانه‌ای پشتیبانی می‌کنند:

پلتفرم توضیحات
http://schema.org/DesktopWebPlatform پلتفرم جستجو در مرورگر وب دسکتاپ.
http://schema.org/MobileWebPlatform پلتفرم جستجو در مرورگر وب موبایل.
http://schema.org/AndroidPlatform پلتفرم‌های جستجو و PlayGuide در اپلیکیشن اندروید.
http://schema.org/AndroidTVPlatform پلتفرم اندروید تی‌وی روی اپلیکیشن اندروید تی‌وی.
http://schema.org/IOSPlatform پلتفرم جستجو در اپلیکیشن iOS.
http://schema.googleapis.com/GoogleVideoCast پلتفرم‌های Cast و Home روی دستگاه Chromecast.
http://schema.googleapis.com/GoogleAudioCast فقط اقدامات شنیداری . پلتفرم‌های Cast و 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" ]
        }
      ],
    }
  ],
  ...
}

رفتار پخش

برای اکثر محتوا، وقتی گوگل کاربران را به برنامه یا پلتفرم شما هدایت می‌کند، از شما می‌خواهیم که محتوای انتخاب شده را به صورت خودکار پخش کنید. این به کاربران اجازه می‌دهد تا به سرعت شروع به تماشا یا گوش دادن به محتوا کنند.

رفتار پخش Watch Actions

برای اقدامات تماشا، به رفتار پخش زیر نیاز داریم.

همه پیوندهای عمیق: فیلم، قسمت تلویزیونی، سریال تلویزیونی و فصل تلویزیونی

  • رفتار ورود یا خرید: اگر سرویس شما نیاز به ورود یا خرید دارد، فیلم یا قسمت باید بعداً، متناسب با نوع آن، پخش شود. برای جزئیات بیشتر، به دستورالعمل‌های لینک عمیق که در ادامه آمده است، مراجعه کنید.

  • پخش: اگر سرویس شما وضعیت کاربر را ردیابی می‌کند، پخش باید از نشانگر قبلی کاربر روی فیلم یا قسمت شروع شود. در غیر این صورت، پخش باید از ابتدای محتوا شروع شود.

  • پخش خودکار: بسته به پلتفرم، لازم است سرویس شما پس از انتخاب قسمت یا فیلم مورد نظر توسط کاربر، محتوا را به طور برجسته پخش کند.

    • جستجو: پخش خودکار اکیداً توصیه می‌شود، اما الزامی نیست. اگر پخش خودکار پشتیبانی نمی‌شود، محتوا باید پس از انتقال کاربر به برنامه یا سرویس شما، با یک کلیک پخش شود.
    • اندروید تی‌وی: پخش خودکار برای فیلم و قسمت مورد نیاز است.

فقط لینک‌های عمیق TVSeries و TVSeason

  • انتخاب قسمت هدف: شما باید قسمت هدف درست را انتخاب کنید. اگر سرویس شما وضعیت کاربر را ردیابی می‌کند، قسمت هدف باید قسمتی باشد که کاربر آخرین بار تماشای آن را متوقف کرده است. یا اگر کاربر قسمتی را که آخرین بار تماشا می‌کرد به طور کامل تمام کرده است، قسمت هدف را به قسمت بعدی تبدیل کنید. در غیر این صورت، قسمت هدف باید به صلاحدید شما یکی از موارد زیر باشد:

    • TVSeries
      • قسمت اول سریال. برای نمایش‌های سریالی توصیه می‌شود.
      • قسمت اول از فصل آخر. برای سریال‌های طولانی مدت توصیه می‌شود.
      • آخرین قسمت. برای برنامه‌های روزانه یا برنامه‌های خبری توصیه می‌شود.
    • TVSeason
      • قسمت اول فصل. برای سریال‌های دنباله‌دار توصیه می‌شود.
      • آخرین قسمت. برای برنامه‌های روزانه یا برنامه‌های خبری توصیه می‌شود.

    یک لینک عمیق برای TVSeries یا TVSeason باید ایستا (بدون تغییر) باشد و به قسمت مورد نظر ختم شود. از لینک عمیق برای یک قسمت خاص استفاده نکنید.

    جدول زیر چندین مثال ارائه می‌دهد که منطق انتخاب قسمت هدف مورد نیاز را برای انواع موجودیت TVSeries ، TVSeason و TVEpisode نشان می‌دهد:

    اگر کاربر آخرین بار فصل ششم قسمت بیست و چهارم را تماشا کرده باشد، قسمت مورد نظر را انتخاب می‌کند اگر کاربر هیچ قسمتی را تماشا نکرده باشد، قسمت مورد نظر را انتخاب کنید
    لینک عمیق سریال
    • S6E24 (اگر کاربر S6E24 را تمام نکرده باشد)
    • فصل ۶ قسمت ۲۵ (اگر کاربر تماشای فصل ۶ قسمت ۲۴ را تمام کرده باشد)

    یکی از موارد زیر:

    • قسمت اول سریال
    • قسمت اول از فصل آخر
    • آخرین قسمت
    لینک عمیق فصل (فصل ۱ تا ۵)
    • هر قسمتی که کاربر آخرین بار در آن فصل تماشا کرده باشد، یا اولین قسمت فصل اگر کاربر هیچ قسمتی را در آن فصل تماشا نکرده باشد.
    • قسمت اول فصل
    لینک عمیق فصل (S6)
    • S6E24 (اگر کاربر S6E24 را تمام نکرده باشد)
    • فصل ۶ قسمت ۲۵ (اگر کاربر تماشای فصل ۶ قسمت ۲۴ را تمام کرده باشد)

    یکی از موارد زیر:

    • قسمت اول فصل
    • آخرین قسمت
    لینک عمیق قسمت
    • قسمت خاصی که کلیک خورد.
    • قسمت خاصی که کلیک خورد.

رفتار پخش اقدامات شنیداری

برای اقدامات گوش دادن، به رفتار پخش زیر نیاز داریم:

  • محتوا باید پس از انتقال کاربر به برنامه یا سرویس شما، با یک کلیک پخش شود.
  • اگر برنامه یا پلتفرم شما نیاز به ورود به سیستم دارد، باید بلافاصله یا با یک کلیک پس از ورود به سیستم، محتوا را پخش کند.
  • اپلیکیشن یا پلتفرم شما باید حداقل یک راه برای پخش دقیق آهنگ، آلبوم، هنرمند یا لیست پخش مورد نظر برای همه کاربران ارائه دهد.
    • برای کاربرانی که واجد شرایط پخش محتوای دقیق نیستند (برای مثال، آنها اشتراک لازم را ندارند)، سرویس شما باید توضیح دهد که کاربر برای واجد شرایط شدن برای پخش محتوای دقیق پس از ورود به برنامه یا پلتفرم شما، چه کاری باید انجام دهد.

ما بهترین شیوه‌های زیر را برای برنامه یا پلتفرم شما توصیه می‌کنیم:

  • برای MusicGroup ، هر بار که کاربر هنرمندی را انتخاب می‌کند، محتوای متفاوتی از آن هنرمند پخش شود.
  • برای MusicAlbum ، محتوا را به ترتیب ظاهر شدن در آلبوم پخش کنید.
  • برای MusicPlaylist ، هر بار که کاربر لیست پخش را انتخاب می‌کند، محتوای متفاوتی از لیست پخش پخش شود.

موارد زیر را انجام دهید:

  1. برای هر محتوا، بررسی کنید که آیا بر اساس پلتفرم‌ها، لینک‌های عمیق متفاوتی دارد یا خیر.
  2. برای هر لینک عمیق، سوالات زیر را در مورد نقطه ورود آن (صفحه‌ای در برنامه یا پلتفرم شما که لینک عمیق شما را به آن هدایت می‌کند) بپرسید:
    • آیا نقطه ورود (نه محتوا) از چندین زبان پشتیبانی می‌کند؟
    • آیا نقطه ورود از چندین زبان زیرنویس پشتیبانی می‌کند؟
    • آیا نقطه ورود از چندین زاویه دوربین پشتیبانی می‌کند؟
    • آیا نقطه ورود از فرمت‌های ویدیویی مختلف پشتیبانی می‌کند؟

اگر پاسخ شما به هر یک از این سؤالات مثبت است، باید ویژگی additionalProperty را برای آن لینک عمیق ارائه دهید. به مثال additionalProperty مراجعه کنید.

،

وقتی کاربری روی محتوا، عملیات رسانه‌ای (Media Actions) را آغاز می‌کند (مثلاً روی آیکون شما در جستجوی گوگل کلیک می‌کند)، گوگل با استفاده از لینک عمیق محتوا، کاربر را مستقیماً به محتوای موجود در برنامه یا پلتفرم شما هدایت می‌کند.

الزامات مربوط به لینک‌های عمیق به شرح زیر است:

  • urlTemplate (از یک شیء هدف ) به یک لینک عمیق نیاز دارد.
  • لینک‌های عمیق باید محتوای مورد نظر خود را در تمام پلتفرم‌های مشخص شده باز کنند.
  • لینک‌های عمیق می‌توانند شامل پارامترها (&) یا تگ‌های لنگر (#) باشند.

مثالی از @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

برای دستیابی به رفتار پخش مطلوب، الزامات خاص پلتفرم زیر را رعایت کنید:

آی‌او‌اس
شما باید از لینک‌های جهانی استفاده کنید.
اندروید و تلویزیون اندروید
می‌توانید از لینک‌های برنامه اندروید یا لینک‌های طرح سفارشی استفاده کنید.

در اندروید و اندروید تی‌وی، می‌توانید از لینک‌های طرح سفارشی نیز استفاده کنید. 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

بهترین شیوه‌ها

در صورتی که برنامه شما نصب نشده است و پخش کننده وب ندارید، سرور وب خود را طوری پیکربندی کنید که به طور خودکار کاربر را برای نصب برنامه شما به فروشگاه اندروید یا اپ استور هدایت کند. برای هدایت، از لینک‌های پویای Firebase یا پلتفرم‌های لینک هوشمند شخص ثالث استفاده کنید.

در صورتی که برنامه شما نصب نشده است و پخش‌کننده وب دارید ، یک لینک یا بنر هوشمند به فروشگاه اندروید یا اپ استور ارائه دهید تا کاربران بتوانند برنامه شما را نصب کنند. در زیر نمونه‌ای از یک بنر هوشمند پیاده‌سازی شده آمده است:

نمونه‌ای از یک بنر هوشمند پیاده‌سازی شده

جدول زیر الزامات و محدودیت‌های مربوط به لینک‌های عمیق را در iOS، اندروید و AndroidTV نشان می‌دهد:

آی‌او‌اس اندروید و اندروید تی‌وی
http:// یا https:// مورد نیاز اگر وب‌سایت موبایل از پخش پشتیبانی می‌کند، توصیه می‌شود.
android-app:// یا intent:// ناموجود اگر وب‌سایت موبایل از پخش پشتیبانی نمی‌کند، توصیه می‌شود.
foo:// (رشته دلخواه) مجاز نیست مجاز نیست

انواع پلتفرم

برای اطمینان از اینکه محتوای شما در چندین سطح گوگل که از اقدامات رسانه‌ای پشتیبانی می‌کنند، در دسترس است، الزامات زیر را رعایت کنید:

جدول زیر لیستی از پلتفرم‌هایی را نشان می‌دهد که از اقدامات رسانه‌ای پشتیبانی می‌کنند:

پلتفرم توضیحات
http://schema.org/DesktopWebPlatform پلتفرم جستجو در مرورگر وب دسکتاپ.
http://schema.org/MobileWebPlatform پلتفرم جستجو در مرورگر وب موبایل.
http://schema.org/AndroidPlatform پلتفرم‌های جستجو و PlayGuide در اپلیکیشن اندروید.
http://schema.org/AndroidTVPlatform پلتفرم اندروید تی‌وی روی اپلیکیشن اندروید تی‌وی.
http://schema.org/IOSPlatform پلتفرم جستجو در اپلیکیشن iOS.
http://schema.googleapis.com/GoogleVideoCast پلتفرم‌های Cast و Home روی دستگاه Chromecast.
http://schema.googleapis.com/GoogleAudioCast فقط اقدامات شنیداری . پلتفرم‌های Cast و 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" ]
        }
      ],
    }
  ],
  ...
}

رفتار پخش

برای اکثر محتوا، وقتی گوگل کاربران را به برنامه یا پلتفرم شما هدایت می‌کند، از شما می‌خواهیم که محتوای انتخاب شده را به صورت خودکار پخش کنید. این به کاربران اجازه می‌دهد تا به سرعت شروع به تماشا یا گوش دادن به محتوا کنند.

رفتار پخش Watch Actions

برای اقدامات تماشا، به رفتار پخش زیر نیاز داریم.

همه پیوندهای عمیق: فیلم، قسمت تلویزیونی، سریال تلویزیونی و فصل تلویزیونی

  • رفتار ورود یا خرید: اگر سرویس شما نیاز به ورود یا خرید دارد، فیلم یا قسمت باید بعداً، متناسب با نوع آن، پخش شود. برای جزئیات بیشتر، به دستورالعمل‌های لینک عمیق که در ادامه آمده است، مراجعه کنید.

  • پخش: اگر سرویس شما وضعیت کاربر را ردیابی می‌کند، پخش باید از نشانگر قبلی کاربر روی فیلم یا قسمت شروع شود. در غیر این صورت، پخش باید از ابتدای محتوا شروع شود.

  • پخش خودکار: بسته به پلتفرم، لازم است سرویس شما پس از انتخاب قسمت یا فیلم مورد نظر توسط کاربر، محتوا را به طور برجسته پخش کند.

    • جستجو: پخش خودکار اکیداً توصیه می‌شود، اما الزامی نیست. اگر پخش خودکار پشتیبانی نمی‌شود، محتوا باید پس از انتقال کاربر به برنامه یا سرویس شما، با یک کلیک پخش شود.
    • اندروید تی‌وی: پخش خودکار برای فیلم و قسمت مورد نیاز است.

فقط لینک‌های عمیق TVSeries و TVSeason

  • انتخاب قسمت هدف: شما باید قسمت هدف درست را انتخاب کنید. اگر سرویس شما وضعیت کاربر را ردیابی می‌کند، قسمت هدف باید قسمتی باشد که کاربر آخرین بار تماشای آن را متوقف کرده است. یا اگر کاربر قسمتی را که آخرین بار تماشا می‌کرد به طور کامل تمام کرده است، قسمت هدف را به قسمت بعدی تبدیل کنید. در غیر این صورت، قسمت هدف باید به صلاحدید شما یکی از موارد زیر باشد:

    • TVSeries
      • قسمت اول سریال. برای نمایش‌های سریالی توصیه می‌شود.
      • قسمت اول از فصل آخر. برای سریال‌های طولانی مدت توصیه می‌شود.
      • آخرین قسمت. برای برنامه‌های روزانه یا برنامه‌های خبری توصیه می‌شود.
    • TVSeason
      • قسمت اول فصل. برای سریال‌های دنباله‌دار توصیه می‌شود.
      • آخرین قسمت. برای برنامه‌های روزانه یا برنامه‌های خبری توصیه می‌شود.

    یک لینک عمیق برای TVSeries یا TVSeason باید ایستا (بدون تغییر) باشد و به قسمت مورد نظر ختم شود. از لینک عمیق برای یک قسمت خاص استفاده نکنید.

    جدول زیر چندین مثال ارائه می‌دهد که منطق انتخاب قسمت هدف مورد نیاز را برای انواع موجودیت TVSeries ، TVSeason و TVEpisode نشان می‌دهد:

    اگر کاربر آخرین بار فصل ششم قسمت بیست و چهارم را تماشا کرده باشد، قسمت مورد نظر را انتخاب می‌کند اگر کاربر هیچ قسمتی را تماشا نکرده باشد، قسمت مورد نظر را انتخاب کنید
    لینک عمیق سریال
    • S6E24 (اگر کاربر S6E24 را تمام نکرده باشد)
    • فصل ۶ قسمت ۲۵ (اگر کاربر تماشای فصل ۶ قسمت ۲۴ را تمام کرده باشد)

    یکی از موارد زیر:

    • قسمت اول سریال
    • قسمت اول از فصل آخر
    • آخرین قسمت
    لینک عمیق فصل (فصل ۱ تا ۵)
    • هر قسمتی که کاربر آخرین بار در آن فصل تماشا کرده باشد، یا اولین قسمت فصل اگر کاربر هیچ قسمتی را در آن فصل تماشا نکرده باشد.
    • قسمت اول فصل
    لینک عمیق فصل (S6)
    • S6E24 (اگر کاربر S6E24 را تمام نکرده باشد)
    • فصل ۶ قسمت ۲۵ (اگر کاربر تماشای فصل ۶ قسمت ۲۴ را تمام کرده باشد)

    یکی از موارد زیر:

    • قسمت اول فصل
    • آخرین قسمت
    لینک عمیق قسمت
    • قسمت خاصی که کلیک خورد.
    • قسمت خاصی که کلیک خورد.

رفتار پخش اقدامات شنیداری

برای اقدامات گوش دادن، به رفتار پخش زیر نیاز داریم:

  • محتوا باید پس از انتقال کاربر به برنامه یا سرویس شما، با یک کلیک پخش شود.
  • اگر برنامه یا پلتفرم شما نیاز به ورود به سیستم دارد، باید بلافاصله یا با یک کلیک پس از ورود به سیستم، محتوا را پخش کند.
  • اپلیکیشن یا پلتفرم شما باید حداقل یک راه برای پخش دقیق آهنگ، آلبوم، هنرمند یا لیست پخش مورد نظر برای همه کاربران ارائه دهد.
    • برای کاربرانی که واجد شرایط پخش محتوای دقیق نیستند (برای مثال، آنها اشتراک لازم را ندارند)، سرویس شما باید توضیح دهد که کاربر برای واجد شرایط شدن برای پخش محتوای دقیق پس از ورود به برنامه یا پلتفرم شما، چه کاری باید انجام دهد.

ما بهترین شیوه‌های زیر را برای برنامه یا پلتفرم شما توصیه می‌کنیم:

  • برای MusicGroup ، هر بار که کاربر هنرمندی را انتخاب می‌کند، محتوای متفاوتی از آن هنرمند پخش شود.
  • برای MusicAlbum ، محتوا را به ترتیب ظاهر شدن در آلبوم پخش کنید.
  • برای MusicPlaylist ، هر بار که کاربر لیست پخش را انتخاب می‌کند، محتوای متفاوتی از لیست پخش پخش شود.

موارد زیر را انجام دهید:

  1. برای هر محتوا، بررسی کنید که آیا بر اساس پلتفرم‌ها، لینک‌های عمیق متفاوتی دارد یا خیر.
  2. برای هر لینک عمیق، سوالات زیر را در مورد نقطه ورود آن (صفحه‌ای در برنامه یا پلتفرم شما که لینک عمیق شما را به آن هدایت می‌کند) بپرسید:
    • آیا نقطه ورود (نه محتوا) از چندین زبان پشتیبانی می‌کند؟
    • آیا نقطه ورود از چندین زبان زیرنویس پشتیبانی می‌کند؟
    • آیا نقطه ورود از چندین زاویه دوربین پشتیبانی می‌کند؟
    • آیا نقطه ورود از فرمت‌های ویدیویی مختلف پشتیبانی می‌کند؟

اگر پاسخ شما به هر یک از این سؤالات مثبت است، باید ویژگی additionalProperty را برای آن لینک عمیق ارائه دهید. به مثال additionalProperty مراجعه کنید.

،

وقتی کاربری روی محتوا، عملیات رسانه‌ای (Media Actions) را آغاز می‌کند (مثلاً روی آیکون شما در جستجوی گوگل کلیک می‌کند)، گوگل با استفاده از لینک عمیق محتوا، کاربر را مستقیماً به محتوای موجود در برنامه یا پلتفرم شما هدایت می‌کند.

الزامات مربوط به لینک‌های عمیق به شرح زیر است:

  • urlTemplate (از یک شیء هدف ) به یک لینک عمیق نیاز دارد.
  • لینک‌های عمیق باید محتوای مورد نظر خود را در تمام پلتفرم‌های مشخص شده باز کنند.
  • لینک‌های عمیق می‌توانند شامل پارامترها (&) یا تگ‌های لنگر (#) باشند.

مثالی از @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

برای دستیابی به رفتار پخش مطلوب، الزامات خاص پلتفرم زیر را رعایت کنید:

آی‌او‌اس
شما باید از لینک‌های جهانی استفاده کنید.
اندروید و تلویزیون اندروید
می‌توانید از لینک‌های برنامه اندروید یا لینک‌های طرح سفارشی استفاده کنید.

در اندروید و اندروید تی‌وی، می‌توانید از لینک‌های طرح سفارشی نیز استفاده کنید. 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

بهترین شیوه‌ها

در صورتی که برنامه شما نصب نشده است و پخش کننده وب ندارید، سرور وب خود را طوری پیکربندی کنید که به طور خودکار کاربر را برای نصب برنامه شما به فروشگاه اندروید یا اپ استور هدایت کند. برای هدایت، از لینک‌های پویای Firebase یا پلتفرم‌های لینک هوشمند شخص ثالث استفاده کنید.

در صورتی که برنامه شما نصب نشده است و پخش‌کننده وب دارید ، یک لینک یا بنر هوشمند به فروشگاه اندروید یا اپ استور ارائه دهید تا کاربران بتوانند برنامه شما را نصب کنند. در زیر نمونه‌ای از یک بنر هوشمند پیاده‌سازی شده آمده است:

نمونه‌ای از یک بنر هوشمند پیاده‌سازی شده

جدول زیر الزامات و محدودیت‌های مربوط به لینک‌های عمیق را در iOS، اندروید و AndroidTV نشان می‌دهد:

آی‌او‌اس اندروید و اندروید تی‌وی
http:// یا https:// مورد نیاز اگر وب‌سایت موبایل از پخش پشتیبانی می‌کند، توصیه می‌شود.
android-app:// یا intent:// ناموجود اگر وب‌سایت موبایل از پخش پشتیبانی نمی‌کند، توصیه می‌شود.
foo:// (رشته دلخواه) مجاز نیست مجاز نیست

انواع پلتفرم

برای اطمینان از اینکه محتوای شما در چندین سطح گوگل که از اقدامات رسانه‌ای پشتیبانی می‌کنند، در دسترس است، الزامات زیر را رعایت کنید:

جدول زیر لیستی از پلتفرم‌هایی را نشان می‌دهد که از اقدامات رسانه‌ای پشتیبانی می‌کنند:

پلتفرم توضیحات
http://schema.org/DesktopWebPlatform پلتفرم جستجو در مرورگر وب دسکتاپ.
http://schema.org/MobileWebPlatform پلتفرم جستجو در مرورگر وب موبایل.
http://schema.org/AndroidPlatform پلتفرم‌های جستجو و PlayGuide در اپلیکیشن اندروید.
http://schema.org/AndroidTVPlatform پلتفرم اندروید تی‌وی روی اپلیکیشن اندروید تی‌وی.
http://schema.org/IOSPlatform پلتفرم جستجو در اپلیکیشن iOS.
http://schema.googleapis.com/GoogleVideoCast پلتفرم‌های Cast و Home روی دستگاه Chromecast.
http://schema.googleapis.com/GoogleAudioCast فقط اقدامات شنیداری . پلتفرم‌های Cast و 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" ]
        }
      ],
    }
  ],
  ...
}

رفتار پخش

برای اکثر محتوا، وقتی گوگل کاربران را به برنامه یا پلتفرم شما هدایت می‌کند، از شما می‌خواهیم که محتوای انتخاب شده را به صورت خودکار پخش کنید. این به کاربران اجازه می‌دهد تا به سرعت شروع به تماشا یا گوش دادن به محتوا کنند.

رفتار پخش Watch Actions

برای اقدامات تماشا، به رفتار پخش زیر نیاز داریم.

همه پیوندهای عمیق: فیلم، قسمت تلویزیونی، سریال تلویزیونی و فصل تلویزیونی

  • رفتار ورود یا خرید: اگر سرویس شما نیاز به ورود یا خرید دارد، فیلم یا قسمت باید بعداً، متناسب با نوع آن، پخش شود. برای جزئیات بیشتر، به دستورالعمل‌های لینک عمیق که در ادامه آمده است، مراجعه کنید.

  • پخش: اگر سرویس شما وضعیت کاربر را ردیابی می‌کند، پخش باید از نشانگر قبلی کاربر روی فیلم یا قسمت شروع شود. در غیر این صورت، پخش باید از ابتدای محتوا شروع شود.

  • پخش خودکار: بسته به پلتفرم، لازم است سرویس شما پس از انتخاب قسمت یا فیلم مورد نظر توسط کاربر، محتوا را به طور برجسته پخش کند.

    • جستجو: پخش خودکار اکیداً توصیه می‌شود، اما الزامی نیست. اگر پخش خودکار پشتیبانی نمی‌شود، محتوا باید پس از انتقال کاربر به برنامه یا سرویس شما، با یک کلیک پخش شود.
    • اندروید تی‌وی: پخش خودکار برای فیلم و قسمت مورد نیاز است.

فقط لینک‌های عمیق TVSeries و TVSeason

  • انتخاب قسمت هدف: شما باید قسمت هدف درست را انتخاب کنید. اگر سرویس شما وضعیت کاربر را ردیابی می‌کند، قسمت هدف باید قسمتی باشد که کاربر آخرین بار تماشای آن را متوقف کرده است. یا اگر کاربر قسمتی را که آخرین بار تماشا می‌کرد به طور کامل تمام کرده است، قسمت هدف را به قسمت بعدی تبدیل کنید. در غیر این صورت، قسمت هدف باید به صلاحدید شما یکی از موارد زیر باشد:

    • TVSeries
      • قسمت اول سریال. برای نمایش‌های سریالی توصیه می‌شود.
      • قسمت اول از فصل آخر. برای سریال‌های طولانی مدت توصیه می‌شود.
      • آخرین قسمت. برای برنامه‌های روزانه یا برنامه‌های خبری توصیه می‌شود.
    • TVSeason
      • قسمت اول فصل. برای سریال‌های دنباله‌دار توصیه می‌شود.
      • آخرین قسمت. برای برنامه‌های روزانه یا برنامه‌های خبری توصیه می‌شود.

    یک لینک عمیق برای TVSeries یا TVSeason باید ایستا (بدون تغییر) باشد و به قسمت مورد نظر ختم شود. از لینک عمیق برای یک قسمت خاص استفاده نکنید.

    The following table provides several examples that demonstrate the required target episode selection logic for the TVSeries , TVSeason , and TVEpisode entity types:

    Target episode if the user last watched S6E24 Target episode if the user hasn't watched any episodes
    Series deep link
    • S6E24 (if the user hasn't finished S6E24)
    • S6E25 (if the user has finished watching S6E24)

    One of the following:

    • First episode of the series
    • First episode of the latest season
    • Latest episode
    Season deep link (S1-S5)
    • Whichever episode the user last watched in that season, or the first episode of the season if the user hasn't watched any episodes in that season.
    • First episode of the season
    Season deep link (S6)
    • S6E24 (if the user hasn't finished S6E24)
    • S6E25 (if the user has finished watching S6E24)

    One of the following:

    • First episode of the season
    • Latest episode
    Episode deep link
    • The specific episode that was clicked.
    • The specific episode that was clicked.

Listen Actions playback behavior

For Listen Actions, we require the following playback behavior:

  • Content must play within one click after the user is taken to your app or service.
  • If your app or platform requires a sign-in, it needs to play the content immediately or within one click after the sign-in.
  • Your app or platform must offer at least one way for all users to play the exact song, album, artist, or playlist.
    • For users ineligible to play the exact content (for example, they don't have the required subscription), your service must explain what the user needs to do to become eligible to play the exact content upon arriving at your app or platform.

We recommend the following best practices for your app or platform:

  • For MusicGroup , play different content from the artist each time a user selects the artist.
  • For MusicAlbum , play content in the order of appearance in the album.
  • For MusicPlaylist , play different content from the playlist each time a user selects the playlist.

Do the following:

  1. For each content, check if it has different deep links based on the platforms.
  2. For each deep link, ask the following questions about its entry point (the page on your app or platform the deep link takes you to):
    • Does the entry point (not the content) support multiple languages?
    • Does the entry point support multiple subtitle languages?
    • Does the entry point support multiple camera angles?
    • Does the entry point support multiple video formats?

If your answer is yes to any of these questions, you need to provide the additionalProperty property for that deep link. See the additionalProperty example.

قبلی
ابرداده ها را جمع آوری کنید
بعدی
نیاز دسترسی را شناسایی کنید