Engage SDK टूल के बारे में अक्सर पूछे जाने वाले सवाल

अक्सर पूछे जाने वाले सवाल पब्लिश करना

कॉन्टेंट पब्लिश करने के काम को कौन मैनेज करता है?

ऐप्लिकेशन डेवलपर, कॉन्टेंट पब्लिश करने के काम को मैनेज करता है. साथ ही, Engage Service को अनुरोध भेजता है. इस तरह, डेवलपर पार्टनर के पास यह कंट्रोल होता है कि वे उपयोगकर्ताओं के लिए कॉन्टेंट कब और कैसे पब्लिश करें. इससे कॉन्टेंट पब्लिश करने के लिए, पार्टनर ऐप्लिकेशन को बार-बार चालू करने की ज़रूरत नहीं पड़ती.

क्या डेवलपर को सभी तरह के क्लस्टर पब्लिश करने होंगे?

तकनीकी तौर पर, डेवलपर सिर्फ़ एक क्लस्टर पब्लिश कर सकते हैं. हालांकि, हम ज़ोर देकर सलाह देते हैं कि वे ज़्यादा क्लस्टर शामिल करें. ऐसा न करने पर, डेवलपर अपने कॉन्टेंट में लोगों की दिलचस्पी बढ़ाने का मौका खो देते हैं. हमारा सुझाव है कि हर वर्टिकल के लिए, सभी क्लस्टर टाइप पब्लिश करें.

ऐप्लिकेशन के चालू होने पर, डेवलपर पार्टनर को वर्क मैनेजर का इस्तेमाल करके कितनी बार डेटा पब्लिश करना चाहिए?

यह फ़ैसला डेवलपर पार्टनर को लेना है. Google का सुझाव है कि सामान्य सुझाव वाले कॉन्टेंट को दिन में एक या दो बार पब्लिश करें. साथ ही, शॉपिंग कार्ट, फिर से ऑर्डर करने, और अन्य जारी रखने वाले कॉन्टेंट के लिए, इवेंट-ड्रिवन तरीके का इस्तेमाल करें. उदाहरण के लिए, उपयोगकर्ता के कार्ट में आइटम जोड़ने या किसी मूवी को बीच में रोकने पर, वर्कर को कॉलबैक के तौर पर शुरू करें. सोशल मीडिया ऐप्लिकेशन के लिए, हर बार ऐप्लिकेशन इस्तेमाल करने के बाद, सुझावों के अपडेट किए गए क्लस्टर पब्लिश करना ज़रूरी है. सोशल ऐप्लिकेशन इस्तेमाल करने वाले लोग, हाल ही के सुझावों में ज़्यादा दिलचस्पी दिखाते हैं. साथ ही, वे किसी पोस्ट को ज़्यादा से ज़्यादा एक बार देखना चाहते हैं.

डेवलपर को मिटाने वाले एपीआई को कब कॉल करना चाहिए?

मिटाने वाले एपीआई को सिर्फ़ तब कॉल किया जाना चाहिए, जब पब्लिश करने के लिए कोई कॉन्टेंट न हो. कॉन्टेंट को बदलने के लिए, मिटाने और पब्लिश करने वाले एपीआई को बाद में नहीं कॉल करें. पब्लिश करने वाले एपीआई, पहले के कॉन्टेंट को अपने-आप हटा देते हैं.

ब्रॉडकास्ट इंटेंट के बारे में अक्सर पूछे जाने वाले सवाल

Android ऐप्लिकेशन डेवलपर को ब्रॉडकास्ट इंटेंट के लिए रजिस्टर क्यों करना पड़ता है?

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

ब्रॉडकास्ट इंटेंट की जांच नहीं की जा सकती

पुष्टि करने वाला ऐप्लिकेशन, अनुमति के साथ ब्रॉडकास्ट इंटेंट की जांच करने की सुविधा नहीं देता. आपको टेस्टिंग के दौरान अनुमतियां हटानी होंगी. साथ ही, छठे चरण में एसडीके को प्रोडक्शन वर्शन पर स्विच करने से पहले, उन्हें वापस जोड़ना होगा.

बैकग्राउंड में प्रोग्राम चलाने की अनुमति नहीं है

ब्रॉडकास्ट इंटेंट रजिस्टर करते समय, आपको यह गड़बड़ी दिख सकती है:

Background execution not allowed: receiving Intent
{ act=com.google.android.engage.action.PUBLISH_RECOMMENDATION .. }

आपको ब्रॉडकास्ट रिसीवर को डाइनैमिक तरीके से रजिस्टर करना होगा.

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION,
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null));
...

}

वर्कफ़्लो से जुड़े अक्सर पूछे जाने वाले सवाल

