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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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

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

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

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

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

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

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

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

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

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));
...

}

वर्कफ़्लो के बारे में अक्सर पूछे जाने वाले सवाल

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

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

डीप लिंक, पैकेज के नाम से जुड़े होते हैं. डीप लिंक की जांच करने का एक अच्छा तरीका, 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 क्या है?

वीडियो देखना जारी रखें 2.0 (वीडियो डिस्कवरी एपीआई), "जहां से छोड़ा था वहीं से शुरू करें" सुविधा को अगले लेवल पर ले जाता है! यह एक अहम अपग्रेड है. इसकी मदद से, दर्शक आसानी से कई तरह के डिवाइसों पर, वीडियो देखना जारी रख सकते हैं. कल्पना करें कि आपने Google TV पर कोई फ़िल्म देखना शुरू किया है और अब आपको घर से ऑफ़िस जाने के दौरान, फ़िल्म को फ़ोन पर देखना है. ऐसा करने के लिए, आपको कुछ भी करने की ज़रूरत नहीं है. यह सुविधा, 'देखना जारी रखें' 2.0 की मदद से मिलती है.

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

'वीडियो देखना जारी रखें' 2.0 का इस्तेमाल करने के क्या फ़ायदे हैं?

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

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

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

'वीडियो देखना जारी रखें' 2.0 की सुविधा किन प्लैटफ़ॉर्म पर काम करती है?

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

क्या 'वीडियो देखना जारी रखें' 2.0 के लिए Engage SDK टूल उपलब्ध है?

हां, Engage SDK टूल, 'वीडियो देखना जारी रखें' 2.0 के लिए है. इसे 'वीडियो देखना जारी रखें' 2.0 के साथ इंटिग्रेट करना ज़रूरी है.

क्या 'देखना जारी रखें' 2.0 की सुविधा सभी के लिए उपलब्ध है?

'वीडियो देखना जारी रखें' 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 के अन्य मीडिया ऐप्लिकेशन और प्लैटफ़ॉर्म. इससे, सभी डिवाइसों पर उपयोगकर्ताओं की दिलचस्पी बढ़ती है.

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

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

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

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

इकाइयों की संख्या की सीमा क्यों है?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• वीडियो चलाने की सटीक जगह: टीवी शो के एपिसोड की तरह ही, पक्का करें कि वीडियो को आखिरी बार चलाने की जगह सही हो.

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

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

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

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

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

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

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

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

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

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

क्या मेरे पास सिर्फ़ accountId के साथ AccountProfile का इस्तेमाल करने का विकल्प है, भले ही मेरा ऐप्लिकेशन accountId और profileId, दोनों के साथ काम करता हो?

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

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

क्या 'वीडियो देखना जारी रखें' 2.0 के लिए profileId ज़रूरी है?

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

Google, अपनी तरफ़ से profileId का इस्तेमाल कैसे करता है?

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

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

खाता लिंक करने की ज़रूरत नहीं है. इसे प्राथमिकता नहीं दी जा रही है. इसके इस्तेमाल से जुड़े सभी उदाहरणों को नए डिवाइस एनटाइटलमेंट एपीआई में शामिल किया जाएगा.

सभी डिवाइसों पर सिंक करने के बारे में सवाल

जब उपयोगकर्ता सहमति देते हैं, तो "सभी डिवाइसों पर सिंक करें" का क्या मतलब है?

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

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

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

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

Android के अलावा किसी दूसरे ऑपरेटिंग सिस्टम पर, वीडियो देखने का इतिहास शेयर करने के लिए उपयोगकर्ता की सहमति कैसे ली जाती है

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

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

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

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

REST API के लिए, मार्च 2025 तक रिलीज़ होने का अनुमान है. इसकी जानकारी, 'वीडियो देखना जारी रखें' 2.0 के डेवलपर दस्तावेज़ों में दी गई है.

'अगला वीडियो देखें' सेक्शन के लिए, लेगसी वर्शन में पूछे जाने वाले सवाल

क्या वीडियो डिस्कवरी एपीआई, वॉच नेक्स्ट एपीआई की जगह ले रहा है?

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

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

LastPlayBackPositionTimeMillis और duration के बीच क्या अंतर है?

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

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

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

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

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

14. पहला उदाहरण: TV1: Google खाता: माँ, तीसरे पक्ष का खाता / प्रोफ़ाइल: खाता 1 / profile_1. कॉन्टेंट देखें और पुष्टि करें कि सीडब्ल्यू डेटा में, तीसरे पक्ष के account_1/profile_1 से देखे गए कॉन्टेंट की जानकारी दिख रही है

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

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

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

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

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

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

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

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

'देखना जारी रखें' सुविधा की जानकारी कब अपडेट करें:

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

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

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

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

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

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