अपने कॉन्टेंट के प्लैटफ़ॉर्म के हिसाब से खास डीप लिंक की पहचान करें

जब कोई उपयोगकर्ता कॉन्टेंट पर मीडिया ऐक्शन शुरू करता है, तो Google उसे कॉन्टेंट के डीप लिंक का इस्तेमाल करके, सीधे आपके ऐप्लिकेशन या प्लैटफ़ॉर्म पर मौजूद कॉन्टेंट पर ले जाता है. उदाहरण के लिए, जब कोई उपयोगकर्ता Google Search पर आपके आइकॉन पर क्लिक करता है.

डीप लिंक

डीप लिंक के लिए ये ज़रूरी शर्तें हैं:

• टारगेट ऑब्जेक्ट के 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 ऐप्लिकेशन के लिंक या कस्टम स्कीम के लिंक, दोनों में से किसी का भी इस्तेमाल किया जा सकता है.

मकसद: iOS यूनिवर्सल लिंक और Android ऐप्लिकेशन लिंक, दोनों को इस तरह कॉन्फ़िगर किया जा सकता है कि उपयोगकर्ता को आपके ऐप्लिकेशन पर ले जाया जाए. अगर आपका ऐप्लिकेशन इंस्टॉल नहीं है, तो उपयोगकर्ता को आपकी वेबसाइट पर ले जाया जाए. अगर आपकी सेवा में वेब-आधारित प्लेयर नहीं है, तो अपने वेब सर्वर को कॉन्फ़िगर करें, ताकि उपयोगकर्ता आपका ऐप्लिकेशन इंस्टॉल करने के लिए, अपने-आप सही स्टोर पर रीडायरेक्ट हो जाए.

Android और Android TV के लिए कस्टम स्कीम लिंक

Android और Android TV पर, कस्टम स्कीम लिंक का भी इस्तेमाल किया जा सकता है. कस्टम स्कीम यूआरआई में, आपके ऐप्लिकेशन का package_id शामिल होना चाहिए. इससे यह पक्का होता है कि अगर आपका ऐप्लिकेशन इंस्टॉल नहीं है, तो उपयोगकर्ता को Play Store पर आपके ऐप्लिकेशन के पेज पर ले जाया जाए. इसलिए, मीडिया ऐक्शन के लिए, यूआरआई के सिर्फ़ ये कस्टम स्कीम फ़ॉर्मैट स्वीकार किए जाते हैं:

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

मीडिया ऐक्शन के लिए, कस्टम स्कीम के लिंक के तौर पर यूआरआई के दूसरे फ़ॉर्मैट इस्तेमाल नहीं किए जा सकते. जैसे, यहां दिया गया उदाहरण:

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 के कई प्लैटफ़ॉर्म (Search, Assistant, Android TV, और Chromecast) पर उपलब्ध हो, इन ज़रूरी शर्तों का पालन करें:

• पार्टनर के साथ काम करने वाले सभी प्लैटफ़ॉर्म पर, आपके कॉन्टेंट के लिए डीप लिंक ज़रूरी है.
• Chromecast प्लैटफ़ॉर्म के लिए, आपको Cast Application Framework (CAF) Receiver SDK के नए वर्शन का इस्तेमाल करके रिसीवर बनाना होगा.
• मोबाइल प्लैटफ़ॉर्म (Android और iOS) के लिए, वीडियो चलाने के लिए डीप लिंक का इस्तेमाल करें सेक्शन में ज़रूरी शर्तें देखें.

इस टेबल में उन प्लैटफ़ॉर्म की सूची दी गई है जिन पर मीडिया ऐक्शन काम करते हैं:

प्लैटफ़ॉर्म	ब्यौरा
http://schema.org/DesktopWebPlatform	डेस्कटॉप वेब ब्राउज़र पर Search प्लैटफ़ॉर्म.
http://schema.org/MobileWebPlatform	मोबाइल वेब ब्राउज़र पर Search प्लैटफ़ॉर्म.
http://schema.org/AndroidPlatform	Android ऐप्लिकेशन पर Search और PlayGuide प्लैटफ़ॉर्म.
http://schema.org/AndroidTVPlatform	Android TV ऐप्लिकेशन पर Android TV प्लैटफ़ॉर्म.
http://schema.org/IOSPlatform	iOS ऐप्लिकेशन पर Search प्लैटफ़ॉर्म.
http://schema.googleapis.com/GoogleVideoCast	Chromecast डिवाइस पर Cast और Home प्लैटफ़ॉर्म.
http://schema.googleapis.com/GoogleAudioCast	सिर्फ़ सुनने की कार्रवाइयां. Chromecast डिवाइस पर Cast और Home प्लैटफ़ॉर्म.