SDK टूल के साथ इंटिग्रेट करते समय, आपको ये गड़बड़ियां दिख सकती हैं:

ऐप्लिकेशन, क्लस्टर, और इकाई के लेवल पर पुष्टि करने से जुड़ी गड़बड़ियां

ऐप्लिकेशन, क्लस्टर, और इकाई के लेवल पर मौजूद खास जानकारी में, पुष्टि करने से जुड़ी गड़बड़ियों की संख्या दिखती है. ये गड़बड़ियां, ज़रूरी फ़ील्ड में जानकारी न होने या अमान्य वैल्यू देने की वजह से होती हैं. गड़बड़ी के मैसेज, हर काम के फ़ील्ड के नीचे लाल रंग में दिखते हैं. पुष्टि से जुड़ी सभी गड़बड़ियां ठीक करें. साथ ही, APK शेयर करने से पहले, यह पक्का करें कि वह सही हो.

डीप लिंक, पैकेज के नाम से जुड़े होते हैं. डीप लिंक की जांच करने का सबसे अच्छा तरीका, adb टूल का इस्तेमाल करना है.

adb shell am start -W -a android.intent.action.VIEW -d <DEEPLINK URI> <PACKAGE NAME>

डीप लिंक, एट्रिब्यूशन को ट्रैक करने का एक बेहतरीन तरीका है. डीप लिंक वाले यूआरएल, उपयोगकर्ताओं को आपके ऐप्लिकेशन पर ले जाते हैं. इन्हें अतिरिक्त ट्रैकिंग पैरामीटर के साथ शामिल किया जा सकता है. उदाहरण के लिए - "http://xx/deeplink?source_tag=engage".

डेवलपर, अपने ट्रैकिंग पैरामीटर जोड़ सकते हैं. साथ ही, असर का हिसाब लगाने के लिए एट्रिब्यूशन की जानकारी दे सकते हैं.

Engage for TV 2.0 के बारे में अक्सर पूछे जाने वाले सवाल

सामान्य सवाल

'देखना जारी रखें 2.0' सुविधा क्या है?

"वहीं से देखना शुरू करें जहां आपने पिछली बार छोड़ा था" सुविधा को और बेहतर बनाने के लिए, Continue Watching 2.0 (Video Discovery API) लॉन्च किया गया है! यह एक अहम अपग्रेड है. इससे व्यूअर, अलग-अलग डिवाइसों पर आसानी से कॉन्टेंट देखना जारी रख सकते हैं. मान लें कि आपने Google TV पर कोई फ़िल्म देखना शुरू किया और फिर यात्रा के दौरान उसे अपने फ़ोन पर देखना जारी रखा. यह सुविधा, 'देखना जारी रखें 2.0' की मदद से मिलती है.

इस नए सिस्टम को इस तरह से डिज़ाइन किया गया है कि इससे दर्शकों की दिलचस्पी बढ़ेगी और वे लंबे समय तक जुड़े रहेंगे. इसके लिए, यह Google के पूरे ईकोसिस्टम में बिना किसी रुकावट के काम करता है.

Continue Watching 2.0 का इस्तेमाल करने के क्या फ़ायदे हैं?

जवाब: 'देखना जारी रखें 2.0' सुविधा की मदद से, दर्शक आसानी से उस जगह से वीडियो देखना शुरू कर सकते हैं जहां उन्होंने छोड़ा था. इससे कोई फ़र्क़ नहीं पड़ता कि वे किस डिवाइस का इस्तेमाल कर रहे हैं. यह इस तरह से काम करता है:

  • Google के सभी प्लैटफ़ॉर्म पर एक जैसा अनुभव: Google TV पर वीडियो देखना शुरू करें और इसे अपने Android फ़ोन, iPhone या Android टैबलेट पर जारी रखें. यह उन डिवाइसों पर भी काम करता है जिन पर आपने अब तक ऐप्लिकेशन इंस्टॉल नहीं किया है!
  • उपयोगकर्ताओं का जुड़ाव और उन्हें बनाए रखने में मदद मिलती है: 'देखना जारी रखें 2.0' सुविधा की मदद से, उपयोगकर्ताओं को नए डिवाइसों पर भी आपके ऐप्लिकेशन पर वापस लाया जा सकता है. उपयोगकर्ताओं को उनके पसंदीदा शो फिर से शुरू करने की सुविधा देकर, उन्हें वीडियो देखते रहने के लिए बढ़ावा दिया जा सकता है.
  • ज़्यादा डिवाइसों पर उपलब्ध: 'देखना जारी रखें 2.0' सुविधा, Google TV के अलावा Android के अन्य मीडिया ऐप्लिकेशन पर भी काम करती है. जैसे, Play Cubes और Google के अन्य मीडिया ऐप्लिकेशन.
  • पुराने वर्शन के साथ काम करने वाला: अगर पहले से ही "अगला वीडियो देखें" सुविधा का इस्तेमाल किया जा रहा है, तो कोई समस्या नहीं है! 'देखना जारी रखें 2.0' सुविधा, पिछले वर्शन के साथ काम करती है. इसलिए, आपका मौजूदा इंटिग्रेशन अब भी काम करेगा.

