उपहार कार्ड (वाउचर भी कहा जाता है)

इस गाइड में, ऑफ़र वाले फ़ीड में उपहार कार्ड (जिन्हें वाउचर भी कहा जाता है) जोड़ने के लिए ज़रूरी शर्तें, डेटा मॉडलिंग के सुझाव, और सबसे सही तरीके बताए गए हैं. ये सुझाव, Actions Center के स्टैंडर्ड दस्तावेज़ के साथ-साथ, उपहार कार्ड से जुड़े इंटिग्रेशन के पहलुओं के बारे में भी जानकारी देते हैं.

ऑफ़र मोड और कैटगरी तय करना

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

  • ऑफ़र मोड: offer_modes को हमेशा एक सिंगलटन ऐरे के तौर पर सेट किया जाना चाहिए जिसमें "OFFER_MODE_GIFT_CARD_PURCHASE" शामिल होना चाहिए:

    "offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]

  • स्टोर की वैल्यू वाले वाउचर बनाम स्टोर पर जाकर तुरंत मिलने वाली छूट:

    • gift_card_info को सिर्फ़ पहले से खरीदे गए स्टोर की वैल्यू वाले वाउचर और उपहार कार्ड (OFFER_MODE_GIFT_CARD_PURCHASE) के लिए रिज़र्व किया जाता है.
    • अगर कोई ग्राहक, वाउचर कोड खरीदे बिना, तुरंत छूट पाने के लिए, सीधे फ़िज़िकल स्टोर के काउंटर पर पेमेंट करता है, तो ऑफ़र को स्टोर पर जाकर तुरंत मिलने वाली छूट (OFFER_MODE_WALK_IN) के तौर पर मॉडल करें. साथ ही, gift_card_info मैसेज को पूरी तरह से हटा दें.

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

  • कई डिनॉमिनेशन को एक साथ दिखाना: एक ही छूट प्रतिशत और शर्तों वाले, लेकिन अलग-अलग फ़ेस वैल्यू वाले कई वाउचर को, ऑफ़र की एक ही एंट्री में ग्रुप किया जाना चाहिए. denomination_type एक oneof के तौर पर काम करता है. इसलिए, पार्टनर को fixed_denominations या custom_range में से किसी एक को सेट करना होगा:

    • निश्चित डिनॉमिनेशन: इसका इस्तेमाल तब करें, जब उपहार कार्ड की पहले से तय की गई अलग-अलग रकम ऑफ़र की जाती हैं.जैसे, ₹500, ₹1,000, और ₹2,000. इन सभी पर 10% की छूट मिलती है. पक्का करें कि लैंडिंग पेज पर, बिक चुके या उपलब्ध नहीं किसी भी तय डिनॉमिनेशन को, फ़ीड सबमिशन से साफ़ तौर पर बाहर रखा जाए.
    • पसंद के मुताबिक रेंज: इसका इस्तेमाल सिर्फ़ तब करें, जब उपयोगकर्ता खरीदारी वाले पेज पर, तय की गई सीमाओं के अंदर, अपनी पसंद के मुताबिक कोई भी फ़ेस वैल्यू डाल सकते हैं. जैसे, 5% की छूट के साथ ₹100 से ₹5,000 के बीच की कोई भी वैल्यू. अगर डेस्टिनेशन लैंडिंग पेज पर, पहले से तय की गई अलग-अलग रकम ऑफ़र की जाती हैं, तो इन्वेंट्री को सिर्फ़ fixed_denominations के तहत मॉडल करें. इसके अलावा, अगर किसी ऑफ़र के लिए, तय डिनॉमिनेशन और पसंद के मुताबिक डिनॉमिनेशन, दोनों उपलब्ध हैं, तो पार्टनर को पसंद के मुताबिक रेंज सेट करनी चाहिए.

कई जगहों पर मौजूद चेन को मैनेज करना

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

पोर्टल की ब्रैंडिंग (brand_id)

कुछ वाउचर, मुख्य व्यापारी की साइट के बजाय, खास बैंक या लॉयल्टी पोर्टल (जैसे, बैंक लॉयल्टी प्रोग्राम या पार्टनर प्लैटफ़ॉर्म) के ज़रिए ऑफ़र किए जाते हैं. इन पोर्टलों के लिए सटीक ब्रैंडिंग पक्का करने के लिए, पार्टनर को टॉप-लेवल के ऑफ़र ऑब्जेक्ट पर, brand_id फ़ील्ड में जानकारी भरनी होगी.

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

