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 शेयर करने से पहले, यह देख लें कि वह सही है या नहीं.

डीप लिंक, पैकेज के नाम से जुड़े होते हैं. डीप लिंक की जांच करने का सबसे अच्छा तरीका, 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 SDK, वीडियो के मुकाबले ज़्यादा तरह की कॉन्टेंट एंटिटी टाइप के साथ काम करता है. इसलिए, अब इस इंटिग्रेशन को "वीडियो डिस्कवरी" नहीं कहा जाता.

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

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

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

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

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

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

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

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

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

'जुड़ें' टैब को चरणों में रोल आउट किया जा रहा है.

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

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

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

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

एपीआई के नए वर्शन में, 'देखना जारी रखें' रो में दिखने वाले कॉन्टेंट को बेहतर बनाया गया है. जैसे:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

क्या मेरे ऐप्लिकेशन में accountId और profileId, दोनों इस्तेमाल किए जा सकते हैं? अगर हां, तो क्या सिर्फ़ accountId के साथ AccountProfile का इस्तेमाल किया जा सकता है और 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 के कॉम्बिनेशन के हिसाब से, 'देखना जारी रखें' डेटा रिकॉर्ड करेगा. जिस Google डिवाइस पर उसी Google खाते से लॉग इन किया गया है उसे 'देखना जारी रखें' रो में, उसी accountId और profileId से जुड़ा सबसे नया अपडेट किया गया डेटा मिलेगा.

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

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

अलग-अलग डिवाइसों पर सिंक करने की सुविधा के बारे में सवाल

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

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

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

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

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

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

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

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

REST API के लिए ईटीए मार्च 2025 है. यह Engage Developer Docs में दिया गया है.

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

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

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

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

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

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

वहीं, 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 डेटा में, 3P account_1/profile_1 ने जो कॉन्टेंट देखा है वह दिख रहा है

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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