अहम जानकारी: 'देखना जारी रखें' सुविधा के सभी नए इंटिग्रेशन में, 'देखना जारी रखें 2.0' का इस्तेमाल करना होगा. "क्रॉस डिवाइस पर 'अगला आइटम चलाएं' सुविधा" के पुराने सिस्टम को बंद किया जा रहा है.

Continue Watching 2.0 की सुविधा किन प्लैटफ़ॉर्म पर उपलब्ध है?

  1. Google TV
  2. Android TV (सिर्फ़ डिवाइस पर, लेकिन Engage SDK के साथ काम करता है)
  3. Google TV का Android मोबाइल ऐप्लिकेशन
  4. Google TV का iOS मोबाइल ऐप्लिकेशन
  5. Play Cubes
  6. Google का Entertainment Space
  7. iOS डिवाइस (REST API इंटिग्रेशन के साथ).

क्या Engage SDK, Continue Watching 2.0 के लिए है?

हां, Engage SDK का इस्तेमाल Continue Watching 2.0 के लिए किया जाता है. इसे Continue Watching 2.0 के साथ इंटिग्रेट करना ज़रूरी है.

क्या Continue Watching 2.0 की सुविधा सभी के लिए उपलब्ध है?

Continue Watching 2.0 को चरणों में रोल आउट किया जा रहा है.

  • रिलीज़ होने से पहले इस्तेमाल करने का ऐक्सेस: फ़िलहाल, हम रिलीज़ होने से पहले इस्तेमाल करने का ऐक्सेस देने वाले कार्यक्रम (ईएपी) के ज़रिए, चुनिंदा पार्टनर को यह सुविधा दे रहे हैं.
  • ऐक्सेस बढ़ाना: हम जल्द ही सभी डेवलपर के लिए, 'देखना जारी रखें 2.0' सुविधा उपलब्ध कराने पर काम कर रहे हैं.

लॉन्च को आसान और सफल बनाने के लिए, हमने रोलआउट को मैनेज करने के लिए सुरक्षा से जुड़े इंतज़ाम किए हैं. इसमें, 'देखना जारी रखें 2.0' सुविधा के लिए अनुमति वाली सूची और Engage SDK में अलग से जांच करना, दोनों शामिल हैं. चाहे आप ईएपी पार्टनर हों या आपको जल्द ही पार्टनर बनना हो, कृपया हमसे संपर्क करें. इससे हम Engage SDK को इंटिग्रेट करने से पहले, ऐक्सेस करने की अनुमतियां सेट अप कर पाएंगे.

इकाइयां बनाएं सेक्शन में, इमेज से जुड़ी ज़रूरी शर्तों को अपडेट किया गया है.

क्या इस नए एपीआई दस्तावेज़ की मदद से, Google सर्वर क्लाइंट से 'देखना जारी रखें' सुविधा का डेटा पुल कर पाएगा? साथ ही, क्या यह डेटा सभी डिवाइसों पर दिखेगा?

एपीआई के नए वर्शन में, 'देखना जारी रखें' सुविधा के लिए कई फ़ायदे दिए गए हैं. इनमें ये शामिल हैं:

  • Google TV पर बिना किसी रुकावट के कॉन्टेंट देखने की सुविधा: उपयोगकर्ता किसी एक Google TV पर कॉन्टेंट देखना शुरू कर सकते हैं. इसके बाद, उसी खाते से लॉग इन करके किसी दूसरे Google TV पर कॉन्टेंट देखना जारी रख सकते हैं. यह सुविधा, Android TV के पुराने वर्शन पर भी काम करती है.

  • मोबाइल ऐप्लिकेशन इंटिग्रेशन: 'देखना जारी रखें' सुविधा, Android और iOS के लिए Google TV मोबाइल ऐप्लिकेशन पर उपलब्ध है. इससे उपयोगकर्ता, टीवी और मोबाइल डिवाइसों के बीच आसानी से स्विच कर सकते हैं.

  • उपयोगकर्ताओं का जुड़ाव बढ़ना: जिन डिवाइसों पर ऐप्लिकेशन इंस्टॉल नहीं है या जहां उपयोगकर्ता ने लॉग इन नहीं किया है वहां भी 'देखना जारी रखें' सुविधा, उपयोगकर्ताओं को आपके ऐप्लिकेशन से फिर से जुड़ने के लिए प्रेरित करती है. इससे उपयोगकर्ताओं का जुड़ाव बढ़ता है.

  • अन्य प्लैटफ़ॉर्म पर उपलब्ध: इस इंटिग्रेशन की मदद से, 'देखना जारी रखें' सुविधा को Google के अन्य मीडिया प्लैटफ़ॉर्म पर उपलब्ध कराया जा सकता है. जैसे, Android, Play Cubes, टैबलेट, और Android पर मौजूद Google के अन्य मीडिया ऐप्लिकेशन और प्लैटफ़ॉर्म. इससे अलग-अलग डिवाइसों पर उपयोगकर्ताओं की दिलचस्पी बढ़ाई जा सकती है.

