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

जब कोई उपयोगकर्ता कॉन्टेंट पर मीडिया के लिए कार्रवाइयाँ करता है (उदाहरण के लिए, Google Search पर मौजूद आपके आइकॉन पर क्लिक करता है), तो 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, कस्टम स्कीम यूआरआई में शामिल होना चाहिए. इससे यह पक्का होता है कि अगर आपका ऐप्लिकेशन इंस्टॉल नहीं है, तो उपयोगकर्ता को 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:// (arbitrary string) अनुमति नहीं है अनुमति नहीं है

प्लैटफ़ॉर्म के टाइप

यह पक्का करने के लिए कि आपका कॉन्टेंट, Google के उन सभी प्लैटफ़ॉर्म पर उपलब्ध हो जिन पर मीडिया के लिए कार्रवाइयाँ की सुविधा काम करती है, इन ज़रूरी शर्तों का पालन करें:

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

प्लैटफ़ॉर्म ब्यौरा
http://schema.org/DesktopWebPlatform डेस्कटॉप वेब ब्राउज़र पर Search Platform.
http://schema.org/MobileWebPlatform मोबाइल वेब ब्राउज़र पर खोज प्लैटफ़ॉर्म.
http://schema.org/AndroidPlatform Android ऐप्लिकेशन पर खोज और PlayGuide प्लैटफ़ॉर्म.
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 लोगों को आपके ऐप्लिकेशन या प्लैटफ़ॉर्म पर ले जाता है, तो हम आपसे चुने गए कॉन्टेंट को अपने-आप चलने की सुविधा चालू करने के लिए कहते हैं. इससे लोग, कॉन्टेंट को तुरंत देखना या सुनना शुरू कर सकते हैं.

कॉन्टेंट देखने से जुड़ी कार्रवाइयों के प्लेबैक का तरीका

वीडियो देखने से जुड़ी कार्रवाइयों के लिए, वीडियो चलाने का तरीका यहां दिया गया है.

सभी डीप लिंक: मूवी, TVEpisode, 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 के लिए, जब भी कोई व्यक्ति प्लेलिस्ट चुने, तो उसे प्लेलिस्ट में मौजूद अलग-अलग कॉन्टेंट सुनाएं.

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

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

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