ข้อเสนอ
การผสานรวมข้อเสนอช่วยให้คุณส่งต่อข้อมูลที่มีโครงสร้างเกี่ยวกับโปรโมชันและส่วนลดของผู้ขายที่ใช้กับบริการที่เฉพาะเจาะจงในช่วงเวลาที่เฉพาะเจาะจงได้ ข้อเสนอ ประกอบด้วยข้อเสนอจริง (ส่วนลดเป็นเปอร์เซ็นต์ ส่วนลดเป็นดอลลาร์ ฯลฯ) ช่วงเวลาที่ข้อเสนอใช้ได้ (เวลาที่เฉพาะเจาะจง วันของสัปดาห์ ฯลฯ) และการใช้งานที่เกี่ยวข้อง (ข้อเสนอใช้ได้กับบริการบางอย่างเท่านั้น) รวมถึงการผสมผสานข้อจำกัดที่ซับซ้อน
ตัวอย่างข้อเสนอ
- ลดราคาอาหารเรียกน้ำย่อยครึ่งราคาในวันพุธและวันพฤหัสบดีในเดือนธันวาคมตั้งแต่เวลา 12:00 น. ถึง 17:00 น.
- ซื้อ 1 แถม 1 สำหรับของหวานในมื้อค่ำวันแม่ตั้งแต่เวลา 18:00 น. ถึง 22:00 น.
- รับส่วนลด $5 สำหรับอาหารจานหลักของบรันช์ทุกวันอาทิตย์ตั้งแต่เวลา 10:00 น. ถึง 14:00 น.
- ส่วนลด 10% สำหรับข้อเสนอแบบวอล์กอินที่ใช้ร่วมกับส่วนลด 5% สำหรับสมาชิก Premium และ ส่วนลด 5% หากผู้ใช้ชำระเงินผ่านแอปของคุณ
หากต้องการให้ข้อเสนอรวมอยู่ในการผสานรวม ข้อเสนอจะต้องอยู่ใน โมเดลข้อมูลทางเทคนิคและเป็นไปตามข้อกำหนดของการได้รับสิทธิ์ของเรา อย่าลืมอ่านนโยบายข้อเสนอ เพื่อให้แน่ใจว่าการผสานรวมเป็นไปตามข้อกำหนดและดูวิธีการ เกี่ยวกับสิ่งที่ต้องทำกับข้อเสนอที่ไม่เป็นไปตามข้อกำหนดทางเทคนิค
การติดตั้งใช้งานข้อเสนอ
การผสานรวมข้อเสนอประกอบด้วยฟีด 2 รายการที่จะอัปโหลดทุกวันหรือที่ความถี่ที่รับประกันความแม่นยำสูง (หมายถึงลดความล้าสมัย) ดังนี้
- อย่างใดอย่างหนึ่ง
- ฟีดผู้ขาย
(ใช้การกำหนดค่า
Merchant) - หรือ
ฟีดเอนทิตี
(ใช้การกำหนดค่า
Generic)
- ฟีดผู้ขาย
(ใช้การกำหนดค่า
- และ
ฟีดข้อเสนอ
(ใช้การกำหนดค่า
Generic)
OfferFeed
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
data | อาร์เรย์ของออบเจ็กต์(Offer) |
ข้อเสนอ
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
offer_id | สตริง | ต้องระบุ | รหัสที่ไม่ซ้ำกันของข้อเสนอ ต้องระบุ |
entity_ids | อาร์เรย์ของสตริง | รายชื่อผู้ขายที่เข้าร่วมข้อเสนอนี้ | |
add_on_offer_applicable_to_all_entities | บูลีน | หากเป็นจริง ข้อเสนอนี้จะมีผลกับทุกเอนทิตีภายใต้ผู้รวบรวม ใช้ได้กับข้อเสนอส่วนเสริมเท่านั้น | |
offer_source | enum(OfferSource) | ต้องระบุ | ข้อเสนออาจมาจากผู้รวบรวมข้อมูล ผู้ขายรายบุคคล หรือแม้แต่บุคคลที่สามในรูปแบบส่วนเสริม ต้องระบุ |
action_type | enum(ActionType) | ต้องระบุ | บริการที่ให้ข้อเสนอ offer_id จะเป็นของ action_type ได้เพียงรายการเดียวเท่านั้น หากแชร์ข้อเสนอในบริการหลายประเภทได้ คุณจะต้องสร้างข้อเสนอที่ซ้ำกันโดยมีรหัสที่ไม่ซ้ำกันสำหรับบริการแต่ละประเภท ต้องระบุ |
offer_modes | อาร์เรย์ของ enum(OfferMode) | ต้องระบุ | วิธีการใช้ข้อเสนอ - วอล์กอิน การจอง ออนไลน์ ฯลฯ ต้องระบุ |
offer_category | enum(OfferCategory) | ต้องระบุ | หมวดหมู่ของข้อเสนอ ต้องระบุ |
source_assigned_priority | ตัวเลข | จำนวนเต็มที่ไม่เป็นลบ ([1-100] โดยที่ 1 หมายถึงลำดับความสำคัญสูงสุด) ซึ่งระบุระดับลำดับความสำคัญของข้อเสนอที่แหล่งที่มากำหนด เมื่อมีข้อเสนอหลายรายการสำหรับผู้ขายรายเดียวกัน ข้อเสนอนี้จะเป็นสัญญาณ สำหรับการจัดอันดับข้อเสนอ 0 หมายความว่าไม่ได้ตั้งค่าลำดับความสำคัญ | |
offer_details | object(OfferDetails) | ต้องระบุ | รายละเอียดของข้อเสนอ เช่น ส่วนลด ค่าใช้จ่ายในการจอง ฯลฯ ต้องระบุ |
offer_restrictions | object(OfferRestrictions) | ต้องระบุ | อธิบายว่าข้อเสนอมีข้อจำกัดอย่างไร เช่น ต้องมีการสมัครใช้บริการ/เครื่องมือชำระเงินหรือไม่ ข้อเสนอนี้ใช้ร่วมกับข้อเสนออื่นๆ ได้หรือไม่ (และใช้ร่วมกับข้อเสนอประเภทใดได้) ต้องระบุ |
coupon | object(Coupon) | รายละเอียดของคูปอง ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER | |
payment_instrument | object(PaymentInstrument) | รายละเอียดของเครื่องมือการชำระเงิน ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER | |
subscription | object(Subscription) | รายละเอียดการสมัครใช้บริการ ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER | |
terms | object(Terms) | ต้องระบุ | ข้อกำหนดและเงื่อนไขของข้อเสนอ ต้องระบุ |
validity_periods | อาร์เรย์ของออบเจ็กต์(ValidityPeriod) | ต้องระบุ | ระยะเวลาที่ข้อเสนอใช้งานได้ อธิบายระยะเวลาที่ข้อเสนอใช้ได้ รวมถึงเวลาเริ่มต้นและสิ้นสุด วันในสัปดาห์ ฯลฯ ต้องระบุ |
offer_url | สตริง | URL ไปยังหน้าข้อเสนอของผู้ขาย ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_BASE_OFFER | |
tags | อาร์เรย์ของ enum(OfferTag) | แท็กพิเศษที่เชื่อมโยงกับข้อเสนอ ใช้เพื่อระบุข้อเสนอพิเศษ เช่น "เทศกาล" "ได้รับคะแนนสูงสุด" "จองมากที่สุด" ฯลฯ | |
brand_id | สตริง | ต้องระบุสำหรับดีลบัตรของขวัญเพื่อระบุแบรนด์ที่เสนอดีล | |
availability_level | enum(AvailabilityLevel) | ระดับความพร้อมใช้งานของข้อเสนอ |
OfferDetails
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
offer_display_text | สตริง | ต้องระบุ | ข้อความข้อเสนอที่ผู้ให้บริการข้อเสนอต้องการแสดงต่อลูกค้าในหน้าผลการค้นหา โปรดทราบว่าข้อความนี้อาจไม่ตรงกับที่แสดงต่อผู้ใช้ และเราอาจใช้ข้อมูลเมตาอื่นๆ เพื่อเขียน/เรียบเรียงใหม่ ต้องระบุ |
| oneOf(offer_specification) | ต้องระบุ | ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้ |
max_discount_value | object(Money) | ส่วนลดสูงสุดที่ใช้ได้ เช่น ลด 10% สูงสุด 1, 000 บาท | |
min_spend_value | object(Money) | มูลค่าการใช้จ่ายขั้นต่ำเพื่อรับส่วนลด เช่น รับส่วนลด 10% เมื่อราคารวมเป็น $100 ขึ้นไป | |
booking_cost | object(Money) | ค่าใช้จ่ายในการจองข้อเสนอนี้ เช่น ส่วนลด 3, 000 บาทจากบิลสุดท้ายเมื่อจองโต๊ะในราคา 450 บาท | |
booking_cost_unit | enum(FeeUnit) | หน่วยของค่าใช้จ่ายในการจอง เช่น ต่อคน ต่อธุรกรรม | |
convenience_fee | object(Fee) | ||
booking_cost_adjustable | บูลีน | ระบุว่าต้นทุนการจองปรับได้หรือไม่ เช่น ต้นทุนการจองจะหักออกจากใบเรียกเก็บเงินสุดท้าย เช่น ลด 30% สำหรับอาหารค่ำเมื่อจอง ค่าใช้จ่ายในการจองคือ $15 และระบบจะ นำไปใช้กับการเรียกเก็บเงินขั้นสุดท้าย ดังนั้นค่าใช้จ่ายสุดท้ายคือ ค่าใช้จ่ายทั้งหมด - 30% - $15 | |
additional_fees | อาร์เรย์ของออบเจ็กต์(AdditionalFee) | ค่าธรรมเนียมเพิ่มเติมที่เรียกเก็บจากผู้ใช้ ตัวอย่าง: ค่าธรรมเนียมความสะดวก ค่าธรรมเนียมการจัดการ ค่าธรรมเนียมการนำส่ง ค่าธรรมเนียมการบรรจุภัณฑ์ ค่าบริการ ฯลฯ | |
offer_discount_type | enum(OfferDiscountType) | ประเภทส่วนลด | |
gift_card_info | object(GiftCardInfo) | รายละเอียดสำหรับดีลบัตรของขวัญโดยเฉพาะ |
เงินทอง
แสดงจำนวนเงินพร้อมประเภทสกุลเงิน
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
currency_code | สตริง | รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217 | |
units | ตัวเลข | หน่วยเต็มของจำนวนเงิน
เช่น หาก currencyCode คือ "USD" หน่วย 1 หน่วยจะเท่ากับ 1 ดอลลาร์สหรัฐ | |
nanos | ตัวเลข | จำนวนหน่วยนาโน (10^-9) ของจำนวนเงิน
ค่าต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 รวมสองค่านี้ด้วย
หาก units เป็นบวก nanos ต้องเป็นบวกหรือ 0
หาก units เป็น 0 nanos จะเป็นค่าบวก 0 หรือค่าลบก็ได้
หาก units ติดลบ nanos ต้องติดลบหรือเป็น 0
เช่น $-1.75 จะแสดงเป็น units=-1 และ nanos=-750,000,000 |
ค่าธรรมเนียม
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
unit | enum(FeeUnit) | ||
type | enum(FeeType) | ||
| oneOf(cost) | ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้ |
MoneyRange
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
min_amount | object(Money) | ||
max_amount | object(Money) |
AdditionalFee
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
name | สตริง | ต้องระบุ | ชื่อของค่าธรรมเนียมเพิ่มเติม ตัวอย่าง: ค่าธรรมเนียมเพิ่มเติม ค่าธรรมเนียมการจัดการ ฯลฯ ต้องระบุ |
fee | object(Fee) |
GiftCardInfo
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
| oneOf(denomination_type) | ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้ |
FixedDenominations
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
amounts | อาร์เรย์ของออบเจ็กต์(Money) | รายการมูลค่าที่แยกกันทั้งหมดที่ใช้ได้ (เช่น [100, 500, 1000]) |
OfferRestrictions
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
combinable_with_other_offers | บูลีน | ข้อเสนอนี้ใช้ร่วมกับข้อเสนออื่นๆ ได้หรือไม่ เมื่อเป็นจริง พาร์ทเนอร์จะระบุได้ว่าข้อเสนอนี้ใช้ร่วมกับข้อเสนอใดได้ หากตั้งค่าทั้ง combinable_offer_categories และ combinable_offer_ids ข้อเสนอที่ตรงกับเงื่อนไขใดเงื่อนไขหนึ่งข้างต้นจะใช้ร่วมกันได้ | |
combinable_offer_categories | อาร์เรย์ของ enum(OfferCategory) | รายการประเภทข้อเสนอที่ใช้ร่วมกับข้อเสนอนี้ได้ เช่น ข้อเสนอนี้ อาจใช้ร่วมกับคูปองอื่นๆ ได้ หาก combinable_with_other_offers เป็นจริงและไม่ได้ตั้งค่าช่องนี้ ระบบจะรวมข้อเสนอทุกประเภทได้ | |
combinable_offer_ids | อาร์เรย์ของสตริง | รายการ offer_ids ที่ข้อเสนอนี้ใช้ร่วมได้ ข้อเสนอบางรายการอาจใช้ร่วมกับ other_id อื่นๆ ที่เฉพาะเจาะจงบางรายการเท่านั้น (ถือเป็นข้อเสนอหลักได้) หาก combinable_with_other_offers เป็นจริงและไม่ได้ตั้งค่าฟิลด์นี้ ระบบจะใช้รหัสข้อเสนอทั้งหมดร่วมกันได้ | |
inclusions | อาร์เรย์ของออบเจ็กต์(OfferCondition) | รายการเงื่อนไขที่ต้องเป็นไปตามข้อเสนอจึงจะใช้ได้ (เช่น เครื่องดื่มที่ไม่มีแอลกอฮอล์ อาหาร) | |
exclusions | อาร์เรย์ของออบเจ็กต์(OfferCondition) | รายการเงื่อนไขที่ทำให้ข้อเสนอไม่ถูกต้อง (เช่น บุฟเฟต์ ข้อเสนอแบบคอมโบ และค็อกเทล) | |
min_guest | ตัวเลข | จำนวนคนขั้นต่ำที่ต้องใช้เพื่อรับข้อเสนอ หมายเหตุ: ฟิลด์นี้ใช้ได้กับการจองร้านอาหารเท่านั้น และไม่ควรใช้กับอุตสาหกรรมอื่นๆ | |
food_offer_restrictions | object(FoodOfferRestrictions) | ข้อจำกัดที่เฉพาะเจาะจงสำหรับข้อเสนออาหาร | |
max_redemption_count | ตัวเลข | ข้อจำกัดเฉพาะเกี่ยวกับจำนวนครั้งที่ใช้ข้อเสนอนี้ได้ ค่า 0 จะระบุว่าไม่มีขีดจำกัด เช่น ค่า 3 หมายความว่าผู้ใช้ใช้ข้อเสนอนี้ได้ 3 ครั้ง | |
max_total_discount_value | object(Money) | ส่วนลดสูงสุดที่ใช้ได้ในการทำธุรกรรมหลายรายการของข้อเสนอนี้ | |
special_conditions | อาร์เรย์ของสตริง | เงื่อนไขพิเศษสำหรับข้อเสนอนี้ที่ต้องแสดงต่อผู้ใช้ ตัวอย่าง: "ใช้ได้กับการชำระเงินใน [พื้นที่] เท่านั้น", "ไม่รวมการชำระเงินออนไลน์", "ใช้บัตรกำนัลได้ในช่วงลดราคา" |
OfferCondition
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
description | สตริง |
FoodOfferRestrictions
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
meal_types | อาร์เรย์ของ enum(MealType) | ประเภทอาหารที่ใช้ข้อเสนอได้ เช่น อาหารกลางวันหรืออาหารค่ำ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ข้อเสนอกับอาหารทุกประเภทได้ | |
restricted_to_certain_courses | บูลีน | ข้อเสนอใช้ได้กับบางหลักสูตรเท่านั้นหรือไม่ |
คูปอง
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
text | สตริง | ข้อความคูปองที่ผู้ให้บริการข้อเสนอต้องการแสดงต่อผู้ใช้ | |
code | สตริง | ต้องระบุ | ต้องระบุรหัสคูปองเพื่อแลกสิทธิ์ข้อเสนอ ต้องระบุ |
PaymentInstrument
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
items | อาร์เรย์ของออบเจ็กต์(PaymentInstrumentItem) | ต้องระบุ | รายการเครื่องมือการชำระเงินที่ใช้รับข้อเสนอได้ ต้องระบุ |
provider_name | สตริง | ชื่อผู้ให้บริการเครื่องมือการชำระเงิน อาจเป็นพาร์ทเนอร์ด้านการธนาคาร ชื่อ ธนาคาร ฯลฯ เช่น American Express, HDFC, ICICI |
PaymentInstrumentItem
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
type | enum(PaymentInstrumentType) | ต้องระบุ | ประเภทของเครื่องมือการชำระเงิน ต้องระบุ |
name | สตริง | ต้องระบุ | ชื่อของรายการเครื่องมือการชำระเงิน เช่น ชื่อบัตรเครดิต เช่น HDFC Infinia, American Express Platinum ต้องระบุ |
การสมัครใช้บริการ
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
name | สตริง | ต้องระบุ | ชื่อของการสมัครใช้บริการ ต้องระบุ |
subscription_auto_added | บูลีน | ระบบจะเพิ่มการสมัครใช้บริการโดยอัตโนมัติเมื่อผู้ใช้ใช้ข้อเสนอนี้หรือไม่ | |
cost | object(Money) | ต้องระบุ | ค่าสมัครใช้บริการ ต้องระบุ |
subscription_duration | object(Duration) | ต้องระบุ | ระยะเวลาที่การสมัครใช้บริการมีผลที่ subscription_cost ต้องระบุ |
terms_and_conditions_url | สตริง | URL ของข้อกำหนดและเงื่อนไขของพาร์ทเนอร์ที่เกี่ยวข้องกับการสมัครใช้บริการนี้ |
ระยะเวลา
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
seconds | ตัวเลข | วินาทีที่ลงชื่อของช่วงเวลา ต้องอยู่ระหว่าง -315,576,000,000 ถึง +315,576,000,000 หมายเหตุ: ขอบเขตเหล่านี้คำนวณจาก 60 วินาที/นาที * 60 นาที/ชั่วโมง * 24 ชั่วโมง/วัน * 365.25 วัน/ปี * 10000 ปี | |
nanos | ตัวเลข | เศษส่วนของวินาทีที่ลงนามที่ความละเอียดระดับนาโนวินาทีของช่วง
เวลา ระยะเวลาที่น้อยกว่า 1 วินาทีจะแสดงด้วยฟิลด์ 0
seconds และฟิลด์ nanos ที่เป็นบวกหรือลบ สำหรับระยะเวลาตั้งแต่ 1 วินาทีขึ้นไป ค่าที่ไม่ใช่ 0 สำหรับฟิลด์ nanos ต้องมี
เครื่องหมายเดียวกันกับฟิลด์ seconds ต้องมีค่าตั้งแต่ -999,999,999
ถึง +999,999,999 |
ข้อกำหนด
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
url | สตริง | URL ของข้อกำหนดและเงื่อนไขของพาร์ทเนอร์ | |
restricted_to_certain_users | บูลีน | ข้อเสนอจำกัดไว้สำหรับผู้ใช้บางรายหรือไม่ | |
terms_and_conditions | สตริง | ข้อความข้อกำหนดและเงื่อนไขหลักที่พาร์ทเนอร์ระบุ | |
additional_terms_and_conditions | อาร์เรย์ของสตริง | ข้อกำหนดและเงื่อนไขเพิ่มเติมจากข้อกำหนดและเงื่อนไขหลักของพาร์ทเนอร์ |
ValidityPeriod
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
valid_period | object(ValidityRange) | การประทับเวลาเริ่มต้นและสิ้นสุดที่ข้อเสนอใช้ได้ เวลาเหล่านี้ต้องแสดงถึงวันต่างๆ ที่แตกต่างกัน กล่าวคือ เวลาเริ่มต้นต้องเป็น 00:00 (ต้นวัน) และเวลาสิ้นสุดต้องเป็น 00:00 (ไม่รวม) ใน วันที่ระยะเวลาที่ใช้ได้สิ้นสุดลง | |
time_of_day | อาร์เรย์ของออบเจ็กต์(TimeOfDayWindow) | ระบุช่วงเวลาที่ถูกต้องในวันหนึ่งๆ และวันที่ที่ข้อเสนอ
พร้อมให้บริการ สำหรับกรอบเวลาที่ข้ามเที่ยงคืน (เช่น 22:00 น. ถึง 02:00 น.) ให้ใช้หน้าต่างแยกกันสำหรับแต่ละวัน โดยหน้าต่างหนึ่งสิ้นสุดที่ 23:59:59 น. และอีกหน้าต่างหนึ่งเริ่มต้นที่ 00:00 น. ของวันถัดไป
ตัวอย่างเช่น
วันจันทร์: 10:00 น. - 17:00 น.
วันอังคาร: 10:00 น. - 14:00 น.
วันอังคาร: 17:00 น. - 19:00 น.
วันพุธ, พฤหัสบดี, ศุกร์, เสาร์, อาทิตย์: 15:00 น. - 19:00 น.
หากไม่ได้ตั้งค่าใดๆ หมายความว่าข้อเสนอจะพร้อมใช้งานตลอดเวลาภายใน
valid_period | |
time_exceptions | อาร์เรย์ของออบเจ็กต์(ValidTimeException) | ระบุข้อยกเว้นสำหรับ valid_period และ valid_time_of_week ที่ถูกต้องข้างต้น | |
date_exceptions | อาร์เรย์ของออบเจ็กต์(Date) | ระบุข้อยกเว้นเป็นวันสำหรับ valid_period และ time_of_day ที่ถูกต้องข้างต้น | |
validity_scope | enum(ValidityScope) | ระบุขอบเขตของระยะเวลาที่ใช้ได้ | |
validity_duration_in_days | ตัวเลข | ระยะเวลา (เป็นวัน) ที่บัตรกำนัล/คูปองจะใช้ได้เมื่อซื้อ |
ValidityRange
ช่วงการประทับเวลาแบบปิด-เปิด
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
valid_from_time | object(Timestamp) | ต้องระบุ | เวลาเริ่มต้นของช่วง (รวม) ต้องระบุ |
valid_through_time | object(Timestamp) | เวลาสิ้นสุดของช่วง (ไม่รวม) หากไม่ได้ตั้งค่าไว้ หมายความว่าช่วงเวลานี้จะไม่มีวันสิ้นสุด ไม่บังคับ |
การประทับเวลา
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
seconds | ตัวเลข | แสดงวินาทีของเวลา UTC ตั้งแต่ Unix Epoch 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง -62135596800 ถึง 253402300799 (รวม) (ซึ่งสอดคล้องกับ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z) | |
nanos | ตัวเลข | เศษส่วนของวินาทีที่ไม่เป็นลบที่ความละเอียดระดับนาโนวินาที ฟิลด์นี้คือ ส่วนของระยะเวลาที่เป็นนาโนวินาที ไม่ใช่ทางเลือกแทนวินาที ค่าวินาทีที่เป็นลบซึ่งมีเศษส่วนยังคงต้องมีค่านาโนที่เป็นบวก ซึ่งนับไปข้างหน้าตามเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 รวมด้วย |
TimeOfDayWindow
ออบเจ็กต์ TimeWindow เป็นเอนทิตีแบบคอมโพสิตที่อธิบายรายการ ของช่วงเวลาที่ผู้ใช้สามารถสั่งซื้อหรือดำเนินการตามคำสั่งซื้อได้
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
time_windows | object(TimeOfDayRange) | ต้องระบุ | กรอบเวลาที่สามารถสั่งซื้อ/ดำเนินการตามคำสั่งซื้อได้ ต้องระบุ |
day_of_week | อาร์เรย์ของ enum(DayOfWeek) | รายการวันในสัปดาห์ที่มีการใช้ช่วงเวลา หากไม่ได้ตั้งค่าไว้ แสดงว่ามีผลกับทุกวันในสัปดาห์ ไม่บังคับ | |
day_of_month | อาร์เรย์ของออบเจ็กต์(DayOfMonthRange) | วันที่ในเดือนที่มีการใช้ช่วงเวลา หากไม่ได้ตั้งค่าใดๆ หมายความว่าจะมีผลกับทุกวันในเดือน ไม่บังคับ |
TimeOfDayRange
ช่วงเวลาปิด-เปิด
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
open_time | object(TimeOfDay) | เวลาที่ระบุเวลาเริ่มต้นของวันในระยะเวลา (รวม) หากไม่ได้ตั้งค่า หมายความว่า 00:00:00 ไม่บังคับ | |
close_time | object(TimeOfDay) | เวลาที่ระบุเวลาสิ้นสุดของวันในระยะเวลา (ไม่รวม) หากไม่ได้ตั้งค่าไว้ จะหมายถึง 23:59:59 น. ไม่บังคับ |
TimeOfDay
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
hours | ตัวเลข | ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ต้องมากกว่าหรือเท่ากับ 0 และ โดยปกติแล้วต้องน้อยกว่าหรือเท่ากับ 23 API อาจเลือกอนุญาตค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการของธุรกิจ | |
minutes | ตัวเลข | นาทีของชั่วโมง ต้องมากกว่าหรือเท่ากับ 0 และน้อยกว่าหรือเท่ากับ 59 | |
seconds | ตัวเลข | วินาทีของนาที ต้องมากกว่าหรือเท่ากับ 0 และโดยทั่วไปต้องน้อยกว่าหรือเท่ากับ 59 API อาจอนุญาตค่า 60 หากอนุญาต วินาทีอธิกสุรทิน | |
nanos | ตัวเลข | เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องมากกว่าหรือเท่ากับ 0 และน้อยกว่าหรือเท่ากับ 999,999,999 |
DayOfMonthRange
ช่วงวันของเดือนที่มีผลกับทุกเดือนของปี
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
valid_from_day | ตัวเลข | ต้องระบุ | วันเริ่มต้นของช่วง (รวมวันที่เริ่มต้น) ต้องระบุ |
valid_through_day | ตัวเลข | วันสิ้นสุดของช่วง (รวมด้วย) หากไม่ได้ตั้งค่า แสดงว่าช่วงนี้แสดงถึงวันเดียว (valid_from_day) ไม่บังคับ |
ValidTimeException
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
exceptional_period | object(ValidityRange) | การประทับเวลาเริ่มต้นและสิ้นสุดที่ข้อเสนอใช้ไม่ได้ เวลาเหล่านี้ต้องแสดงถึงวันต่างๆ ที่แตกต่างกัน กล่าวคือ เวลาเริ่มต้นต้องเป็น 00:00 (ต้นวัน) และเวลาสิ้นสุดต้องเป็น 00:00 (ไม่รวม) ในวันที่ระยะเวลาข้อยกเว้นสิ้นสุด |
วันที่
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
year | ตัวเลข | ปีของวันที่ ต้องมีค่าตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี | |
month | ตัวเลข | เดือนของปี ต้องมีค่าระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน | |
day | ตัวเลข | วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และถูกต้องสำหรับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียวหรือปีและเดือนที่ไม่มีวัน |
OfferSource
| ชื่อ | คำอธิบาย |
|---|---|
OFFER_SOURCE_UNSPECIFIED | |
OFFER_SOURCE_AGGREGATOR |
ActionType
แสดงถึงโหมดการจำหน่ายของข้อเสนอ หากแชร์ข้อเสนอในโหมดการปฏิบัติตามคำสั่งหลายโหมดได้ คุณจะต้องสร้างข้อเสนอที่ซ้ำกันสำหรับโหมดการปฏิบัติตามคำสั่งแต่ละโหมด
| ชื่อ | คำอธิบาย |
|---|---|
ACTION_TYPE_UNSPECIFIED | |
ACTION_TYPE_FOOD_DELIVERY | ข้อเสนอนี้ใช้ได้กับบริการนำส่งอาหาร |
ACTION_TYPE_FOOD_TAKEOUT | ข้อเสนอนี้ใช้ได้กับการสั่งอาหารกลับบ้านหรือสั่งอาหารเพื่อไปรับที่ร้าน |
ACTION_TYPE_DINING | ข้อเสนอใช้สำหรับการรับประทานอาหารที่ร้านอาหาร |
ACTION_TYPE_SHOPPING_IN_STORE | ข้อเสนอใช้ได้กับการซื้อสินค้าแบบออฟไลน์ในร้านค้า |
OfferMode
ระบุวิธีการหรือช่องทางที่ผู้ใช้จะใช้ข้อเสนอได้
| ชื่อ | คำอธิบาย |
|---|---|
OFFER_MODE_OTHER | ใช้สำหรับวิธีการปฏิบัติตามคำสั่งซื้อที่โหมดอื่นๆ ที่เฉพาะเจาะจงไม่ครอบคลุม |
OFFER_MODE_WALK_IN | ข้อเสนอนี้ใช้ได้กับการเข้าชมสถานที่โดยไม่ต้องจองล่วงหน้า |
OFFER_MODE_FREE_RESERVATION | ข้อเสนอจะมีผลเมื่อผู้ใช้ทำการจองที่ไม่ต้องชำระค่าธรรมเนียมล่วงหน้า |
OFFER_MODE_PAID_RESERVATION | ข้อเสนอจะมีผลเมื่อผู้ใช้ทำการจองที่ต้องชำระเงินล่วงหน้า |
OFFER_MODE_ONLINE_ORDER | ข้อเสนอใช้ได้กับคำสั่งซื้อที่ดำเนินการผ่านเว็บไซต์หรือแพลตฟอร์มดิจิทัล |
OFFER_MODE_GIFT_CARD_PURCHASE | ระบุว่าการซื้อบัตรของขวัญเป็นขั้นตอนหลักที่จำเป็นในการรับข้อเสนอ |
OfferCategory
หมวดหมู่ของข้อเสนอ ข้อเสนอพื้นฐานคือข้อเสนอมาตรฐานที่พร้อมให้บริการแก่ลูกค้าทุกราย เช่น ส่วนลด 10% เมื่อใช้จ่ายมากกว่า 3,000 บาท ข้อเสนอพื้นฐานที่ถูกจำกัดโดยคูปองหรือเครื่องมือการชำระเงินจะมีช่องที่เกี่ยวข้องตั้งค่าไว้ นอกจากนี้ เรายังมีข้อเสนอแบบซื้อเพิ่ม เช่น ADD_ON_PAYMENT_OFFER คุณสามารถเพิ่มข้อเสนอดังกล่าว ลงในข้อเสนออื่นๆ เพื่อรับส่วนลดเพิ่มเติมได้
| ชื่อ | คำอธิบาย |
|---|---|
OFFER_CATEGORY_UNSPECIFIED | ไม่ควรใช้ค่า enum UNSPECIFIED หรือค่าเริ่มต้นในฟีด |
OFFER_CATEGORY_BASE_OFFER | |
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER | |
OFFER_CATEGORY_ADD_ON_COUPON_OFFER | |
OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER | |
OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER |
FeeUnit
| ชื่อ | คำอธิบาย |
|---|---|
FEE_UNIT_UNSPECIFIED | ไม่ควรใช้ค่า enum UNSPECIFIED หรือค่าเริ่มต้นในฟีด |
FEE_UNIT_PER_GUEST | |
FEE_UNIT_PER_TRANSACTION |
FeeType
| ชื่อ | คำอธิบาย |
|---|---|
FEE_TYPE_UNSPECIFIED | ไม่ควรใช้ค่า enum UNSPECIFIED หรือค่าเริ่มต้นในฟีด |
FEE_TYPE_FIXED | |
FEE_TYPE_VARIABLE |
OfferDiscountType
| ชื่อ | คำอธิบาย |
|---|---|
OFFER_DISCOUNT_TYPE_UNSPECIFIED | |
OFFER_DISCOUNT_TYPE_INSTANT_DISCOUNT | |
OFFER_DISCOUNT_TYPE_CASHBACK | |
OFFER_DISCOUNT_TYPE_REWARD_POINT |
MealType
| ชื่อ | คำอธิบาย |
|---|---|
MEAL_TYPE_UNSPECIFIED | ไม่ควรใช้ค่า enum UNSPECIFIED หรือค่าเริ่มต้นในฟีด |
MEAL_TYPE_BREAKFAST | |
MEAL_TYPE_LUNCH | |
MEAL_TYPE_DINNER |
PaymentInstrumentType
| ชื่อ | คำอธิบาย |
|---|---|
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED | ไม่ควรใช้ค่า enum UNSPECIFIED หรือค่าเริ่มต้นในฟีด |
PAYMENT_INSTRUMENT_CREDIT_CARD | |
PAYMENT_INSTRUMENT_DEBIT_CARD | |
PAYMENT_INSTRUMENT_BANK_ACCOUNT | |
PAYMENT_INSTRUMENT_UPI | |
PAYMENT_INSTRUMENT_ONLINE_WALLET | |
PAYMENT_INSTRUMENT_NETBANKING |
วันของสัปดาห์
แสดงวันในสัปดาห์
| ชื่อ | คำอธิบาย |
|---|---|
DAY_OF_WEEK_UNSPECIFIED | ไม่ได้ระบุวันในสัปดาห์ |
MONDAY | วันจันทร์ |
TUESDAY | อังคาร |
WEDNESDAY | พุธ |
THURSDAY | พฤหัสบดี |
FRIDAY | ศุกร์ |
SATURDAY | เสาร์ |
SUNDAY | วันอาทิตย์ |
ValidityScope
ขอบเขตของระยะเวลาที่ใช้งานได้ กล่าวคือ การดำเนินการที่ระยะเวลาที่ใช้งานได้นี้มีผล
| ชื่อ | คำอธิบาย |
|---|---|
VALIDITY_SCOPE_UNSPECIFIED | |
VALIDITY_SCOPE_CLAIM | |
VALIDITY_SCOPE_REDEEM |
OfferTag
| ชื่อ | คำอธิบาย |
|---|---|
OFFER_TAG_UNSPECIFIED | ไม่ควรใช้ค่า enum UNSPECIFIED หรือค่าเริ่มต้นในฟีด |
OFFER_TAG_NEW_YEAR_SPECIAL | |
OFFER_TAG_VALENTINES_SPECIAL |
AvailabilityLevel
ระบุสถานะสต็อกหรือความพร้อมใช้งานของข้อเสนอ
| ชื่อ | คำอธิบาย |
|---|---|
AVAILABILITY_LEVEL_UNSPECIFIED | |
AVAILABILITY_LEVEL_LOW | ระบุว่าข้อเสนอมีจำนวนเหลือน้อย เราขอแนะนำให้ผู้ใช้แลกรับข้อเสนอก่อนที่สินค้าจะหมด เราอาจเพิ่มตัวเลือกปานกลางและสูงในภายหลัง |
offer_specification
ส่วนลดอาจเป็นเปอร์เซ็นต์หรือค่าคงที่ที่หักออกจากมูลค่ารวม เช่น 1. ลด 10% สำหรับใบเรียกเก็บเงินสุดท้าย 2. ส่วนลด $15 สำหรับคำสั่งซื้อ ผู้ขายยังเสนอส่วนลดที่กำหนดเอง เช่น "ซื้อ 1 แถม 1" ผ่านช่องข้อกำหนดที่เกี่ยวข้องได้ด้วย ต้องระบุ
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
discount_percent | ตัวเลข | ใช้ร่วมกับ | เปอร์เซ็นต์ของใบเรียกเก็บเงินที่ได้รับส่วนลด [0, 100] สำหรับข้อเสนอ 1+1 หรือส่วนลด 50% ที่ใช้ได้กับอาหารทั้งมื้อ (เช่น บุฟเฟต์ 1+1, ส่วนลด 1+1 สำหรับใบเรียกเก็บเงินทั้งหมด, ส่วนลด 1+1 สำหรับเซ็ตเมนู) คุณสามารถ ตั้งค่านี้เป็น 50 ได้ |
discount_value | object(Money) | ใช้ร่วมกับ | มูลค่าคงที่ของส่วนลด |
other_offer_detail_text | สตริง | ใช้ร่วมกับ | ข้อความรูปแบบอิสระเพื่ออธิบายส่วนลด สำหรับข้อเสนอ 1+1 ที่เฉพาะเจาะจง (เช่น เครื่องดื่ม 1+1, เมนูจานหลัก +1, รายการในเมนูที่เลือก 1+1) ควรระบุรายละเอียดเหล่านี้ที่นี่ |
ต้นทุน
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
amount | object(Money) | ใช้ร่วมกับ | |
amount_range | object(MoneyRange) | ใช้ร่วมกับ |
denomination_type
| ชื่อช่อง | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
fixed_denominations | object(FixedDenominations) | ใช้ร่วมกับ | ใช้เมื่อบัตรของขวัญมีมูลค่าที่เฉพาะเจาะจงและคงที่ |
custom_range | object(MoneyRange) | ใช้ร่วมกับ | ใช้เมื่อแบรนด์อนุญาตให้ผู้ใช้เลือกมูลค่าหน้าตั๋วที่กำหนดเอง (ยืดหยุ่น) ภายในช่วงที่กำหนด |
การอัปโหลดฟีด
คุณต้องอัปโหลดฟีดข้อเสนอ
ไปยังเซิร์ฟเวอร์ SFTP ของฟีด Generic ทำตามวิธีการในบทแนะนำวิธีใช้เซิร์ฟเวอร์ SFTP ของฟีดทั่วไป
และใช้nameที่ตั้งค่าเป็น google.offer ในไฟล์ตัวอธิบาย
ความถี่ในการอัปโหลด
โดยทั่วไป Google คาดหวังการอัปโหลดฟีด 1 ครั้งต่อวัน คุณอาจเพิ่มหรือลดความถี่ได้โดยขึ้นอยู่กับความถี่ในการอัปเดตข้อเสนอในฝั่งของคุณเพื่อให้มั่นใจว่ามีความแม่นยำสูงอย่างสม่ำเสมอ โปรดปรึกษา POC ของ Google
ข้อมูลจะใช้เวลา 2-3 ชั่วโมงก่อนที่จะปรากฏใน Google
การจัดหมวดหมู่ข้อเสนอ
OFFER_CATEGORY_BASE_OFFER: ข้อเสนอที่รับสิทธิ์แยกกันได้ โดยไม่ต้องใช้ร่วมกับข้อเสนออื่นๆ ซึ่งรวมถึงสิ่งต่างๆ ต่อไปนี้- ส่วนลดแบบคงที่สำหรับใบเรียกเก็บเงินทั้งหมด (เช่น ส่วนลด 20%)
- ข้อเสนอการสมัครใช้บริการ (เช่น ของหวานฟรีเมื่อเป็นสมาชิก)
- ข้อเสนอการชำระเงินในกรณีที่ไม่มีข้อเสนอพื้นฐานอื่นๆ สำหรับ ร้านอาหาร
- หมายเหตุ: ไม่ควรตั้งค่าข้อเสนอการยกเว้นค่าธรรมเนียมหรือการลดค่าธรรมเนียมทั้งแพลตฟอร์มเป็นข้อเสนอพื้นฐาน
- ข้อเสนอส่วนเสริม: ข้อเสนอที่ต้องมีการอ้างสิทธิ์ข้อเสนอพื้นฐาน ซึ่งรวมถึง
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER(เช่น ลดเพิ่ม 10% เมื่อใช้ บัตรเครดิตที่เฉพาะเจาะจง)OFFER_CATEGORY_ADD_ON_COUPON_OFFER(เช่น เครื่องดื่มฟรีเมื่อใช้รหัสคูปอง ที่เฉพาะเจาะจง)OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER(เช่น ส่วนลดเพิ่มเติม 10% สำหรับ สมาชิก)OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER(เช่น จัดส่งฟรีหรือ ลดค่าธรรมเนียม)
ข้อควรพิจารณาอื่นๆ:
- ไม่ควรกำหนดข้อเสนอการยกเว้นหรือลดค่าธรรมเนียมทั้งแพลตฟอร์มเป็นข้อเสนอพื้นฐาน (
OFFER_CATEGORY_BASE_OFFER) แต่ควรกำหนดเป็นOFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFERเท่านั้นเพื่อเสริมข้อเสนอพื้นฐาน อื่นที่ใช้งานอยู่ - เมื่อร้านอาหารไม่ได้ตั้งค่าข้อเสนอพื้นฐาน ระบบจะไม่แสดงข้อเสนอเสริม
หากไม่มีข้อเสนอพื้นฐาน ข้อเสนอการชำระเงิน การสมัครใช้บริการ หรือคูปองที่สามารถ
อ้างสิทธิ์ได้โดยไม่ต้องเพิ่มในข้อเสนออื่นจะต้องติดแท็กเป็น
OFFER_CATEGORY_BASE_OFFER- ข้อมูลที่เกี่ยวข้องสำหรับ
PaymentInstrumentSubscriptionหรือCouponต้อง ตั้งค่าตามประเภท - พาร์ทเนอร์ต้องส่งสำเนาข้อเสนอแต่ละรายการ 2 ชุดเพื่อครอบคลุม
สถานการณ์ที่ข้อเสนอเหล่านั้นทำหน้าที่เป็นทั้งข้อเสนอพื้นฐานและข้อเสนอเสริม จากนั้นคุณจะตั้งค่าข้อเสนอเสริมสำหรับร้านอาหารหลายแห่งได้โดยใช้
entity_idsหรือadd_on_offer_applicable_to_all_entities
- ข้อมูลที่เกี่ยวข้องสำหรับ
- เมื่อร้านอาหารมีข้อเสนอพื้นฐานหลายรายการที่ซ้อนกันได้ ข้อเสนอพื้นฐานทั้งหมดควรแท็กเป็น
OFFER_CATEGORY_BASE_OFFERและข้อเสนอพื้นฐานที่เป็นข้อเสนอการชำระเงิน การสมัครใช้บริการ หรือคูปองควรส่งเพิ่มเติมเป็นประเภทข้อเสนอเสริมที่เกี่ยวข้อง ValidityPeriodควรใช้เพื่อเปิดใช้งานข้อเสนอเสริมเป็นข้อเสนอพื้นฐานเฉพาะในกรณีที่ไม่มี ข้อเสนอพื้นฐานที่ใช้งานอยู่- การรวมข้อเสนอที่เหมือนกันตามเครื่องมือการชำระเงิน: หากเครื่องมือการชำระเงินหลายรายการมีส่วนลดที่เหมือนกันทุกประการ (เช่น บัตรเครดิต บัตรเดบิต และ Net Banking ทั้งหมดเสนอส่วนลด 5%) ให้จัดกลุ่มเครื่องมือเหล่านั้นไว้ภายใต้วัตถุ
Offerที่รวมรายการเดียวแทนที่จะส่งข้อเสนอที่ซ้ำกันแยกกัน โดยให้กรอกข้อมูลpayment_instrument.itemsรายการด้วยเครื่องมือการชำระเงินที่เกี่ยวข้องทั้งหมด ซึ่งจะช่วยลดความซับซ้อนของเลย์เอาต์ใน อินเทอร์เฟซของ Google และป้องกันไม่ให้การจัดอันดับลดลงเนื่องจาก ข้อจำกัดที่ซ้ำกันมากเกินไป
สถานการณ์ตัวอย่าง
ร้านอาหารเสนอส่วนลด 5% เมื่อชำระเงินด้วยบัตรเครดิตที่เฉพาะเจาะจงและ เครื่องดื่มฟรีเมื่อใช้รหัสคูปองที่เฉพาะเจาะจง
- ควรส่งข้อเสนอส่วนลด 5% สำหรับบัตรเครดิตเป็น 2 สำเนา โดยสำเนาหนึ่งติดแท็กเป็น
OFFER_CATEGORY_BASE_OFFERและอีกสำเนาหนึ่งติดแท็กเป็นOFFER_CATEGORY_ADD_ON_PAYMENT_OFFERพร้อมระบุรายละเอียดPaymentInstrument - ข้อเสนอเครื่องดื่มฟรีพร้อมรหัสคูปองควรส่งเป็น
OFFER_CATEGORY_ADD_ON_COUPON_OFFERพร้อมรายละเอียดCoupon
- ควรส่งข้อเสนอส่วนลด 5% สำหรับบัตรเครดิตเป็น 2 สำเนา โดยสำเนาหนึ่งติดแท็กเป็น
ร้านอาหารเสนอส่วนลด 10% สำหรับลูกค้าที่วอล์กอินและส่วนลด 5% เมื่อชำระเงินด้วย บัตรเครดิตที่เฉพาะเจาะจง ซึ่งสามารถใช้ร่วมกันได้
- ข้อเสนอสำหรับลูกค้าที่วอล์กอิน 10% ควรติดแท็กเป็น
OFFER_CATEGORY_BASE_OFFER - ข้อเสนอบัตรเครดิตลด 5% ควรมี 2 รายการ โดยรายการหนึ่งติดแท็กเป็น
OFFER_CATEGORY_BASE_OFFERและอีกรายการติดแท็กเป็นOFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
- ข้อเสนอสำหรับลูกค้าที่วอล์กอิน 10% ควรติดแท็กเป็น
ร้านอาหารเสนอส่วนลด 10% สำหรับมื้อกลางวันในวันธรรมดาเท่านั้น และส่วนลด 5% ทุกเมื่อ เมื่อชำระเงินด้วยบัตรเครดิตที่เฉพาะเจาะจง
- ข้อเสนอส่วนลด 10% ควรมี
ValidityPeriodตั้งค่าเพื่อระบุเฉพาะในช่วงเวลาอาหารกลางวันของร้านอาหารในวันธรรมดา - ควรส่งสำเนาข้อเสนอบัตรเครดิตที่ลด 5% จำนวน 2 ชุด
- สำเนาหนึ่งควรติดแท็กเป็น
OFFER_CATEGORY_BASE_OFFERโดยมีรายละเอียดPaymentInstrumentรวมอยู่ด้วยValidityPeriodควรตั้งค่าให้ยกเว้นช่วงเวลาอาหารกลางวันในวันธรรมดาเมื่อข้อเสนอส่วนลด 10% สำหรับมื้อกลางวันใช้งานอยู่ - สำเนาหนึ่งควรติดแท็กเป็น
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFERwith thePaymentInstrumentพร้อมรายละเอียด
- สำเนาหนึ่งควรติดแท็กเป็น
- ข้อเสนอการชำระเงินอื่นๆ ทั้งหมดสำหรับร้านอาหารนี้ควรติดแท็กเป็น
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
- ข้อเสนอส่วนลด 10% ควรมี
กระบวนการพัฒนาและการเปิดตัว
ตลอดการผสานรวม Partner Portal จะช่วยคุณให้ข้อมูลและรับความคิดเห็นตามการพัฒนาของคุณได้ กระบวนการพัฒนาจะเป็นไปตามโฟลว์นี้
- โดยจะพัฒนาการผสานรวมในสภาพแวดล้อมแซนด์บ็อกซ์ก่อน คุณควรใช้การส่งออกข้อมูลการผลิต (หรือแม้แต่ข้อมูลการผลิตโดยตรง) ในสภาพแวดล้อมแซนด์บ็อกซ์ของ Google ซึ่งจะช่วยให้การพัฒนาของคุณครอบคลุมกรณีที่ซับซ้อนทั้งหมด และช่วยให้ Google ประเมินคุณภาพของข้อมูลและช่วยเหลือคุณได้ดียิ่งขึ้นตามโมเดลข้อมูล
- เมื่อคุณอัปโหลดฟีดผู้ขาย บริการ และดีลที่สมบูรณ์และอัปเดตทุกวันในสภาพแวดล้อมแซนด์บ็อกซ์ของ Google อย่างสม่ำเสมอ ทีม Google จะประเมินฟีดของคุณ เมื่อทีม Google อนุมัติแล้ว คุณจะพุชโค้ด ไปยังเวอร์ชันที่ใช้งานจริงและเริ่มส่งข้อมูลเวอร์ชันที่ใช้งานจริงไปยังสภาพแวดล้อมเวอร์ชันที่ใช้งานจริงของ Google ได้
- หลังจากที่คุณทดสอบการผสานรวมเวอร์ชันที่ใช้งานจริงอย่างเต็มรูปแบบแล้ว ทีม Google จะ ทดสอบด้วยเช่นกัน เมื่อการทดสอบทั้งหมดเสร็จสมบูรณ์แล้ว การผสานรวมจะเปิดตัว
การตรวจสอบ
Google จะตรวจสอบว่าข้อเสนอที่ระบุนั้นถูกต้องและเป็นไปตามเกณฑ์นโยบายของเราทั้งก่อนและหลังการเปิดตัว เพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดี โดย Google จะใช้การตรวจสอบทั้งจากเจ้าหน้าที่และการตรวจสอบแบบอัตโนมัติ คุณจะดูผลการตรวจสอบเหล่านี้ได้ในแดชบอร์ดข้อเสนอของศูนย์การดำเนินการ (เวอร์ชันที่ใช้งานจริงเท่านั้น) ผลลัพธ์ของการตรวจสอบนี้อาจนำไปใช้ ส่งผลต่อการจัดอันดับข้อเสนอ
ตรวจสอบว่าหน้าเว็บใช้เวลาโหลดทั้งหมดพร้อมข้อเสนอน้อยกว่า 5 วินาที ไม่เช่นนั้นระบบจะถือว่าไม่สำเร็จและจะแจ้งว่าBad link
การตรวจสอบอัตโนมัติ (Crawler)
ทีมคุณภาพของ Google จะติดตั้งใช้งาน Crawler Crawler คือสคริปต์ที่ทำให้เว็บเบราว์เซอร์ทำงานโดยอัตโนมัติเพื่อคลิกบางอย่างและดึงข้อมูลข้อเสนอ เพื่อวัตถุประสงค์ในการทดสอบคุณภาพเท่านั้น
จำนวนการค้นหา
ตัวอย่างเช่น หากเราตัดสินใจส่งการตรวจสอบ 5,000 ครั้งต่อวัน หมายความว่า 5,000 ครั้งต่อวัน (กระจายอย่างสม่ำเสมอตลอดทั้งวัน ซึ่งก็คือประมาณ 1 ครั้งทุกๆ 17 วินาที) Crawler ของเราจะดำเนินการทั้งหมดต่อไปนี้ที่ผู้ใช้ทั่วไปจะทำ
- เริ่มจาก Google Search แล้วคลิกลิงก์พาร์ทเนอร์
- มองหาข้อมูลข้อเสนอ
- หากข้อกำหนดของข้อเสนอต้องมีการจอง ระบบจะนำคุณไปยังขั้นตอนการจองเพื่อ ยืนยันว่าข้อเสนอพร้อมให้บริการในเวลาที่ระบุ (จะไม่มีการจอง ใดๆ)
การตรวจจับโปรแกรมคัดลอกข้อมูลบนเว็บ
โปรดตรวจสอบว่าระบบของคุณอนุญาตให้ Web Scraper ของเราค้นหาหน้าเว็บได้ตลอดเวลา เพื่อให้มั่นใจว่า Web Scraper จะไม่ถูกแบน (ซึ่งอาจทำให้สรุปได้ว่าข้อเสนอไม่พร้อมใช้งาน) วิธีระบุ Web Scraper ของเรา
- User-Agent ของ Web Scraper จะมีสตริง "Google-Offers" ดังนี้
- ตัวอย่าง: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko; Google-Offers) Chrome/104.0.5112.101 Safari/537.36
- นอกจากนี้ คุณยังตรวจสอบได้ว่าการเรียกใช้มาจาก Google หรือไม่โดยใช้ DNS แบบย้อนกลับตามที่แนะนำใน"การยืนยัน Googlebot และโปรแกรม Crawl อื่นๆ ของ Google"
ในกรณีของเรา การแปลง DNS แบบย้อนกลับจะเป็นไปตามรูปแบบนี้
google-proxy-***-***-***-***.google.com
ลักษณะการทำงานทางเทคนิค
กำลังแคช
เพื่อลดภาระงานในเว็บไซต์พาร์ทเนอร์ โดยทั่วไปเราจะกำหนดค่า Crawler ให้ยึดตามส่วนหัวการแคช HTTP มาตรฐานทั้งหมดที่อยู่ในการตอบกลับ ซึ่งหมายความว่าสำหรับเว็บไซต์ที่กำหนดค่าอย่างถูกต้อง เราจะหลีกเลี่ยงการดึงข้อมูลเนื้อหาที่เปลี่ยนแปลงไม่บ่อย (เช่น ไลบรารี JavaScript) ซ้ำๆ ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธี ใช้การแคชได้ใน เอกสารประกอบเกี่ยวกับการแคช HTTP