इंटिग्रेशन के लिए ज़रूरी शर्तें

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

इंटिग्रेशन शुरू करने से पहले, इंटिग्रेशन का तरीका और QA चेकलिस्ट को डाउनलोड करें. इससे, आपको Subscribe with Google (SwG) इंटिग्रेशन प्रोजेक्ट की प्रोसेस पूरी करने में मदद मिलेगी. इस चेकलिस्ट में, SwG के सभी कॉम्पोनेंट और टास्क के बारे में ब्रेकडाउन के साथ ज़्यादा जानकारी मौजूद होती है. इसमें ऐसे टास्क भी होते हैं जिनसे पब्लिशर, SwG इंटिग्रेशन की प्रोसेस के दौरान, कभी भी रेफ़रंस ले सकते हैं.

खास जानकारी

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

  1. Google Play डेवलपर खाता: पब्लिशर को Google Play डेवलपर खाता बनाना होगा, किसी ऐप्लिकेशन को अपलोड करना होगा, और उस ऐप्लिकेशन पर बिलिंग की सुविधा चालू करनी होगी. पब्लिशर को यह ऐप्लिकेशन प्रोडक्शन के दौरान पब्लिश करना होगा या प्रोडक्शन के लिए पहले से मौजूद ऐप्लिकेशन का इस्तेमाल करना होगा.
  2. पब्लिकेशन का कॉन्फ़िगरेशन: पब्लिशर को तकनीकी समस्याएं हल करने वाले Google के प्रतिनिधियों के साथ काम करना होगा. इससे, कॉन्फ़िगरेशन के चुनिंदा पॉइंट सेट अप किए जा सकेंगे. इन आइटम में, ज़रूरी एपीआई एंडपॉइंट के यूआरएल, लोगो/ब्रैंडिंग के एसेट, SKU का ब्यौरा, निजता नीति का यूआरएल, और इसी तरह की अन्य जानकारी शामिल होती है. इंटिग्रेशन सेट अप करने के लिए, Google को इस जानकारी की ज़रूरत पड़ती है. इंटिग्रेट किए गए हर पब्लिकेशन के लिए, पब्लिशर को यह कॉन्फ़िगरेशन सेट करना होगा.
  3. पेज मार्कअप: पब्लिशर को लेख के सभी पेजों पर स्ट्रक्चर्ड डेटा जोड़ना होगा. इस डेटा में, एक पब्लिकेशन आईडी (पब्लिकेशन के कॉन्फ़िगरेशन में मौजूद आईडी से मेल खाने वाला) और एक एनटाइटलमेंट लेबल शामिल होता है. यह डेटा, एएमपी दस्तावेज़ों सहित, लेख के सभी पेजों पर मौजूद होना चाहिए.
  4. SwG.js क्लाइंट इंटिग्रेशन: पब्लिशर को अपने पब्लिकेशन की वेबसाइट में, Google JavaScript क्लाइंट को इंटिग्रेट करना होगा. पब्लिशर को लेख के ऐसे सभी पेजों पर SwG.js क्लाइंट लाइब्रेरी शामिल करनी होगी जहां paywall ट्रिगर किया जा सकता है. इसमें, वे लेख भी शामिल हैं जिन पर सर्वर-साइड का paywall लागू किया गया है. पब्लिशर को SwG.js getEntitlements फ़ंक्शन को भी कॉल करना होगा और उस फ़ंक्शन से मिलने वाले रिस्पॉन्स सही तरीके से मैनेज करने होंगे.

    अगर पब्लिशर अपने पेजों के एएमपी वर्शन बनाएं और ये एएमपी पेज paywall को ट्रिगर कर सकते हों, तो एएमपी पेजों को AMP-subscriptions-google के लिए कॉन्फ़िगर किया जाना चाहिए. ऐसा इसलिए, ताकि SwG के उपयोगकर्ता के एनटाइटलमेंट को सही तरीके से लागू किया जा सके.

  5. Android इंटिग्रेशन: अगर पब्लिशर, वेब और Android पर SKU के अलग-अलग सेट बेचता है या उसके पास एक ही पब्लिकेशन के लिए कई ऐप्लिकेशन हैं, तो उसे सदस्यता की खरीदारी की जांच के लिए, अपने Android ऐप्लिकेशन अपडेट करने होंगे. साथ ही, Subscribe with Google पब्लिकेशन एपीआई को कॉल करके, सही तरीके से ऐक्सेस देना होगा.
  6. Google से साइन इन करें / Google साइन इन: पब्लिशर को वेब के सभी लॉगिन पेजों पर, 'Google से साइन इन करें' विकल्प और सभी iOS और Android ऐप्लिकेशन के लिए, 'Google साइन इन' का विकल्प शामिल करना होगा.

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

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

  7. खरीदारी के बाद खाता बनाने वाला हैंडलर: लोग जैसे ही खरीदारी पूरी करें, पब्लिशर को उनके लिए खाता ज़रूर बनाना चाहिए.

    वेब पर, पब्लिशर के पास ऐसी सुविधा होनी चाहिए जिससे वह swg.js सदस्यता के इवेंट और एनटाइटलमेंट के डेटा को, पब्लिशर के इंफ़्रास्ट्रक्चर के पास वापस भेज सके. Android इन-ऐप बिलिंग से की जाने वाली खरीदारी के लिए, पब्लिशर को अपनी वेबसाइट पर SwG.js के ज़रिए, डेफ़र्ड या स्थगित खाता बनाने वाले फ़्लो का इस्तेमाल करना चाहिए. जिस समय उन खरीदारी से जुड़े उपयोगकर्ता, पब्लिशर की वेबसाइट पर आएं, उसी समय पब्लिशर को इस फ़्लो का इस्तेमाल करना चाहिए.

    एएमपी पर की जाने वाली खरीदारी के लिए अगर कोई पब्लिशर, एएमपी पर खरीदारी का फ़्लो लागू कर रहा है, तो उसे पब्लिशर इंफ़्रास्ट्रक्चर में Play Cloud Pub/Sub इवेंट की सदस्यता लेनी होगी.

    Google की सदस्यता की स्थिति एपीआई से, सदस्यता का डेटा और उपयोगकर्ता की प्रोफ़ाइल की जानकारी मांगने के लिए, पब्लिशर को सदस्यता के इवेंट से मिले खरीदारी के डेटा का इस्तेमाल करना होगा. वह डेटा मिलने के बाद, Account Management API को इनमें से कोई एक काम करना होगा:

    1. उसे Google से मिली उपयोगकर्ता की प्रोफ़ाइल की जानकारी का इस्तेमाल करके, एक खाता बनाना होगा और उस खाते में सदस्यता को जोड़ना होगा या
    2. उसे पब्लिशर की साइट पर पहले से मौजूद उपयोगकर्ता खाते में, Google उपयोगकर्ता के प्रोफ़ाइल की जानकारी और सदस्यता का डेटा जोड़ना होगा.

    हो सकता है कि पब्लिशर के पास कोई यूज़र मैनेजमेंट सिस्टम न हो. यानी कि वह उपयोगकर्ता से जुड़े लेन-देन को मैनेज करने के लिए पूरी तरह से Subscribe with Google पर निर्भर हो. ऐसे में, खरीदारी के बाद खाता बनाने की ज़रूरत नहीं पड़ती या खाता बनाना संभव नहीं होता.

  8. OAuth खाता जोड़ने का पेज: इस प्रोसेस को आसान बनाने के लिए, पब्लिशर को OAuth लॉगिन पेज बनाना होगा:

    1. पब्लिशर के मौजूदा उपयोगकर्ताओं की पुष्टि करना
    2. उपयोगकर्ता के एनटाइटलमेंट की जांच करना
    3. उपयोगकर्ता के लिए ऐक्सेस टोकन बनाना
    4. ऐक्सेस टोकन को वापस रेफ़रिंग पेज पर रीडायरेक्ट करना और पास करना

    हो सकता है कि पब्लिशर के पास यूज़र मैनेजमेंट सिस्टम न हो. यानी कि वह उपयोगकर्ता से जुड़े लेन-देन को मैनेज करने के लिए पूरी तरह से Subscribe with Google पर निर्भर हो. ऐसे में, OAuth खाता जोड़ने का पेज बनाने की ज़रूरत नहीं पड़ती या यह पेज बनाना संभव नहीं होता.

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

    हो सकता है कि पब्लिशर के पास यूज़र मैनेजमेंट सिस्टम न हो. यानी कि वह उपयोगकर्ता से जुड़े लेन-देन को मैनेज करने के लिए पूरी तरह से Subscribe with Google पर निर्भर हो. ऐसे में, एनटाइटलमेंट एपीआई के इस्तेमाल की ज़रूरत नहीं पड़ती या ऐसा करना संभव नहीं होता.

  10. ऑटो-लॉगिन की सूचना: अगर Google Entitlements API किसी ऐसे उपयोगकर्ता का एनटाइटलमेंट दिखाता है जिसे पब्लिशर पहले से जानता है, लेकिन फ़िलहाल उपयोगकर्ता ने पब्लिशर के सिस्टम में लॉग इन नहीं किया है, तो हम पब्लिशर को यह सलाह देते हैं कि वह अपनी साइट पर, उपयोगकर्ता को उसके खाते में अपने-आप लॉगिन होने दें. उपयोगकर्ता को इस इवेंट के बारे में सूचना देने या उपयोगकर्ता से अपने-आप लॉगिन होने की कार्रवाई की सहमति लेने के लिए, पब्लिशर SwG.js ऑटो-लॉगिन फ़ंक्शन का इस्तेमाल कर सकता है.
  11. iOS इंटिग्रेशन: अगर पब्लिशर ने किसी iOS ऐप्लिकेशन में, Subscribe with Google की SKU से जुड़े किसी कॉन्टेंट को paywall किया है, तो उसे पहले 'Google साइन इन' का इस्तेमाल करना होगा. इसके बाद, पब्लिशर को यह देखना होगा कि एनटाइटलमेंट के लिए बैकएंड मौजूद है या नहीं. Paywall किए गए कॉन्टेंट को ऐक्सेस करने की अनुमति सिर्फ़ तब दी जानी चाहिए, जब कोई बैकएंड मौजूद हो. कोई बैकएंड मौजूद न होने पर, पब्लिशर को एनटाइटलमेंट की जांच के लिए, Subscribe with Google पब्लिकेशन एपीआई को कॉल करना होगा.
  12. सदस्यताएं सेव करना: पब्लिशर को ऐसे सभी परचेज़ फ़्लो के आखिर में 'सदस्यता सेव करें' सुविधा इंटिग्रेट करनी होगी जो Subscribe with Google से नहीं जुड़ी हैं. इससे, उपयोगकर्ताओं को अपना Google खाता जोड़ने का विकल्प मिल सकेगा.