इस गाइड में, खाना ऑर्डर करने की सुविधा देने वाले ऑफ़र की ज़रूरी शर्तों और उदाहरणों के बारे में बताया गया है.
ज़रूरी शर्तें और नीतियां
इस सेक्शन में, ज़रूरी शर्तों के बारे में बताया गया है. पार्टनर को ऑफ़र देते समय, इन शर्तों का पालन करना होगा. सैंडबॉक्स फ़ीड की टेस्टिंग के दौरान, आपको सभी तरह के ऑफ़र टेस्ट करने चाहिए. अगर आपको यह नहीं पता कि कोई ऑफ़र ज़रूरी शर्तें पूरी करता है या नहीं, तो कृपया अपने Google पीओसी से संपर्क करें.
मनमुताबिक बनाए गए और एक बार इस्तेमाल किए जा सकने वाले ऑफ़र शामिल न करें
उपयोगकर्ताओं को बेहतर और एक जैसा अनुभव देने के लिए, पार्टनर को ऐसे ऑफ़र शामिल नहीं करने चाहिए जो उपयोगकर्ताओं के किसी खास सबसेट के लिए प्रतिबंधित हों. सिर्फ़ कुछ उपयोगकर्ताओं के लिए बनाए गए, उनकी दिलचस्पी के हिसाब से तैयार किए गए ऑफ़र मान्य नहीं हैं. ऐसे ऑफ़र दिखाए जा सकते हैं जो सभी उपयोगकर्ताओं के लिए उपलब्ध हों. जैसे, पहली बार खरीदारी करने वाले उपयोगकर्ता या किसी खास रेस्टोरेंट से पहली बार ऑर्डर करने वाले उपयोगकर्ता. हालांकि, यह ज़रूरी है कि ऑफ़र, सभी उपयोगकर्ताओं के लिए ऑफ़र के लैंडिंग पेज पर दिखे. ऑफ़र की शर्तों के बारे में, ऑफ़र के टाइटल और ऑफ़र के यूआरएल के लैंडिंग पेज पर साफ़ तौर पर बताया जाना चाहिए. ऑफ़र, सभी उपयोगकर्ताओं को ऑफ़र के लैंडिंग पेज पर दिखने चाहिए. भले ही, उन्होंने आपकी साइट या ऐप्लिकेशन में लॉग-इन किया हो या नहीं.
कूपन कोड वाले ऑफ़र
कुछ ऑफ़र के लिए, उपयोगकर्ता को कूपन कोड डालना होता है. जैसे, "कुल बिल पर 20% की छूट पाने के लिए, SAVE20 कोड लागू करें". ध्यान दें कि Google, coupon की परिभाषा से मिले कूपन कोड नहीं दिखाता. पार्टनर, इस जानकारी को OfferDetails.offer_display_text में शामिल कर सकते हैं, ताकि इसे उपयोगकर्ताओं को दिखाया जा सके. कूपन पर आधारित ऑफ़र आम तौर पर दो कैटगरी में आते हैं:
- ऐसे ऑफ़र जिनमें Google से आने वाले किसी भी उपयोगकर्ता को चेकआउट के समय कूपन अपने-आप दिख जाता है. इनकी अनुमति है.
- ऐसे ऑफ़र की अनुमति नहीं है जिनमें लोगों को चेकआउट के दौरान कूपन कोड डालना होता है, लेकिन ऑफ़र के यूआरएल के लैंडिंग पेज पर कूपन कोड लागू करने के तरीके के बारे में निर्देश नहीं दिए जाते. इसके अलावा, ऐसे ऑफ़र की भी अनुमति नहीं है जिनमें ऑफ़र के यूआरएल पर जाने के बाद, कूपन अपने-आप लागू नहीं होता.
ऑफ़र का कॉन्टेंट और स्ट्रक्चर
इस सेक्शन में, फ़ीड में दिए गए ऑफ़र के कॉन्टेंट और स्ट्रक्चर से जुड़ी ज़रूरी शर्तों के बारे में बताया गया है. इसमें स्ट्रक्चर्ड मेटाडेटा के उदाहरण भी शामिल हैं.
ऑफ़र का डिसप्ले टेक्स्ट और ऑफ़र की जानकारी
OfferDetails.offer_display_text एक ज़रूरी फ़ील्ड है. यह Google Search पर ऑफ़र सेक्शन में तुरंत दिखने वाली छोटी हेडलाइन के तौर पर काम करता है. जैसे, "1000 रुपये की छूट" या "15% की बचत करें".
OfferDetails.offer_specification, OfferDetails में ज़रूरी "one of" फ़ील्ड है. इसका मतलब है कि डील की जानकारी देने के लिए, इन तीन फ़ील्ड में से सिर्फ़ एक फ़ील्ड की वैल्यू देनी होगी:
discount_valuediscount_percentageother_offer_details_text
OfferDetails.other_offer_details_text फ़ील्ड, फ़्री-फ़ॉर्म टेक्स्ट फ़ील्ड है. इसका इस्तेमाल offer_display_text की जानकारी को पूरा करने के लिए किया जाता है. ऐसा तब किया जाता है, जब ऑफ़र को छूट की तय वैल्यू या प्रतिशत के तौर पर नहीं दिखाया जा सकता. अगर offer_display_text फ़ील्ड में दी गई जानकारी से ही ऑफ़र के बारे में सारी ज़रूरी जानकारी मिल जाती है, तो other_offer_details_text फ़ील्ड में वही टेक्स्ट डालें जो offer_display_text फ़ील्ड में डाला गया है. हालांकि, मुश्किल डील के लिए, इस फ़ील्ड में इनाम के बारे में पूरी जानकारी दी जानी चाहिए.
स्ट्रक्चर्ड मेटाडेटा फ़ील्ड
ऑफ़र के बारे में साफ़ तौर पर जानकारी देने के लिए, पार्टनर को स्ट्रक्चर्ड फ़ील्ड में ऑफ़र का मेटाडेटा देना होगा. इससे, ऑफ़र को बेहतर तरीके से रैंक करने और फ़िल्टर करने में मदद मिलेगी. terms.terms_and_conditions फ़ील्ड की जानकारी देना ज़रूरी है. इस वैल्यू में, ऑफ़र रिडीम करने से जुड़ी शर्तें शामिल होनी चाहिए. उदाहरण के लिए, इस फ़ील्ड में उन शर्तों के बारे में पूरी जानकारी दी जा सकती है जो उपयोगकर्ताओं को ऑफ़र के लैंडिंग पेज पर दिखती हैं.
ऑफ़र के 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" }
एक खरीदें एक मुफ़्त पाएं ऑफ़र
उदाहरण: एक ऐपेटाइज़र खरीदने पर एक मुफ़्त पाएं. यह ऑफ़र सोमवार से गुरुवार तक मान्य है
{ "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" }
छूट के प्रतिशत वाला ऑफ़र
उदाहरण: सैंडविच पर 25% की छूट
{ "offer_id": "offer-example-3-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": "25% off on Sandwitches", "discount_percent": 25.0 }, "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": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Applies to specific items only. Single use per order. May be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_2" }
मुफ़्त डिलीवरी का ऑफ़र
उदाहरण: 3,000 रुपये से ज़्यादा के ऑर्डर पर मुफ़्त डिलीवरी. अन्यथा, डिलीवरी के लिए 700 रुपये चुकाने होंगे.
{ "offer_id": "offer-example-4-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": "Free delivery on orders over $30", "discount_value": { "currency_code": "USD", "units": 7 }, "min_spend_value": { "currency_code": "USD", "units": 30 } }, "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": "For use only at the participating restaurant location on qualifying delivery orders with $30 minimum spend. Delivery is $7.00 otherwise. Single use per order. May be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_3" }
ऐडऑन ऑफ़र के साथ बुनियादी ऑफ़र का उदाहरण
उदाहरण: कोई रेस्टोरेंट, हफ़्ते के कामकाजी दिनों में सिर्फ़ दोपहर के खाने पर 10% की छूट देता है. साथ ही, किसी खास क्रेडिट कार्ड से पेमेंट करने पर, किसी भी समय 5% की छूट देता है.
[ { "offer_id": "offerId1", "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": "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_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER", "offer_details": { "offer_display_text": "5% off", "discount_percent": 5.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_ids": ["offerId1"] }, "payment_instrument": { "items": [ { "type": "PAYMENT_INSTRUMENT_CREDIT_CARD", "name": "Participating Credit Card" } ], "provider_name": "Card Provider" }, "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/addon_offer_1" } ]
ऑर्डर पूरा करना और पाबंदियां
इस सेक्शन में, ऑफ़र पूरा करने की खास जानकारी और उससे जुड़ी पाबंदियों के बारे में बताया गया है. साथ ही, इससे जुड़ी ज़रूरी शर्तों और सबसे सही तरीकों के बारे में भी बताया गया है.
फ़ुलफ़िलमेंट मोड (डिलीवरी और टेकआउट)
अगर कोई एक डील, डिलीवरी और टेकआउट, दोनों पर लागू होती है, तो फ़ीड में उसके लिए दो ऑफ़र होने चाहिए. हर एंट्री में, ActionType के लिए एक खास वैल्यू होनी चाहिए:
ACTION_TYPE_FOOD_DELIVERYACTION_TYPE_FOOD_TAKEOUT
इससे यह पक्का होता है कि पार्टनर की साइट पर आने वाले उपयोगकर्ताओं को, बुकिंग पूरी करने से जुड़ी सही जानकारी दिखाई जाए.
टाइम विंडो
जब उपयोगकर्ता आपकी साइट या ऐप्लिकेशन में लॉग-इन या लॉग-आउट करते हैं, तब सभी उपयोगकर्ताओं को ऑफ़र लैंडिंग पेज पर ऑफ़र दिखने चाहिए. अगर ऑफ़र किसी तय समयावधि के दौरान मान्य है, तो आपको validity_periods.valid_period फ़ील्ड शामिल करना होगा, ताकि मान्य समयावधि के बारे में बताया जा सके. इससे, ऑफ़र को तय समयसीमा के बाहर नहीं दिखाया जाता. अगर ऑफ़र को दिन के कुछ घंटों के दौरान ऑफ़र यूआरएल पर दिखाया जाता है, तो समयसीमा भी सेट करनी होगी. उदाहरण के लिए, अगर रेस्टोरेंट बंद होने पर लैंडिंग पेज पर ऑफ़र नहीं दिखते हैं, तो आपको TimeOfDayWindow में रेस्टोरेंट के खुलने और बंद होने का समय शामिल करना होगा.
आधी रात के बाद के समय को मैनेज करना
आधी रात तक चलने वाले ऑफ़र (जैसे, मंगलवार रात 10:00 बजे से बुधवार सुबह 2:00 बजे तक मान्य) को सेगमेंट में बांटा जाना चाहिए, ताकि उन्हें डेटा इंटेक पाइपलाइन सही तरीके से प्रोसेस कर सके. ज़रूरी जानकारी: TimeOfDayWindow फ़ील्ड का इस्तेमाल करके, विंडो को दो अलग-अलग सेगमेंट में बांटें:
- पहला सेगमेंट: शुरू होने वाले दिन (जैसे, मंगलवार) को रात 10:00 बजे से रात 11:59:59 बजे तक.
- दूसरा सेगमेंट: अगले दिन (जैसे, बुधवार) सुबह 12 बजे से सुबह 2 बजे तक.
इससे यह पक्का किया जा सकता है कि ऑफ़र की वैधता की जानकारी, पूरे समय के दौरान सटीक तरीके से दिखे.
शुल्क की जानकारी
डिलीवरी और टेकआउट के लिए खरीदार से लिए जाने वाले शुल्क की जानकारी, OfferDetails.additional_fees फ़ील्ड का इस्तेमाल करके दी जा सकती है. सुविधा शुल्क की जानकारी देने के लिए, OfferDetails.convenience_fee का इस्तेमाल करें. बदलते हुए शुल्क के लिए, शुल्क की सीमा वाली वैल्यू का इस्तेमाल करें. उदाहरण के लिए, अगर उपयोगकर्ता की जगह के हिसाब से डिलीवरी शुल्क बदलता है.