मैं Continuation क्लस्टर में कितनी इकाइयां पब्लिश कर सकता/सकती हूं?

हर डेवलपर पार्टनर को, जारी रखने वाले क्लस्टर में ज़्यादा से ज़्यादा पांच इकाइयां ब्रॉडकास्ट करने की अनुमति होगी. यह सीमा, Google TV पर "देखना जारी रखें" लाइन में कॉन्टेंट को सही तरीके से डिस्ट्रिब्यूट करने के लिए है. यह लाइन, मीडिया सेवाएं देने वाली कई कंपनियों के लिए शेयर की गई जगह होती है.

अगर मैं पांच से ज़्यादा इकाइयां पब्लिश करने की कोशिश करूं, तो क्या होगा?

अगर आपकी पांच से ज़्यादा इकाइयां हैं, तो EngageSDK, पब्लिश करने के आपके अनुरोध को अस्वीकार कर देगा. पब्लिश करने के लिए, आपको अपने अनुरोध में मौजूद इकाइयों की संख्या कम करनी होगी. आपको सिर्फ़ उन इकाइयों को शामिल करना चाहिए जहां उपयोगकर्ताओं ने वीडियो देखना बंद कर दिया था. इसलिए, ज़्यादातर मामलों में ऐसी कुछ ही इकाइयां होंगी. अगर ऐसी पांच से ज़्यादा इकाइयां हैं, तो पब्लिश करने के लिए नई इकाइयां चुनी जा सकती हैं.

इकाइयों की संख्या पर सीमा क्यों तय की गई है?

Google TV पर "देखना जारी रखें" लाइन में, अलग-अलग मीडिया कंपनियों का कॉन्टेंट दिखता है. हर प्रोवाइडर के लिए इकाइयों की संख्या सीमित करना, ताकि उपयोगकर्ताओं को उनके सभी पसंदीदा सोर्स से अलग-अलग तरह का कॉन्टेंट दिखे. इससे, उपयोगकर्ताओं को निष्पक्ष और संतुलित अनुभव मिलता है.

पुष्टि करने वाले ऐप्लिकेशन से जुड़े सवाल

क्या ऐप्लिकेशन सबमिट करने से पहले, पुष्टि करने वाले ऐप्लिकेशन से उसकी जांच करना ज़रूरी है?

हां, अपना APK सबमिट करने से पहले, पुष्टि करने वाले ऐप्लिकेशन की मदद से अपने ऐप्लिकेशन की जांच करना ज़रूरी है.

हम समझते हैं कि आपको अपने इंटिग्रेशन पर भरोसा हो सकता है. हालांकि, Continue Watching 2.0 के इंटिग्रेशन में कई जटिल कॉम्पोनेंट होते हैं. पुष्टि करने वाला ऐप्लिकेशन, सुरक्षा के तौर पर काम करता है. यह संभावित समस्याओं का पता पहले ही लगा लेता है. इससे आपको लंबे समय तक, कीमती समय और मेहनत बचाने में मदद मिलती है.

इसे एक क्विक चेकअप की तरह समझें. इससे यह पक्का करने में मदद मिलती है कि आपका ऐप्लिकेशन आसानी से लॉन्च हो और उपयोगकर्ताओं को बेहतरीन अनुभव मिले.

किसी भी समस्या का पहले से पता लगाकर उसे ठीक किया जा सकता है. इससे, आपको बार-बार अस्वीकार होने और फिर से सबमिट करने की समस्या से बचने में मदद मिलती है.

अपना APK सबमिट करने के लिए, आपको एक ऐसा स्क्रीनशॉट शामिल करना होगा जिससे पता चले कि आपके ऐप्लिकेशन की पुष्टि हो चुकी है.

इंटिग्रेशन के दौरान, आम तौर पर होने वाली कुछ गलतियां कौनसी हैं?

