ज़्यादा फ़ायदा देने वाले अवसर

बैकग्राउंड

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

सुविधा का उदाहरण

वैल्यू ऑपर्च्यूनिटी मॉड्यूल का एक उदाहरण वैल्यू ऑपर्च्यूनिटी मॉड्यूल की सूची का उदाहरण
सिंगल व्यू सूची के तौर पर देखें

इस गाइड में यह माना गया है कि आपको Google Wallet के बुनियादी सिद्धांतों के बारे में जानकारी है. साथ ही, आपने सुझाई गई ज़रूरी शर्तें पहले ही पूरी कर ली हैं. अपने किसी भी सवाल, सुझाव, राय या शिकायत को Google Wallet पीओसी को भेजें.

इंटिग्रेशन का तरीका

नया मॉड्यूल जोड़ने के लिए, आपको ऑब्जेक्ट और/या क्लास को अपडेट करना होगा, ताकि उसमें ValueAddedModuleData शामिल हो. ValueAddedModuleData में ये फ़ील्ड शामिल हैं:

[ज़रूरी है] LocalizedString header

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

LocalizedString body

मॉड्यूल पर दिखने वाला मुख्य कॉन्टेंट. वर्ण सीमा 50 है. इससे ज़्यादा वर्ण होने पर बाकी वर्ण अपने-आप हटा दिए जाएंगे.
वैल्यू ऑपर्च्यूनिटी बॉडी का उदाहरण

इमेज इमेज

मॉड्यूल पर दिखने वाली इमेज. इमेज का सुझाया गया रेशियो 1:1 है. इस रेशियो के हिसाब से इमेज का साइज़ बदल दिया जाएगा.
वैल्यू ऑपर्च्यूनिटी इमेज का उदाहरण

[ज़रूरी है] स्ट्रिंग यूआरआई

वह यूआरआई जिस पर क्लिक करने से मॉड्यूल खुलता है. यह कोई वेब लिंक या डीप लिंक हो सकता है.

ModuleViewConstraints viewConstraints

ये ऐसी शर्तें होती हैं जिन्हें पूरा करने पर ही मॉड्यूल दिखाया जाता है. ModuleViewConstraints में यह फ़ील्ड होता है:

TimeInterval displayInterval

वह समयावधि जिसके दौरान उपयोगकर्ताओं को मॉड्यूल दिखेगा. `startTime` और `endTime`, दोनों को तय किया जा सकता है. अगर `startTime` सेट नहीं किया जाता है, तो मॉड्यूल को तुरंत दिखाया जाता है. अगर `endTime` सेट नहीं किया जाता है, तो मॉड्यूल हमेशा दिखता रहेगा.

int32 sortIndex

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

ValueAddedModuleData का उदाहरण:

  {
    "valueAddedModuleData": [
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off merch"
          }
        },
        "body": {
          "defaultValue": {
            "language": "en-US",
            "value": "Shirts, caps, mugs, and more"
          }
        },
        "image": {
          "sourceUri": {
            "uri": "http://www.images.google.com/opportunity"
          }
        },
        "uri": "http://www.google.com/opportunity",
        "viewConstraints": {
          "displayInterval": {
            "start": {
              "date": "2024-08-01T18:30:00"
            },
            "end": {
              "date": "2025-08-01T18:30:00"
            }
          }
        },
        "sortIndex": 0
      },
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off concessions"
          }
        },
        "uri": "http://www.google.com/new_opportunity"
      }
    ]
  }

अनुमानित व्यवहार

ऑब्जेक्ट और/या क्लास को अपडेट करने के बाद, आपको पास पर मॉड्यूल दिखेंगे. अगर आपने सिर्फ़ एक मॉड्यूल जोड़ा है, तो आपको पास के सामने की ओर वह मॉड्यूल दिखेगा.

वैल्यू ऐडेड अपॉर्च्यूनिटी मॉड्यूल के बारे में दिशा-निर्देश

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

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

अपवादों को मैनेज करना

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