दो अलग-अलग डीप लिंक वाली इकाई का उदाहरण:

"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 लोगों को आपके ऐप्लिकेशन या प्लैटफ़ॉर्म पर ले जाता है, तो हम चाहते हैं कि आप चुने गए कॉन्टेंट को अपने-आप चलाएं. इससे उपयोगकर्ता, कॉन्टेंट को तुरंत देखना या सुनना शुरू कर सकते हैं.

Watch Actions के वीडियो चलाने का व्यवहार

वॉच ऐक्शन के लिए, वीडियो चलाने के इस तरीके की ज़रूरत होती है.

सभी डीप लिंक: मूवी, टीवी एपिसोड, टीवी सीरीज़, और टीवी सीज़न

• साइन इन या खरीदारी करने के बाद का व्यवहार: अगर आपकी सेवा के लिए साइन इन या खरीदारी करना ज़रूरी है, तो फ़िल्म या एपिसोड, उसके टाइप के हिसाब से चलना चाहिए. ज़्यादा जानकारी के लिए, यहां दिए गए डीप लिंक के दिशा-निर्देश देखें.

• वीडियो चलाना: अगर आपकी सेवा, उपयोगकर्ता की स्थिति को ट्रैक करती है, तो वीडियो चलाना उसी जगह से शुरू होना चाहिए जहां उपयोगकर्ता ने फ़िल्म या एपिसोड को छोड़ा था. ऐसा न करने पर, कॉन्टेंट का प्लेबैक शुरू से शुरू होगा.

• अपने-आप वीडियो चलने की सुविधा: प्लैटफ़ॉर्म के हिसाब से, यह ज़रूरी है कि उपयोगकर्ता के टारगेट किए गए एपिसोड या फ़िल्म को चुनने के बाद, आपकी सेवा उस कॉन्टेंट को प्रमुखता से चलाए.

  • Search: हमारा सुझाव है कि आप वीडियो अपने-आप चलने की सुविधा चालू करें. हालांकि, ऐसा करना ज़रूरी नहीं है. अगर वीडियो अपने-आप चलने की सुविधा काम नहीं करती है, तो उपयोगकर्ता को आपके ऐप्लिकेशन या सेवा पर ले जाने के बाद, एक क्लिक में वीडियो चलना चाहिए.
  • Android TV: फ़िल्म और एपिसोड के लिए, वीडियो अपने-आप चलने की सुविधा चालू होनी चाहिए.

सिर्फ़ TVSeries और TVSeason के डीप लिंक

• टारगेट किया गया एपिसोड चुनना: आपको सही टारगेट एपिसोड चुनना होगा. अगर आपकी सेवा, उपयोगकर्ता की स्थिति को ट्रैक करती है, तो टारगेट किया गया एपिसोड वह होना चाहिए जिसे उपयोगकर्ता ने आखिरी बार देखना बंद किया था. इसके अलावा, अगर उपयोगकर्ता ने आखिरी बार जो एपिसोड देखा था उसे पूरा देख लिया है, तो टारगेट किए गए एपिसोड के बजाय अगला एपिसोड टारगेट करें. इसके अलावा, आपके हिसाब से टारगेट किया गया एपिसोड इनमें से कोई एक होना चाहिए:

  • TVSeries
    • सीरीज़ का पहला एपिसोड. सीरीज़ वाले शो के लिए सुझाया गया.
    • नए सीज़न का पहला एपिसोड. लंबे समय तक चलने वाले सीरीज़ वाले शो के लिए सुझाया जाता है.
    • नया एपिसोड. रोज़ के या खबरों से जुड़े शो के लिए सुझाया गया.
  • TVSeason
    • सीज़न का पहला एपिसोड. सीरीज़ वाले शो के लिए सुझाया गया.
    • नया एपिसोड. रोज़ के या खबरों से जुड़े शो के लिए सुझाया गया.

  TVSeries या TVSeason के लिए डीप लिंक, स्टैटिक (बदलने वाला नहीं) होना चाहिए और टारगेट किए गए एपिसोड पर ले जाना चाहिए. किसी खास एपिसोड के लिए डीप लिंक का इस्तेमाल न करें.

  नीचे दी गई टेबल में कई उदाहरण दिए गए हैं. इनसे पता चलता है कि TVSeries, TVSeason, और TVEpisode टाइप की इकाइयों के लिए, टारगेट एपिसोड चुनने का ज़रूरी लॉजिक क्या है:

  	अगर उपयोगकर्ता ने आखिरी बार सीज़न 6, एपिसोड 24 देखा था, तो टारगेट किया गया एपिसोड	अगर उपयोगकर्ता ने कोई एपिसोड नहीं देखा है, तो एपिसोड को टारगेट करना
  सीरीज़ का डीप लिंक	S6E24 (अगर उपयोगकर्ता ने S6E24 को पूरा नहीं किया है) S6E25 (अगर उपयोगकर्ता ने S6E24 देख लिया है)	निम्न में से एक: सीरीज़ का पहला एपिसोड नए सीज़न का पहला एपिसोड नया एपिसोड
  सीज़न का डीप लिंक (S1-S5)	उपयोगकर्ता ने उस सीज़न में आखिरी बार जो एपिसोड देखा था या अगर उपयोगकर्ता ने उस सीज़न में कोई एपिसोड नहीं देखा है, तो सीज़न का पहला एपिसोड.	सीज़न का पहला एपिसोड
  सीज़न का डीप लिंक (S6)	S6E24 (अगर उपयोगकर्ता ने S6E24 को पूरा नहीं किया है) S6E25 (अगर उपयोगकर्ता ने S6E24 देख लिया है)	निम्न में से एक: सीज़न का पहला एपिसोड नया एपिसोड
  एपिसोड का डीप लिंक	वह एपिसोड जिस पर क्लिक किया गया.	वह एपिसोड जिस पर क्लिक किया गया था.