पुष्टि करने वाले ऐप्लिकेशन को, 'देखना जारी रखें 2.0' सुविधा के इंटिग्रेशन से जुड़ी संभावित समस्याओं का पता लगाने के लिए डिज़ाइन किया गया है. यहां कुछ सामान्य गलतियां बताई गई हैं जो अक्सर डेवलपर को दिखती हैं:

सभी तरह के कॉन्टेंट (फ़िल्में, टीवी एपिसोड, लाइव स्ट्रीम, वीडियो क्लिप) के लिए:

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

टीवी एपिसोड के लिए:

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

फ़िल्मों के लिए:

  • वीडियो चलाने की सटीक स्थिति: टीवी एपिसोड की तरह ही, यह पुष्टि करें कि वीडियो चलाने की आखिरी स्थिति सटीक है.

लाइव स्ट्रीमिंग वाले वीडियो के लिए:

  • ब्रॉडकास्टर की जानकारी: लाइव स्ट्रीम के लिए, ब्रॉडकास्टर का नाम शामिल करें.

वीडियो क्लिप के लिए:

  • क्रिएटर की जानकारी: वीडियो क्लिप के क्रिएटर का नाम डालें.

ध्यान दें: पुष्टि करने वाला ऐप्लिकेशन, इन समस्याओं के बारे में सूचना देगा. इससे आपको ऐप्लिकेशन सबमिट करने से पहले, इन समस्याओं को ठीक करने का मौका मिलेगा. इससे आपका समय बचेगा और उपयोगकर्ताओं को बेहतर अनुभव मिलेगा.

खाते और प्रोफ़ाइल से जुड़े सवाल

मेरा ऐप्लिकेशन, पहचान छिपाकर लॉगिन करने की सुविधा का इस्तेमाल करता है. क्या Continue Watching 2.0 के लिए अब भी AccountProfile की ज़रूरत है?

AccountProfile को उन ऐप्लिकेशन के लिए डिज़ाइन किया गया है जो व्यक्तिगत उपयोगकर्ता खातों का इस्तेमाल करते हैं. हालांकि, हम समझते हैं कि आपके जैसे कुछ ऐप्लिकेशन, पहचान छिपाकर लॉगिन करने की सुविधा पर निर्भर हो सकते हैं. यहां बताया गया है कि इस स्थिति में, Continue Watching 2.0 कैसे काम करता है:

  • तकनीकी तौर पर AccountProfile ज़रूरी है, लेकिन... अगर आपके ऐप्लिकेशन में उपयोगकर्ता खाता सिस्टम नहीं है, तब भी Continue Watching 2.0 को इंटिग्रेट किया जा सकता है.
  • सिर्फ़ डिवाइस पर इस्तेमाल किया जा सकता है: 'देखना जारी रखें 2.0' की क्रॉस-डिवाइस सुविधाएं, अलग-अलग डिवाइसों पर उपयोगकर्ताओं की पहचान करने पर निर्भर करती हैं. गुमनाम लॉगिन में यह जानकारी नहीं मिलती. इसलिए, यह सुविधा सिर्फ़ उपयोगकर्ता के मौजूदा डिवाइस पर उपलब्ध होगी.
  • कॉन्फ़िगर करने का तरीका: इसे सेट अप करने के लिए, आपको अलग-अलग डिवाइसों के बीच सिंक करने की सुविधा बंद करनी होगी. इससे यह पक्का किया जाता है कि 'देखना जारी रखें' सेक्शन में सिर्फ़ उस डिवाइस पर एंट्री दिखें जिस पर कॉन्टेंट देखना शुरू किया गया था.

खास जानकारी: Continue Watching 2.0 को बिना पहचान बताए लॉगिन करने की सुविधा के साथ इंटिग्रेट किया जा सकता है. हालांकि, उपयोगकर्ता सिर्फ़ उसी डिवाइस पर कॉन्टेंट देखना जारी रख पाएंगे.

क्या मेरे ऐप्लिकेशन में accountId और profileId, दोनों इस्तेमाल किए जा सकते हैं? अगर हां, तो क्या सिर्फ़ accountId का इस्तेमाल करके AccountProfile बनाया जा सकता है?

AccountProfile को सही तरीके से काम करने के लिए, accountId और profileId, दोनों की ज़रूरत होती है. यहां इसकी वजह दी गई है:

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

क्या Continue Watching 2.0 के लिए profileId ज़रूरी है?

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

Google, profileId का इस्तेमाल कैसे करता है?

