इस गाइड में, खाना ऑर्डर करने की सुविधा से जुड़े ऑफ़र की ज़रूरी शर्तों और उदाहरणों के बारे में बताया गया है.
ज़रूरी शर्तें और नीतियां
इस सेक्शन में, ज़रूरी शर्तों के बारे में बताया गया है. पार्टनर को ऑफ़र देते समय, इन शर्तों का पालन करना होगा. सैंडबॉक्स फ़ीड की टेस्टिंग के दौरान, लॉन्च किए जाने वाले सभी तरह के ऑफ़र की टेस्टिंग करना ज़रूरी है. अगर आपको यह पक्का नहीं है कि कोई ऑफ़र ज़रूरी शर्तों को पूरा करता है या नहीं, तो कृपया Google के अपने प्रतिनिधि से संपर्क करें.
आपके हिसाब से बनाए गए और एक बार इस्तेमाल किए जा सकने वाले ऑफ़र शामिल न करें
पार्टनर को उपयोगकर्ताओं को बेहतर और एक जैसा अनुभव देना होगा. इसके लिए, उन्हें ऐसे ऑफ़र शामिल नहीं करने चाहिए जो सिर्फ़ कुछ उपयोगकर्ताओं के लिए उपलब्ध हों. सिर्फ़ कुछ उपयोगकर्ताओं के लिए बनाए गए, आपके हिसाब से ऑफ़र ज़रूरी शर्तों को पूरा नहीं करते. प्लेटफ़ॉर्म पर सभी उपयोगकर्ताओं के लिए उपलब्ध ऑफ़र, जैसे कि पहली बार इस्तेमाल करने वाले उपयोगकर्ताओं या किसी खास रेस्टोरेंट से पहली बार ऑर्डर करने वाले उपयोगकर्ताओं के लिए उपलब्ध ऑफ़र शामिल किए जा सकते हैं. हालांकि, यह ज़रूरी है कि ऑफ़र के लैंडिंग पेज पर, सभी उपयोगकर्ताओं के लिए ऑफ़र दिखाया जाए. ऑफ़र की शर्तों के बारे में, ऑफ़र के टाइटल और ऑफ़र के यूआरएल के लैंडिंग पेज पर साफ़ तौर पर बताया जाना चाहिए. आपकी साइट या ऐप्लिकेशन में लॉग-इन या लॉग-आउट करने पर, सभी उपयोगकर्ताओं को ऑफ़र के लैंडिंग पेज पर ऑफ़र दिखने चाहिए.
कूपन कोड वाले ऑफ़र
कुछ ऑफ़र के लिए, उपयोगकर्ता को कूपन कोड डालना पड़ता है. जैसे, "कुल बिल पर 20% की छूट पाने के लिए, SAVE20 कोड लागू करें". ध्यान दें कि Google, कूपन की परिभाषा में दिए गए कूपन कोड नहीं दिखाता. पार्टनर, उपयोगकर्ताओं को दिखाने के लिए, यह जानकारी OfferDetails.offer_display_text में शामिल कर सकते हैं. कूपन पर आधारित ऑफ़र आम तौर पर दो कैटगरी में आते हैं:
- ऐसे ऑफ़र जिनमें Google से आने वाले किसी भी उपयोगकर्ता को चेकआउट के दौरान, कूपन अपने-आप दिख जाता है. इन ऑफ़र को शामिल किया जा सकता है.
- ऐसे ऑफ़र जिनमें उपयोगकर्ता को चेकआउट के दौरान, कूपन कोड डालना पड़ता है. हालांकि, इनमें ऑफ़र के यूआरएल के लैंडिंग पेज पर, कूपन कोड लागू करने के तरीके के बारे में निर्देश नहीं दिए जाते. इसके अलावा, ऑफ़र के यूआरएल पर जाने पर, कूपन अपने-आप लागू नहीं होता. ऐसे ऑफ़र शामिल नहीं किए जा सकते.
ऑफ़र का कॉन्टेंट और स्ट्रक्चर
इस सेक्शन में, फ़ीड में दिए गए ऑफ़र के कॉन्टेंट और स्ट्रक्चर की ज़रूरी शर्तों के बारे में बताया गया है. इसमें स्ट्रक्चर्ड मेटाडेटा के उदाहरण भी शामिल हैं.
ऑफ़र दिखाने वाला टेक्स्ट और ऑफ़र की खास जानकारी
OfferDetails.offer_display_text एक ज़रूरी फ़ील्ड है. यह Google Search पर ऑफ़र वाले सेक्शन में, तुरंत दिखने वाली संक्षिप्त हेडलाइन के तौर पर काम करता है. जैसे, "1,000 रुपये की छूट" या "15% की बचत करें".
OfferDetails.offer_specification, OfferDetails में "इनमें से कोई एक" फ़ील्ड है. इसे भरना
ज़रूरी है. इसका मतलब है कि डील की जानकारी देने के लिए, इन तीन फ़ील्ड में से सिर्फ़ एक फ़ील्ड की वैल्यू सबमिट करनी होगी:
discount_valuediscount_percentother_offer_detail_text
OfferDetails.other_offer_detail_text
टेक्स्ट वाला एक फ़ील्ड है. इसका इस्तेमाल, offer_display_text
के साथ किया जाता है. ऐसा तब किया जाता है, जब ऑफ़र को छूट की वैल्यू या प्रतिशत के तौर पर नहीं दिखाया जा सकता. अगर offer_display_text में ऑफ़र के बारे में सभी ज़रूरी जानकारी पहले से मौजूद है, तो other_offer_detail_text फ़ील्ड में वही टेक्स्ट होना चाहिए जो offer_display_text में है. हालांकि, जटिल डील के लिए, इस फ़ील्ड में इनाम के बारे में खास जानकारी दी जानी चाहिए.
स्ट्रक्चर्ड मेटाडेटा फ़ील्ड
ऑफ़र के बारे में ज़्यादा जानकारी देने और बेहतर रैंकिंग और फ़िल्टरिंग के लिए, पार्टनर को ऑफ़र का मेटाडेटा, स्ट्रक्चर्ड फ़ील्ड में देना होगा. शर्तों के बारे में जानकारी देना ज़रूरी है. हमारा सुझाव है कि terms.terms_and_conditions फ़ील्ड में, ऑफ़र के लैंडिंग पेज पर उपयोगकर्ताओं को दिखने वाली शर्तों के बारे में पूरी जानकारी दें.
पूरे ऑर्डर और आइटम के हिसाब से ऑफ़र
आइटम के सबसेट के लिए खास ऑफ़र में, ज़रूरी आइटम की जानकारी देने के लिए,
offer_restrictions.inclusions
और
offer_restrictions.exclusions
फ़ील्ड का इस्तेमाल करना होगा. अगर ऑफ़र किसी खास आइटम के लिए है, तो आइटम का नाम offer_display_text में शामिल किया जाना चाहिए. जब आइटम का नाम offer_display_text में शामिल किया जाता है, तब offer_restrictions.inclusions को सेट करना ज़रूरी नहीं होता.
अगर offer_restrictions.inclusions सेट नहीं किया जाता है या आइटम का नाम offer_display_text में शामिल नहीं किया जाता है, तो माना जाता है कि ऑफ़र, ऑर्डर की कुल रकम पर लागू होता है.
डिलीवरी शुल्क वाले ऑफ़र
डिलीवरी शुल्क वाले ऑफ़र के लिए, offer_category
OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER का इस्तेमाल करना होगा. इससे ऑफ़र सिर्फ़ तब दिखेगा, जब इसे जगह के लिए किसी अन्य मुख्य ऑफ़र के साथ जोड़ा जाएगा. डिलीवरी शुल्क वाला ऑफ़र, मुख्य ऑफ़र के तौर पर नहीं दिखेगा.
ऑफ़र के JSON उदाहरण
2,000 रुपये की छूट
उदाहरण: मंगलवार को 1,500 रुपये से ज़्यादा के ऑर्डर पर 2,000 रुपये की छूट
{ "offer_id": "offer-example-1-takeout", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "$20 off on Tuesdays", "discount_value": { "currency_code": "USD", "units": 20 }, "min_spend_value": { "currency_code": "USD", "units": 15 } }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "time_windows": { "open_time": { "hours": 9 }, "close_time": { "hours": 20, "minutes": 59, "seconds": 59 } }, "day_of_week": ["TUESDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": false }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders with $15 minimum spend. Single use per order. Offer may not be combined with any other offers, discounts, or promotions. Valid only on Tuesdays." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_1" }
बेरी स्मूदी पर 50% की छूट
उदाहरण: आइटम के लेवल पर 50% की छूट.
{ "offer_id": "offer-example-1-takeout", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "50% off on Berry Smoothie", "discount_percent": 50.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true, "inclusions": [ {"description":"Berry Smoothie"} ] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_1" }
एक खरीदें एक मुफ़्त पाएं ऑफ़र
उदाहरण: सोमवार से गुरुवार तक, एक ऐपेटाइज़र खरीदें और एक मुफ़्त पाएं
{ "offer_id": "offer-example-2-delivery", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "Buy one appetizer, get one free", "other_offer_detail_text": "Buy one appetizer, get one free" }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "time_windows": { "open_time": { "hours": 10 }, "close_time": { "hours": 23, "minutes": 59, "seconds": 59 } }, "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": true, "inclusions": [ { "description": "appetizers" } ] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Valid on all menu appetizers. Offer may be combined with any other offers, discounts, or promotions. Valid Monday through Thursday." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_4" }
मुफ़्त डिलीवरी का ऑफ़र
उदाहरण: मुख्य ऑफ़र के साथ, ऐड-ऑन के तौर पर मुफ़्त डिलीवरी. डिलीवरी शुल्क के तौर पर 0 रुपये वाला ऑफ़र, जगह के लिए किसी भी मुख्य ऑफ़र के साथ दिखेगा.
[ { "offer_id": "offerId1", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "10% off", "discount_percent": 10.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": true, "combinable_offer_categories": ["OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER"] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_5" }, { "offer_id": "offerId2", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER", "offer_details": { "offer_display_text": "$0 Delivery Fee", "other_offer_detail_text": "Free dellivery" }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true }, "terms": { "terms_and_conditions": "Delivery is free at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/addon_offer_1" } ]
ज़रूरी शर्तें और पाबंदियां
इस सेक्शन में, ऑफ़र को पूरा करने की खास जानकारी और उससे जुड़ी ज़रूरी शर्तों और पाबंदियों के बारे में बताया गया है. इसमें सबसे सही तरीके भी शामिल हैं.
ऑफ़र पूरा करने का मोड (डिलीवरी और टेकआउट)
अगर कोई एक डील, डिलीवरी और टेकआउट दोनों पर लागू होती है, तो फ़ीड में उसके लिए दो ऑफ़र होने चाहिए. हर एंट्री में, ActionType होना चाहिए:
ACTION_TYPE_FOOD_DELIVERYACTION_TYPE_FOOD_TAKEOUT
इससे यह पक्का होता है कि पार्टनर की साइट पर आने वाले उपयोगकर्ताओं को, ऑफ़र पूरा करने के सही संदर्भ के बारे में जानकारी मिले.
टाइम विंडो
उम्मीद की जाती है कि आपकी साइट या ऐप्लिकेशन में लॉग-इन या लॉग-आउट करने पर, सभी उपयोगकर्ताओं को ऑफ़र के लैंडिंग पेज पर ऑफ़र दिखेंगे. अगर ऑफ़र किसी खास समयावधि के दौरान मान्य है, तो आपको validity_periods.valid_period फ़ील्ड में, मान्य अवधि की जानकारी देनी होगी. इससे ऑफ़र, समयावधि के बाहर नहीं दिखेगा. अगर ऑफ़र, दिन के कुछ घंटों के दौरान ऑफ़र के यूआरएल पर दिखता है, तो टाइम विंडो भी सेट करनी होगी. उदाहरण के लिए, अगर रेस्टोरेंट बंद होने पर लैंडिंग पेज पर ऑफ़र नहीं दिखते हैं, तो आपको TimeOfDayWindow में खुलने और बंद होने के समय की जानकारी देनी होगी.
आधी रात के बाद भी मान्य ऑफ़र को मैनेज करना
आधी रात के बाद भी मान्य ऑफ़र (उदाहरण के लिए, मंगलवार रात 10 बजे से बुधवार सुबह 2 बजे तक मान्य) को, इनजेशन पाइपलाइन से सही तरीके से प्रोसेस करने के लिए, सेगमेंट में बांटना होगा. ज़रूरी शर्त: टाइम विंडो को दो अलग-अलग सेगमेंट में बांटने के लिए, TimeOfDayWindow फ़ील्ड का इस्तेमाल करें:
- पहला सेगमेंट: शुरू होने वाले दिन (उदाहरण के लिए, मंगलवार) रात 10 बजे से 11:59:59 तक.
- दूसरा सेगमेंट: अगले दिन (उदाहरण के लिए, बुधवार) सुबह 12 बजे से 2 बजे तक.
इससे यह पक्का होता है कि ऑफ़र की वैधता, पूरी अवधि के दौरान सटीक तरीके से दिखे.
शुल्क की खास जानकारी
डिलीवरी और टेकआउट के लिए शुल्क की जानकारी, OfferDetails.additional_fees फ़ील्ड का इस्तेमाल करके दी जा सकती है. सुविधा शुल्क की जानकारी, OfferDetails.convenience_fee का इस्तेमाल करके दी जानी चाहिए. बदलाव वाले शुल्क के लिए, शुल्क की रेंज की वैल्यू का इस्तेमाल करें. उदाहरण के लिए, अगर उपयोगकर्ता की जगह के हिसाब से डिलीवरी शुल्क बदलता है.