Listen Actions की सुविधा के प्लेबैक का तरीका

सुनने की कार्रवाइयों के लिए, हमें वीडियो चलाने के इस तरीके की ज़रूरत है:

• उपयोगकर्ता को आपके ऐप्लिकेशन या सेवा पर ले जाने के बाद, एक क्लिक में कॉन्टेंट चलना चाहिए.
• अगर आपके ऐप्लिकेशन या प्लैटफ़ॉर्म के लिए साइन-इन करना ज़रूरी है, तो साइन-इन करने के तुरंत बाद या एक क्लिक में कॉन्टेंट चलना चाहिए.
• आपके ऐप्लिकेशन या प्लैटफ़ॉर्म में, सभी उपयोगकर्ताओं के लिए कम से कम एक ऐसा तरीका होना चाहिए जिससे वे अपनी पसंद का गाना, एल्बम, कलाकार या प्लेलिस्ट चला सकें.
  • जिन उपयोगकर्ताओं के पास कॉन्टेंट चलाने की ज़रूरी शर्तें नहीं हैं (उदाहरण के लिए, उनके पास ज़रूरी सदस्यता नहीं है) उनके लिए, आपकी सेवा को यह बताना होगा कि आपके ऐप्लिकेशन या प्लैटफ़ॉर्म पर आने पर, कॉन्टेंट चलाने की ज़रूरी शर्तें पूरी करने के लिए उपयोगकर्ता को क्या करना होगा.

हम आपके ऐप्लिकेशन या प्लैटफ़ॉर्म के लिए, ये सबसे सही तरीके अपनाने का सुझाव देते हैं:

• MusicGroup के लिए, जब भी कोई उपयोगकर्ता कलाकार को चुनता है, तो कलाकार का अलग-अलग कॉन्टेंट चलाएं.
• MusicAlbum के लिए, एल्बम में दिखने के क्रम में कॉन्टेंट चलाएं.
• MusicPlaylist के लिए, हर बार जब कोई उपयोगकर्ता प्लेलिस्ट चुनता है, तो प्लेलिस्ट से अलग-अलग कॉन्टेंट चलाएं.

डीप लिंक की पहचान करना

तो निम्न कार्य करें:

1. हर कॉन्टेंट के लिए देखें कि क्या उसमें प्लैटफ़ॉर्म के हिसाब से अलग-अलग डीप लिंक हैं.
2. हर डीप लिंक के एंट्री पॉइंट (आपके ऐप्लिकेशन या प्लैटफ़ॉर्म पर मौजूद वह पेज जहां डीप लिंक आपको ले जाता है) के बारे में ये सवाल पूछें:
   • क्या एंट्री पॉइंट (कॉन्टेंट नहीं) कई भाषाओं में काम करता है?
   • क्या एंट्री पॉइंट में सबटाइटल की कई भाषाएं काम करती हैं?
   • क्या एंट्री पॉइंट में कैमरे के कई ऐंगल काम करते हैं?
   • क्या एंट्री पॉइंट, कई वीडियो फ़ॉर्मैट के साथ काम करता है?

अगर इनमें से किसी भी सवाल के लिए आपका जवाब हां है, तो आपको उस डीप लिंक के लिए additionalProperty प्रॉपर्टी देनी होगी. additionalProperty का उदाहरण देखें.