अगर सेवा पर कॉन्टेंट देखने के लिए अलग-अलग प्रोफ़ाइलें उपलब्ध हैं, तो accountId और profileId का इस्तेमाल किया जाएगा. इससे डिवाइस पर देखा गया कॉन्टेंट, डिवाइस पर साइन इन किए गए Google खाते से जुड़ जाएगा. Google, accountId-profileId के कॉम्बिनेशन के हिसाब से, ContinueWatching डेटा रिकॉर्ड करेगा. जिस Google डिवाइस पर उसी Google खाते से लॉग इन किया गया है उस पर, 'देखना जारी रखें' लाइन में, उसी accountId-profileId से जुड़ा अपडेट किया गया नया डेटा दिखेगा.

क्या 'देखना जारी रखें 2.0' सुविधा को लागू करने के लिए, खाते को लिंक करना ज़रूरी है?

खाता लिंक करने की ज़रूरत नहीं है. इसे प्राथमिकता नहीं दी जा रही है. साथ ही, इससे जुड़े सभी इस्तेमाल के उदाहरण, Device Entitlements API के नए वर्शन में शामिल किए जाएंगे.

सभी डिवाइसों पर सिंक करने से जुड़े सवाल

"सभी डिवाइसों पर सिंक करें" सुविधा के लिए उपयोगकर्ता की सहमति मिलने पर, देखा जा रहा कॉन्टेंट Google TV के सर्वर पर सेव हो जाएगा. इससे, उपयोगकर्ता किसी भी ऐसे डिवाइस पर कॉन्टेंट देखना जारी रख पाएगा जिस पर उसने साइन इन किया है. सहमति के बिना, वीडियो देखने के इतिहास की जानकारी मौजूदा डिवाइस पर ही सेव रहती है.

क्या "सभी डिवाइसों पर सिंक करें" को फ़ॉल्स पर सेट किया जा सकता है?

UserConsentToSyncAcrossDevices फ़्लैग से यह कंट्रोल किया जाता है कि किसी उपयोगकर्ता के ContinuationCluster डेटा को उसके सभी डिवाइसों (टीवी, फ़ोन, टैबलेट वगैरह) पर सिंक किया जाए या नहीं. अगर इस फ़्लैग को 'false' पर सेट किया जाता है, तो वीडियो वहीं से देखना जारी रखने की सुविधा सिर्फ़ उसी डिवाइस पर काम करती है.

हमारा सुझाव है कि क्रॉस-डिवाइस सुविधा का ज़्यादा से ज़्यादा फ़ायदा पाने के लिए, आपका ऐप्लिकेशन उपयोगकर्ता की सहमति ले और SyncAcrossDevices को 'सही' पर सेट करे.

डिवाइसों पर? Android के अलावा अन्य डिवाइसों से, तीसरे पक्ष के सर्वर पर कौनसा डेटा शेयर किया जाता है?

सहमति, उपयोगकर्ता लेवल (प्रोफ़ाइल या खाता लेवल) पर इकट्ठा की जाती है. सहमति मिलने के बाद, दिलचस्पी के आधार पर 'देखना जारी रखें' पेलोड को कहीं भी भेजा जा सकता है. इससे Google, उपयोगकर्ताओं की वीडियो देखने की स्थिति को उन सभी इकाइयों में दिखा सकता है जिनमें उनकी दिलचस्पी है. ऐसा किसी भी डिवाइस पर किया जा सकता है. इसके लिए, हर डिवाइस या प्लैटफ़ॉर्म पर सहमति लेने की ज़रूरत नहीं होती. पार्टनर, उपयोगकर्ताओं को 'देखना जारी रखें' सुविधा की मौजूदा स्थिति (स्पेसिफ़िकेशन के मुताबिक) भेजेंगे. यह स्थिति, प्रोफ़ाइल आईडी से जुड़ी होगी. यह आईडी, Android पर सबमिट किया गया था.

REST API से जुड़े सवाल

क्या REST API के बारे में कोई दस्तावेज़ उपलब्ध है?

REST API मार्च 2025 तक उपलब्ध हो जाएगा. इसकी जानकारी, Continue Watching 2.0 के डेवलपर दस्तावेज़ में दी गई है.

'अगला वीडियो देखें' सुविधा से जुड़े लेगसी सवाल

क्या Video Discovery API, Watch Next API की जगह ले रहा है?

Video Discovery API, उन सभी Android TV डिवाइसों पर काम करेगा जिन पर Watch Next API काम करता है. सभी डेवलपर को, 'देखना जारी रखें' रो में कॉन्टेंट पब्लिश करने के लिए, Video Discovery API (Continue Watching 2.0) का इस्तेमाल करना चाहिए.

जांच और इंटिग्रेशन से जुड़े सवाल

LastPlayBackPositionTimeMillis और अवधि में क्या अंतर है?