वैलिडिटी स्ट्रक्चर (ValidityScope)

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

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

कार्रवाई के टाइप की मैपिंग

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

  • डाइनिंग / फ़ूड वर्टिकल: "डाइन-इन" उपहार कार्ड को ACTION_TYPE_DINING से मैप करें. "डिलीवरी" उपहार कार्ड को ACTION_TYPE_FOOD_DELIVERY से मैप करें. "टेकआउट" उपहार कार्ड को ACTION_TYPE_FOOD_TAKEOUT से मैप करें.
  • शॉपिंग रिटेल वर्टिकल: "स्टोर में" उपहार कार्ड को ACTION_TYPE_SHOPPING_IN_STORE से मैप करें. (ध्यान दें: सिर्फ़ ऑनलाइन रिडीम किए जा सकने वाले रिटेल वाउचर काम नहीं करते).
  • सिंगल चैनल मैपिंग: हर offer_id सिर्फ़ एक ActionType से जुड़ा हो सकता है. अगर कोई इन्वेंट्री आइटम, डिलीवरी के कई चैनलों के साथ काम करता है (जैसे, फ़ूड डिलीवरी और टेकआउट, दोनों), तो हर मोड के लिए, अलग-अलग आईडी वाले ऑफ़र ऑब्जेक्ट बनाएं.

छूट के अलग-अलग लेवल और ऐड-ऑन ऑफ़र

  • पेमेंट के अलग-अलग तरीकों पर छूट के अलग-अलग लेवल: अगर इस्तेमाल किए गए पेमेंट करने के तरीके के आधार पर, छूट के अलग-अलग प्रतिशत ऑफ़र किए जाते हैं (जैसे, क्रेडिट कार्ड के मुकाबले ई-वॉलेट के लिए ज़्यादा छूट), तो इन्हें ऑफ़र के अलग-अलग ऑब्जेक्ट के तौर पर मॉडल किया जाना चाहिए. पार्टनर को, पेमेंट के सभी तरीकों (जैसे, ई-वॉलेट, क्रेडिट कार्ड, डेबिट कार्ड, नेट बैंकिंग) के लिए, प्रमोशन की पूरी जानकारी देनी चाहिए, ताकि बचत का भरोसेमंद अनुभव मिल सके. अगर कोई ऑफ़र, प्लैटफ़ॉर्म पर स्वीकार किए जाने वाले पेमेंट के सभी तरीकों पर लागू होता है, तो पेमेंट करने का तरीका वाला फ़ील्ड सेट नहीं किया जाना चाहिए.
  • ऐड-ऑन ऑफ़र कंस्ट्रक्ट: एक साथ कई फ़ायदे दिखाने के लिए, जैसे कि बैंक के खास रिवॉर्ड पॉइंट या उपहार कार्ड की खरीदारी पर मिलने वाला अतिरिक्त कैशबैक, इन्हें ऐड-ऑन ऑफ़र के तौर पर सबमिट करें. इसके लिए, उपयुक्त OfferCategory enum - OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER का इस्तेमाल करें. OfferDetails.other_offer_details_text में रिवॉर्ड के बारे में बताएं.जैसे, "पांच गुना तक रिवॉर्ड पॉइंट" और इसे उपहार कार्ड की मुख्य डील से लिंक करें. इसके लिए, OfferRestrictions.combinable_offer_ids में, उपहार कार्ड की मुख्य डील की offer_id डालें.

नियम और खास शर्तें

पार्टनर को, उपहार कार्ड या वाउचर के सभी कानूनी नियम और शर्तें देने के लिए, terms.terms_and_conditions का इस्तेमाल करना चाहिए. उपयोगकर्ताओं के लिए सभी निर्देश और इस्तेमाल के दिशा-निर्देश, इस फ़ील्ड में शामिल करें.

अगर ज़रूरी पाबंदियों के लिए, यूज़र इंटरफ़ेस (यूआई) पर खास तौर पर जानकारी दिखानी है, तो उन्हें offer_restrictions.special_conditions में हाइलाइट करें. जैसे, एक बार इस्तेमाल किया जा सकने वाले बैलेंस की समयसीमा खत्म होना, रिफ़ंड न मिलना या लेन-देन को एक साथ करने की सीमाएं. उदाहरण के लिए, "हर बिल के लिए, ज़्यादा से ज़्यादा दो वाउचर इस्तेमाल किए जा सकते हैं".

ऑफ़र के टाइटल के लिए सुझाव

