Bu kılavuzda, Yemek Siparişi teklifleriyle ilgili şartlar ve örnekler vurgulanmaktadır.
Uygunluk ve Politikalar
Bu bölümde, iş ortaklarının teklif sunarken uyması gereken önemli uygunluk ölçütleri vurgulanmaktadır. Korumalı alan feed'i testi sırasında kullanıma sunmayı planladığınız tüm teklif türlerini test etmeniz önemlidir. Bir teklifin uygun olup olmadığından emin değilseniz lütfen Google iletişim noktanızla iletişime geçin.
Kişiselleştirilmiş ve tek kullanımlık teklifleri hariç tutma
Yüksek kaliteli ve tutarlı bir kullanıcı deneyimi sağlamak için iş ortakları, kullanıcıların belirli alt kümeleriyle kısıtlanmış teklifler sunmamalıdır. Yalnızca belirli kullanıcılar için oluşturulan kişiselleştirilmiş teklifler uygun değildir. Teklifin tüm kullanıcılar için teklif açılış sayfasında gösterilmesi koşuluyla, ilk kez kullanan kullanıcılar veya belirli bir restoranda ilk kez sipariş verenler gibi tüm kullanıcılar için uygun olan platform genelindeki tekliflere izin verilir. Teklif koşulları, teklif başlığında ve teklif URL'si açılış sayfasında açıkça belirtilmelidir. Teklifler, sitenize veya uygulamanıza oturum açılmadığında ya da oturum açıldığında tüm kullanıcılar için teklif açılış sayfasında görünür olmalıdır.
Kupon kodlu teklifler
Bazı teklifler için kullanıcının kupon kodu girmesi gerekir. Örneğin, "Toplam faturada% 20 indirim almak için SAVE20 kodunu uygulayın". Google'ın kupon tanımındaki kupon kodlarını göstermediğini unutmayın. İş ortakları, bu bilgileri kullanıcılara gösterilecek OfferDetails.offer_display_text içine ekleyebilir. Kupon tabanlı teklifler genellikle iki kategoriye ayrılır:
- Google'dan gelen tüm kullanıcılara ödeme sırasında kuponun otomatik olarak sunulduğu tekliflere izin verilir.
- Kullanıcının ödeme sırasında kupon kodunu girmesini gerektiren ancak kupon kodunun teklif URL'si açılış sayfasına nasıl uygulanacağıyla ilgili talimatlar sağlamayan veya teklif URL'si takip edildiğinde kuponu otomatik olarak uygulamayan tekliflere izin verilmez.
İçerik ve Yapı Teklifi
Bu bölümde, yapılandırılmış meta verilerle ilgili örnekler de dahil olmak üzere feed'de sağlanan tekliflerin içeriği ve yapısıyla ilgili koşullar ayrıntılı olarak açıklanmaktadır.
Teklifin görüntülenecek metni ve teklif spesifikasyonu
OfferDetails.offer_display_text, Google Arama'daki teklifler bölümünde anında görünürlük için kısa başlık olarak kullanılan zorunlu bir alandır (ör. "10 TL indirim" veya "%15 tasarruf edin").
OfferDetails.offer_specification, OfferDetails içinde zorunlu bir "biri" alanıdır. Bu, anlaşmayı belirtmek için aşağıdaki üç alandan tam olarak birinin sağlanması gerektiği anlamına gelir:
discount_valuediscount_percentageother_offer_details_text
OfferDetails.other_offer_details_text alanı, teklif sabit bir indirim değeri veya yüzdesi olarak ifade edilemediğinde offer_display_text alanını tamamlamak için kullanılan serbest biçimli bir metin alanıdır. Teklifle ilgili gerekli tüm bilgileri aktarmak için offer_display_text alanı yeterliyse other_offer_details_text alanı, offer_display_text ile aynı metinle doldurulmalıdır. Ancak karmaşık fırsatlarda bu alan, ödülün ayrıntılı bir açıklamasını sağlamalıdır.
Yapılandırılmış meta veri alanları
Tekliflerin netliğini artırmak ve daha iyi sıralama ve filtreleme sağlamak için iş ortaklarının teklif meta verilerini ilgili yapılandırılmış alanlarda sağlaması gerekir. terms.terms_and_conditions alanı zorunludur. Değer, teklifin nasıl kullanılacağına ilişkin koşulları içermelidir. Örneğin, bu alanı teklif açılış sayfasında kullanıcılara gösterilen ayrıntılı şartlarla doldurabilirsiniz.
Öğelerin alt kümelerine özel tekliflerde, uygun öğeleri tanımlamak için terms.terms_and_conditions alanı veya offer_restrictions.inclusions ve offer_restrictions.exclusions alanları kullanılmalıdır.
Fırsat JSON örnekleri
20 ABD doları indirim
Örnek: Salı günleri minimum 15 ABD doları harcamada 20 ABD doları indirim
{ "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" }
Bir alana bir bedava teklifi
Örnek: Pazartesiden perşembeye geçerli olmak üzere bir meze alana bir bedava
{ "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" }
İndirim yüzdesi teklifi
Örnek: Tüm sandviçlerde% 25 indirim
{ "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 all Sandwiches", "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, "combinable_offer_ids": ["offer-example-4-delivery"], "inclusions": [ "Sandwiches" ] }, "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" }
Ücretsiz teslimat teklifi
Örnek: 30 ABD doları üzerindeki siparişlerde ücretsiz teslimat. Aksi takdirde teslimat ücreti 7,00 TL'dir.
{ "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" }
Eklenti teklifi içeren temel teklif örneği
Örnek: Bir restoran, hafta içi yalnızca öğle yemeğinde% 10 indirim ve belirli bir kredi kartıyla ödeme yapıldığında her zaman% 5 indirim sunuyor.
[ { "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" } ]
Sipariş karşılama ve kısıtlamalar
Bu bölümde, teklif karşılama spesifikasyonuyla ilgili koşullar ve en iyi uygulamalar ile bunlarla ilişkili kısıtlamalar ayrıntılı olarak açıklanmaktadır.
Sipariş karşılama modu (teslimat ve paket servis)
Tek bir fırsat hem teslimat hem de paket servis için geçerliyse feed'de iki teklif içermelidir. Her girişin özel bir ActionType'ı olmalıdır:
ACTION_TYPE_FOOD_DELIVERYACTION_TYPE_FOOD_TAKEOUT
Bu sayede, iş ortağı sitesine gelen kullanıcılara doğru karşılama bağlamı sunulur.
Zaman aralıkları
Tekliflerin, sitenize veya uygulamanıza giriş yapmamış ya da giriş yapmış tüm kullanıcılar için teklif açılış sayfasında gösterilmesi gerekir. Teklif belirli bir dönemde geçerliyse geçerli dönemi belirtmek için validity_periods.valid_period alanını eklemeniz gerekir. Bu, teklifin dönem dışında gösterilmesini önler. Teklif, günün belirli saatlerinde teklif URL'sinde gösteriliyorsa zaman aralığı da ayarlanmalıdır. Örneğin, restoran kapalıyken açılış sayfasında teklifler gösterilmiyorsa TimeOfDayWindow açık ve kapalı saatlerini eklemeniz gerekir.
Gece yarısını geçen zaman aralıklarını işleme
Gece yarısını kapsayan teklifler (ör. Salı günü saat 22:00'den Çarşamba günü saat 02:00'ye kadar geçerli) alım ardışık düzeni tarafından doğru şekilde işlenmek üzere segmentlere ayrılmalıdır. Şart: Pencereyi iki ayrı segmente ayırmak için TimeOfDayWindow alanını kullanın:
- 1.Segment: Başlangıç gününde (ör. Salı) 22:00 - 23:59:59 arası.
- 2. Segment: Ertesi gün (ör. Çarşamba) 00:00-02:00
Bu sayede teklifin geçerliliği, tüm dönem boyunca doğru şekilde yansıtılır.
Ücret spesifikasyonları
Teslimat ve paket servis ücretleri, OfferDetails.additional_fees alanı kullanılarak belirtilebilir. Özel ödeme yöntemi ücreti, OfferDetails.convenience_fee kullanılarak belirtilmelidir. Değişken ücretler için ücret aralığı değeri kullanın. Örneğin, teslimat ücretleri kullanıcının konumuna göre değişiyorsa.