LastPlayBackPositionTimeMillis में, वीडियो चलने का वह समय (मिलीसेकंड में) दिखना चाहिए जहां उपयोगकर्ता ने वीडियो देखना बंद किया था. उदाहरण के लिए, 605000 मि॰से॰ (10 मिनट और 5 सेकंड). यह कभी भी इकाई की कुल अवधि से ज़्यादा नहीं होनी चाहिए.

वहीं, LastEngagementTime वह टाइमस्टैंप होता है, जब उपयोगकर्ता ने कॉन्टेंट के साथ आखिरी बार इंटरैक्ट किया था.

हमें कौनसे टेस्ट केस करने चाहिए?

यहां Google TV के लिए टेस्ट केस दिए गए हैं. इन्हें हमारी क्यूए टीम करती है. इसी तरह के टेस्ट केस, अन्य प्लैटफ़ॉर्म पर भी किए जा सकते हैं.

  1. 20 मिनट से ज़्यादा अवधि का कोई वीडियो, पांच मिनट तक देखें. ऐप्लिकेशन बंद करें. वीडियो कार्ड, "देखना जारी रखें" लाइन में दिखना चाहिए. ध्यान दें: हम CW में, तीसरे पक्ष के हर ऐप्लिकेशन के लिए सिर्फ़ पांच कार्ड दिखाते हैं
  2. "देखना जारी रखें" लाइन में हाल ही में दिखे कार्ड को चुनने पर, वीडियो उसी जगह से चलना चाहिए जहां उसे रोका गया था.ध्यान दें: नया या पुराना कोई भी कॉन्टेंट, वहीं से चलना चाहिए जहां उसे पिछली बार रोका गया था
  3. GTV डिवाइस पर खाते बदलने से, 'देखना जारी रखें' लाइन में मौजूद कार्ड बदल जाने चाहिए. सिर्फ़ मौजूदा खाते के वीडियो दिखने चाहिए. हाल ही के क्रम में लगाया गया. तीसरे पक्ष के ऐप्लिकेशन की प्रोफ़ाइल CW को इंटरमिक्स किया जाएगा. ध्यान दें: GoogleAccount2 के लिए CW में, तीसरे पक्ष का वह कॉन्टेंट दिखेगा जिसे GoogleAccount2 ने देखा था
  4. BACK बटन दबाकर ऐप्लिकेशन से बाहर निकलें > पुष्टि करें कि कार्ड, "देखना जारी रखें" लाइन में दिख रहा है
  5. "देखना जारी रखें" लाइन में मौजूद वीडियो को छिपाएं. यह वीडियो फिर से नहीं दिखना चाहिए. जांच करें कि छिपाया गया कॉन्टेंट, 24 घंटे तक छिपा रहे. साथ ही, यह भी जांच करें कि 24 घंटे बाद ऐप्लिकेशन खोलने पर भी यह कॉन्टेंट न दिखे. पुष्टि करें कि एक आइटम को छिपाने से, कई आइटम न छिप जाएं.
  6. 'देखना जारी रखें' सेक्शन में पूरा मेटाडेटा मौजूद होना चाहिए, ताकि कॉन्टेंट उपलब्ध हो सके: कार्ड इमेज, ऐप्लिकेशन का नाम, टाइटल, टीवी कॉन्टेंट के लिए सीज़न और एपिसोड #
  7. 'प्रोग्रेस देखें' विकल्प, प्रोग्रेस बार में दिखता है
  8. उपयोगकर्ता ने एंडिंग क्रेडिट तक कॉन्टेंट देखा - कॉन्टेंट, 'देखना जारी रखें' सेक्शन में नहीं दिखता
  9. पुष्टि करें कि 'देखना जारी रखें' लाइन में, ऐसे आइटम न दिखें जिन्हें नहीं देखा गया है
  10. पुष्टि करें कि CW आइटम, वॉच ऐक्टिविटी के समय के हिसाब से क्रम में लगाए गए हैं. यह क्रम, ऐप्लिकेशन के आखिरी बार खुलने या आखिरी दिन के हिसाब से नहीं लगाया गया है
  11. पुष्टि करें कि CW कार्ड पर एपिसोड और सीज़न की जानकारी, एपिसोड वाले कॉन्टेंट पर देखी गई जानकारी से मेल खाती हो
  12. पुष्टि करें कि क्रेडिट या उससे ज़्यादा कीमत वाले आइटम, 'देखना जारी रखें' सेक्शन में न दिखें
  13. एपिसोड/फ़िल्म/शो देखते समय, डिवाइस को बीच में ही बंद कर दें. "एपिसोड/फ़िल्म/शो को आधा देखने के बाद, डिवाइस को बंद कर दें. डिवाइस चालू करने पर और अन्य टीवी पर, CW सही कार्ड दिखाता है. यह कार्ड सही जगह पर दिखता है और इसमें प्रोग्रेस बार भी होता है"
  14. पहले एपिसोड को पूरा देखने के बाद, डिवाइस को बंद करें और पुष्टि करें
  15. पहले एपिसोड के रिलीज़ होने के बाद, वह 'देखना जारी रखें' लाइन में नहीं दिखता [दूसरे डिवाइस पर और टेस्ट डिवाइस को चालू करने पर]
    1. अगर दूसरा एपिसोड उपलब्ध है, तो वह 'देखना जारी रखें' लाइन में दिखना चाहिए [दूसरे डिवाइस पर और टेस्ट डिवाइस को चालू करने पर]
  16. पहला उदाहरण: TV1: Google खाता: मां, तीसरे पक्ष का खाता / प्रोफ़ाइल: खाता 1 / profile_1. कॉन्टेंट देखना और यह पुष्टि करना कि CW डेटा, तीसरे पक्ष के account_1/profile_1 से देखे गए कॉन्टेंट को दिखाता है

  17. TV2: GoogleAccount: mom. पहले परिदृश्य से मिले सीडब्ल्यू डेटा की पुष्टि करें. अब किसी दूसरे खाते से, तीसरे पक्ष के ऐप्लिकेशन में लॉग इन करें. 3p खाता / प्रोफ़ाइल: account_2 / profile_2. कॉन्टेंट देखना और यह पुष्टि करना कि CW डेटा, तीसरे पक्ष के account_2/profile_2 से देखे गए कॉन्टेंट को दिखाता है

  18. GoogleAccount: mom. नए डिवाइस में केस /3P ऐप्लिकेशन इंस्टॉल नहीं है. नए डिवाइस पर(डिवाइस को फ़ैक्ट्री रीसेट करें), पुष्टि करें कि CW, Google खाते से इस्तेमाल किए गए तीसरे पक्ष के आखिरी ऐप्लिकेशन का डेटा दिखाता है. ध्यान दें: अगर GAIA को किसी दूसरे डिवाइस पर 3P प्रोफ़ाइल से अभी तक नहीं जोड़ा गया है, तो CW लाइन में 3P कॉन्टेंट नहीं दिखना चाहिए

    1. GoogleAccount: mom. नया डिवाइस केस /3P ऐप्लिकेशन इंस्टॉल किया गया है, लेकिन उसमें लॉग इन नहीं किया गया है. नए डिवाइस(डिवाइस को फ़ैक्ट्री रीसेट करें) पर, पुष्टि करें कि CW, Google खाते से इस्तेमाल किए गए आखिरी 3P ऐप्लिकेशन का डेटा दिखाता है.
    1. ध्यान दें: अगर Google खाता, तीसरे पक्ष की प्रोफ़ाइल से अब तक नहीं जुड़ा है, तो 'देखना जारी रखें' लाइन में तीसरे पक्ष का कॉन्टेंट नहीं दिखना चाहिए