ऑफ़र के टाइटल की लंबाई, 40 वर्णों से ज़्यादा नहीं होनी चाहिए. offer_display_text से, व्यापारी के ब्रैंड के नाम हटाएं, क्योंकि ऑफ़र सीधे व्यापारी के खास प्लेस शीट पर दिखते हैं. हम टाइटल के इन फ़ॉर्मैट का सुझाव देते हैं:

इस्तेमाल का उदाहरण सुझाया गया टाइटल
वाउचर पर तय छूट X% off on Gift Cards
पेमेंट के तरीके के आधार पर अलग-अलग छूट X% off on Gift Cards using {e-wallet}
अलग-अलग डिनॉमिनेशन पर अलग-अलग छूट X% off on Gift Cards (अलग-अलग छूट को, ऑफ़र के तौर पर अलग-अलग भेजें)
B2B2C उपहार कार्ड X% off on Gift Cards (ब्रैंडिंग brand_id का इस्तेमाल करके थंबनेल के ज़रिए दिखाई जाती है)
ऐड-ऑन ऑफ़र Flat/Up to 5X reward points/ <Platform> coins

लैंडिंग पेज से जुड़ी ज़रूरी शर्त

विज्ञापन में दिखाए गए हर offer_url से, सीधे एचटीटीपी 200 ओके मिलना चाहिए. साथ ही, यह किसी इंटरमीडियरी पर रीडायरेक्ट नहीं होना चाहिए. इसके अलावा, यह ऑफ़र की पुष्टि करने वाले, चालू डेस्टिनेशन पेज पर खुलना चाहिए.

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

डेस्टिनेशन लैंडिंग पेज पर यह साफ़ तौर पर बताया जाना चाहिए कि ऑफ़र, सिर्फ़ उपहार कार्ड या वाउचर पर लागू होता है.

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

कूपन कोड वाले ऑफ़र

कुछ ऑफ़र के लिए, उपयोगकर्ता को कूपन कोड डालना पड़ता है. जैसे, "कुल बिल पर 20% की छूट पाने के लिए, SAVE20 कोड लागू करें". ध्यान दें कि Google, कूपन की परिभाषा से कूपन कोड नहीं दिखाता. पार्टनर, उपयोगकर्ताओं को दिखाने के लिए, यह जानकारी OfferDetails.offer_display_text में शामिल कर सकते हैं. कूपन पर आधारित ऑफ़र आम तौर पर दो कैटगरी में आते हैं:

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

उपहार कार्ड के ऑफ़र के JSON का उदाहरण

{
  "data": [
    {
      "offer_id": "example-dining-gift-card-10off",
      "entity_ids": [
        "dining-1",
        "dining-2"
      ],
      "offer_modes": [
        "OFFER_MODE_GIFT_CARD_PURCHASE"
      ],
      "action_type": "ACTION_TYPE_DINING",
      "offer_source": "OFFER_SOURCE_AGGREGATOR",
      "offer_category": "OFFER_CATEGORY_BASE_OFFER",
      "offer_details": {
        "offer_display_text": "10% off on Gift Cards",
        "discount_percent": 10.0,
        "gift_card_info": {
          "fixed_denominations": {
            "amounts": [
              {
                "units": 500,
                "currency_code": "INR"
              },
              {
                "units": 1000,
                "currency_code": "INR"
              },
              {
                "units": 2000,
                "currency_code": "INR"
              }
            ]
          }
        }
      },
      "offer_restrictions": {
        "combinable_with_other_offers": false,
        "special_conditions": [
          "Single-use balance expiration applies",
          "Maximum 2 gift card vouchers can be combined per bill",
          "No cash refund will be provided against this voucher"
        ]
      },
      "terms": {
        "restricted_to_certain_users": false,
        "terms_and_conditions": "1. Redeemable exclusively at participating dining outlets.\n2. Single-use balance expiration applies.\n3. Maximum 2 gift card vouchers can be combined per bill.\n4. No cash refund will be provided against this voucher."
      },
      "validity_periods": [
        {
          "valid_period": {
            "valid_from_time": {
              "seconds": "1774934350"
            },
            "valid_through_time": {
              "seconds": "1806470350"
            }
          },
          "validity_scope": "VALIDITY_SCOPE_CLAIM"
        },
        {
          "validity_duration_in_days": 365,
          "validity_scope": "VALIDITY_SCOPE_REDEEM"
        }
      ],
      "offer_url": "https://www.example-portal.com/dining-gift-cards/buy"
    }
  ]
}