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

}

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

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

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

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

सामान्य सवाल

Engage क्या है?

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

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

क्या Video Discovery API और Engage एक ही हैं?

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

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

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

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

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

Engage की सुविधा किन प्लैटफ़ॉर्म पर काम करती है?

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

क्या Engage SDK, 'देखना जारी रखें' सुविधा के लिए है?

हां, Engage SDK में 'देखना जारी रखें' लाइन के लिए कॉन्टेंट दिखाने की सुविधा उपलब्ध है. Engage के साथ इंटिग्रेट करना ज़रूरी है.

क्या Engage सभी के लिए उपलब्ध है?

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

  • सार्वजनिक तौर पर उपलब्ध होने से पहले इस्तेमाल: हम शुरुआत में, Early Access Program (EAP) के ज़रिए चुनिंदा पार्टनर को इस सुविधा का ऐक्सेस दे रहे हैं.
  • ज़्यादा लोगों तक पहुंच: हम Engage को जल्द ही सभी डेवलपर के लिए उपलब्ध कराने की कोशिश कर रहे हैं.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

लाइव दिखाए जा रहे वीडियो के लिए:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

क्या Engage को लागू करने के लिए, खाते को लिंक करना ज़रूरी है?

खाता लिंक करने की ज़रूरत नहीं है. इस एपीआई को अब प्राथमिकता नहीं दी जा रही है. इसके इस्तेमाल के सभी उदाहरणों को नए Device Entitlements API में शामिल किया जाएगा.

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

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

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

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

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

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

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

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

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

REST API का ईटीए मार्च 2025 है, इस बारे में Engage के डेवलपर दस्तावेज़ में बताया गया है.

'अगला वीडियो' फ़ीड से जुड़े लेगसी सवाल

क्या Engage, अगला वीडियो API की जगह ले रहा है?

Engage, Android TV के उन सभी डिवाइसों पर काम करेगा जो Watch Next API के साथ काम करते हैं. Google TV और Engage की सुविधा वाले अन्य प्लैटफ़ॉर्म पर इंटिग्रेट करने के लिए, डेवलपर को Engage SDK टूल का इस्तेमाल करना चाहिए.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

'देखना जारी रखें' लाइन के लिए, कॉन्टेंट की जानकारी कब अपडेट करनी चाहिए:

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

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

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

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

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

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