हमें Google TV के iOS ऐप्लिकेशन पर, 'देखना जारी रखें' सेक्शन नहीं दिख रहा है. क्या हुआ?

iOS डिवाइसों पर 'देखना जारी रखें' सुविधा दिखाने के लिए, आपको iOS डीपलिंक भेजने होंगे.

मुझे 'देखना जारी रखें' सुविधा के लिए जानकारी कितनी बार अपडेट करनी चाहिए? क्या मुझे 'देखना जारी रखें' सुविधा के लिए, हर 15 सेकंड में जानकारी अपडेट करनी चाहिए?

नहीं, बार-बार अपडेट करने का सुझाव नहीं दिया जाता. यहां इसकी वजह दी गई है:

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

'देखना जारी रखें' सेक्शन में मौजूद जानकारी को कब अपडेट किया जाता है:

उपयोगकर्ता की वीडियो देखने की प्रोग्रेस में हुए अहम बदलावों को कैप्चर करने पर फ़ोकस करें. यहां कुछ मुख्य स्थितियां दी गई हैं:

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

अपडेट करने का सही तरीका:

समय के हिसाब से अपडेट भेजने के बजाय, वीडियो प्लेयर या ऐप्लिकेशन के लाइफ़साइकल में मौजूद इवेंट का इस्तेमाल करके अपडेट ट्रिगर करें. उदाहरण के लिए:

  • onPause, onStop: जब वीडियो चलना रुक जाता है.
  • onAppClose, onAppBackgrounded: जब ऐप्लिकेशन बंद हो जाता है या बैकग्राउंड में चला जाता है.

इन दिशा-निर्देशों का पालन करके, संसाधनों का सही तरीके से इस्तेमाल किया जा सकता है. साथ ही, उपयोगकर्ताओं को 'देखना जारी रखें' सुविधा का बेहतर अनुभव दिया जा सकता है.