การผสานรวมฟีดข้อเสนอ

ข้อเสนอ

การผสานรวมข้อเสนอช่วยให้คุณส่งต่อข้อมูลที่มีโครงสร้างเกี่ยวกับโปรโมชันและส่วนลดของผู้ขายที่ใช้กับบริการที่เฉพาะเจาะจงในช่วงเวลาที่เฉพาะเจาะจงได้ ข้อเสนอ ประกอบด้วยข้อเสนอจริง (ส่วนลดเป็นเปอร์เซ็นต์ ส่วนลดเป็นดอลลาร์ ฯลฯ) ช่วงเวลาที่ข้อเสนอใช้ได้ (เวลาที่เฉพาะเจาะจง วันของสัปดาห์ ฯลฯ) และการใช้งานที่เกี่ยวข้อง (ข้อเสนอใช้ได้กับบริการบางอย่างเท่านั้น) รวมถึงการผสมผสานข้อจำกัดที่ซับซ้อน

ตัวอย่างข้อเสนอ

  • ลดราคาอาหารเรียกน้ำย่อยครึ่งราคาในวันพุธและวันพฤหัสบดีในเดือนธันวาคมตั้งแต่เวลา 12:00 น. ถึง 17:00 น.
  • ซื้อ 1 แถม 1 สำหรับของหวานในมื้อค่ำวันแม่ตั้งแต่เวลา 18:00 น. ถึง 22:00 น.
  • รับส่วนลด $5 สำหรับอาหารจานหลักของบรันช์ทุกวันอาทิตย์ตั้งแต่เวลา 10:00 น. ถึง 14:00 น.
  • ส่วนลด 10% สำหรับข้อเสนอแบบวอล์กอินที่ใช้ร่วมกับส่วนลด 5% สำหรับสมาชิก Premium และ ส่วนลด 5% หากผู้ใช้ชำระเงินผ่านแอปของคุณ

หากต้องการให้ข้อเสนอรวมอยู่ในการผสานรวม ข้อเสนอจะต้องอยู่ใน โมเดลข้อมูลทางเทคนิคและเป็นไปตามข้อกำหนดของการได้รับสิทธิ์ของเรา อย่าลืมอ่านนโยบายข้อเสนอ เพื่อให้แน่ใจว่าการผสานรวมเป็นไปตามข้อกำหนดและดูวิธีการ เกี่ยวกับสิ่งที่ต้องทำกับข้อเสนอที่ไม่เป็นไปตามข้อกำหนดทางเทคนิค

การติดตั้งใช้งานข้อเสนอ

การผสานรวมข้อเสนอประกอบด้วยฟีด 2 รายการที่จะอัปโหลดทุกวันหรือที่ความถี่ที่รับประกันความแม่นยำสูง (หมายถึงลดความล้าสมัย) ดังนี้

OfferFeed

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
dataอาร์เรย์ของออบเจ็กต์
(Offer)

ข้อเสนอ

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
offer_idสตริง

ต้องระบุ

รหัสที่ไม่ซ้ำกันของข้อเสนอ ต้องระบุ
entity_idsอาร์เรย์ของสตริง

รายชื่อผู้ขายที่เข้าร่วมข้อเสนอนี้
add_on_offer_applicable_to_all_entitiesบูลีน

หากเป็นจริง ข้อเสนอนี้จะมีผลกับทุกเอนทิตีภายใต้ผู้รวบรวม ใช้ได้กับข้อเสนอส่วนเสริมเท่านั้น
offer_sourceenum
(OfferSource)

ต้องระบุ

ข้อเสนออาจมาจากผู้รวบรวมข้อมูล ผู้ขายรายบุคคล หรือแม้แต่บุคคลที่สามในรูปแบบส่วนเสริม ต้องระบุ
action_typeenum
(ActionType)

ต้องระบุ

บริการที่ให้ข้อเสนอ offer_id จะเป็นของ action_type ได้เพียงรายการเดียวเท่านั้น หากแชร์ข้อเสนอในบริการหลายประเภทได้ คุณจะต้องสร้างข้อเสนอที่ซ้ำกันโดยมีรหัสที่ไม่ซ้ำกันสำหรับบริการแต่ละประเภท ต้องระบุ
offer_modesอาร์เรย์ของ enum
(OfferMode)

ต้องระบุ

วิธีการใช้ข้อเสนอ - วอล์กอิน การจอง ออนไลน์ ฯลฯ ต้องระบุ
offer_categoryenum
(OfferCategory)

ต้องระบุ

หมวดหมู่ของข้อเสนอ ต้องระบุ
source_assigned_priorityตัวเลข

จำนวนเต็มที่ไม่เป็นลบ ([1-100] โดยที่ 1 หมายถึงลำดับความสำคัญสูงสุด) ซึ่งระบุระดับลำดับความสำคัญของข้อเสนอที่แหล่งที่มากำหนด เมื่อมีข้อเสนอหลายรายการสำหรับผู้ขายรายเดียวกัน ข้อเสนอนี้จะเป็นสัญญาณ สำหรับการจัดอันดับข้อเสนอ 0 หมายความว่าไม่ได้ตั้งค่าลำดับความสำคัญ
offer_detailsobject
(OfferDetails)

ต้องระบุ

รายละเอียดของข้อเสนอ เช่น ส่วนลด ค่าใช้จ่ายในการจอง ฯลฯ ต้องระบุ
offer_restrictionsobject
(OfferRestrictions)

ต้องระบุ

อธิบายว่าข้อเสนอมีข้อจำกัดอย่างไร เช่น ต้องมีการสมัครใช้บริการ/เครื่องมือชำระเงินหรือไม่ ข้อเสนอนี้ใช้ร่วมกับข้อเสนออื่นๆ ได้หรือไม่ (และใช้ร่วมกับข้อเสนอประเภทใดได้) ต้องระบุ
couponobject
(Coupon)

รายละเอียดของคูปอง ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER
payment_instrumentobject
(PaymentInstrument)

รายละเอียดของเครื่องมือการชำระเงิน ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
subscriptionobject
(Subscription)

รายละเอียดการสมัครใช้บริการ ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER
termsobject
(Terms)

ต้องระบุ

ข้อกำหนดและเงื่อนไขของข้อเสนอ ต้องระบุ
validity_periodsอาร์เรย์ของออบเจ็กต์
(ValidityPeriod)

ต้องระบุ

ระยะเวลาที่ข้อเสนอใช้งานได้ อธิบายระยะเวลาที่ข้อเสนอใช้ได้ รวมถึงเวลาเริ่มต้นและสิ้นสุด วันในสัปดาห์ ฯลฯ ต้องระบุ
offer_urlสตริง

URL ไปยังหน้าข้อเสนอของผู้ขาย ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_BASE_OFFER
tagsอาร์เรย์ของ enum
(OfferTag)

แท็กพิเศษที่เชื่อมโยงกับข้อเสนอ ใช้เพื่อระบุข้อเสนอพิเศษ เช่น "เทศกาล" "ได้รับคะแนนสูงสุด" "จองมากที่สุด" ฯลฯ
brand_idสตริง

ต้องระบุสำหรับดีลบัตรของขวัญเพื่อระบุแบรนด์ที่เสนอดีล
availability_levelenum
(AvailabilityLevel)

ระดับความพร้อมใช้งานของข้อเสนอ

OfferDetails

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
offer_display_textสตริง

ต้องระบุ

ข้อความข้อเสนอที่ผู้ให้บริการข้อเสนอต้องการแสดงต่อลูกค้าในหน้าผลการค้นหา โปรดทราบว่าข้อความนี้อาจไม่ตรงกับที่แสดงต่อผู้ใช้ และเราอาจใช้ข้อมูลเมตาอื่นๆ เพื่อเขียน/เรียบเรียงใหม่ ต้องระบุ
oneOf
(offer_specification)

ต้องระบุ

ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้
max_discount_valueobject
(Money)

ส่วนลดสูงสุดที่ใช้ได้ เช่น ลด 10% สูงสุด 1, 000 บาท
min_spend_valueobject
(Money)

มูลค่าการใช้จ่ายขั้นต่ำเพื่อรับส่วนลด เช่น รับส่วนลด 10% เมื่อราคารวมเป็น $100 ขึ้นไป
booking_costobject
(Money)

ค่าใช้จ่ายในการจองข้อเสนอนี้ เช่น ส่วนลด 3, 000 บาทจากบิลสุดท้ายเมื่อจองโต๊ะในราคา 450 บาท
booking_cost_unitenum
(FeeUnit)

หน่วยของค่าใช้จ่ายในการจอง เช่น ต่อคน ต่อธุรกรรม
convenience_feeobject
(Fee)

booking_cost_adjustableบูลีน

ระบุว่าต้นทุนการจองปรับได้หรือไม่ เช่น ต้นทุนการจองจะหักออกจากใบเรียกเก็บเงินสุดท้าย เช่น ลด 30% สำหรับอาหารค่ำเมื่อจอง ค่าใช้จ่ายในการจองคือ $15 และระบบจะ นำไปใช้กับการเรียกเก็บเงินขั้นสุดท้าย ดังนั้นค่าใช้จ่ายสุดท้ายคือ ค่าใช้จ่ายทั้งหมด - 30% - $15
additional_feesอาร์เรย์ของออบเจ็กต์
(AdditionalFee)

ค่าธรรมเนียมเพิ่มเติมที่เรียกเก็บจากผู้ใช้ ตัวอย่าง: ค่าธรรมเนียมความสะดวก ค่าธรรมเนียมการจัดการ ค่าธรรมเนียมการนำส่ง ค่าธรรมเนียมการบรรจุภัณฑ์ ค่าบริการ ฯลฯ
offer_discount_typeenum
(OfferDiscountType)

ประเภทส่วนลด
gift_card_infoobject
(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

ค่าธรรมเนียม

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
unitenum
(FeeUnit)

typeenum
(FeeType)

oneOf
(cost)

ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้

MoneyRange

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
min_amountobject
(Money)

max_amountobject
(Money)

AdditionalFee

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
nameสตริง

ต้องระบุ

ชื่อของค่าธรรมเนียมเพิ่มเติม ตัวอย่าง: ค่าธรรมเนียมเพิ่มเติม ค่าธรรมเนียมการจัดการ ฯลฯ ต้องระบุ
feeobject
(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_restrictionsobject
(FoodOfferRestrictions)

ข้อจำกัดที่เฉพาะเจาะจงสำหรับข้อเสนออาหาร
max_redemption_countตัวเลข

ข้อจำกัดเฉพาะเกี่ยวกับจำนวนครั้งที่ใช้ข้อเสนอนี้ได้ ค่า 0 จะระบุว่าไม่มีขีดจำกัด เช่น ค่า 3 หมายความว่าผู้ใช้ใช้ข้อเสนอนี้ได้ 3 ครั้ง
max_total_discount_valueobject
(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

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
typeenum
(PaymentInstrumentType)

ต้องระบุ

ประเภทของเครื่องมือการชำระเงิน ต้องระบุ
nameสตริง

ต้องระบุ

ชื่อของรายการเครื่องมือการชำระเงิน เช่น ชื่อบัตรเครดิต เช่น HDFC Infinia, American Express Platinum ต้องระบุ

การสมัครใช้บริการ

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
nameสตริง

ต้องระบุ

ชื่อของการสมัครใช้บริการ ต้องระบุ
subscription_auto_addedบูลีน

ระบบจะเพิ่มการสมัครใช้บริการโดยอัตโนมัติเมื่อผู้ใช้ใช้ข้อเสนอนี้หรือไม่
costobject
(Money)

ต้องระบุ

ค่าสมัครใช้บริการ ต้องระบุ
subscription_durationobject
(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_periodobject
(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_scopeenum
(ValidityScope)

ระบุขอบเขตของระยะเวลาที่ใช้ได้
validity_duration_in_daysตัวเลข

ระยะเวลา (เป็นวัน) ที่บัตรกำนัล/คูปองจะใช้ได้เมื่อซื้อ

ValidityRange

ช่วงการประทับเวลาแบบปิด-เปิด

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
valid_from_timeobject
(Timestamp)

ต้องระบุ

เวลาเริ่มต้นของช่วง (รวม) ต้องระบุ
valid_through_timeobject
(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_windowsobject
(TimeOfDayRange)

ต้องระบุ

กรอบเวลาที่สามารถสั่งซื้อ/ดำเนินการตามคำสั่งซื้อได้ ต้องระบุ
day_of_weekอาร์เรย์ของ enum
(DayOfWeek)

รายการวันในสัปดาห์ที่มีการใช้ช่วงเวลา หากไม่ได้ตั้งค่าไว้ แสดงว่ามีผลกับทุกวันในสัปดาห์ ไม่บังคับ
day_of_monthอาร์เรย์ของออบเจ็กต์
(DayOfMonthRange)

วันที่ในเดือนที่มีการใช้ช่วงเวลา หากไม่ได้ตั้งค่าใดๆ หมายความว่าจะมีผลกับทุกวันในเดือน ไม่บังคับ

TimeOfDayRange

ช่วงเวลาปิด-เปิด

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
open_timeobject
(TimeOfDay)

เวลาที่ระบุเวลาเริ่มต้นของวันในระยะเวลา (รวม) หากไม่ได้ตั้งค่า หมายความว่า 00:00:00 ไม่บังคับ
close_timeobject
(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_periodobject
(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ตัวเลข

ใช้ร่วมกับ discount_value, other_offer_detail_text ไม่ได้

เปอร์เซ็นต์ของใบเรียกเก็บเงินที่ได้รับส่วนลด [0, 100] สำหรับข้อเสนอ 1+1 หรือส่วนลด 50% ที่ใช้ได้กับอาหารทั้งมื้อ (เช่น บุฟเฟต์ 1+1, ส่วนลด 1+1 สำหรับใบเรียกเก็บเงินทั้งหมด, ส่วนลด 1+1 สำหรับเซ็ตเมนู) คุณสามารถ ตั้งค่านี้เป็น 50 ได้
discount_valueobject
(Money)

ใช้ร่วมกับ discount_percent, other_offer_detail_text ไม่ได้

มูลค่าคงที่ของส่วนลด
other_offer_detail_textสตริง

ใช้ร่วมกับ discount_percent, discount_value ไม่ได้

ข้อความรูปแบบอิสระเพื่ออธิบายส่วนลด สำหรับข้อเสนอ 1+1 ที่เฉพาะเจาะจง (เช่น เครื่องดื่ม 1+1, เมนูจานหลัก +1, รายการในเมนูที่เลือก 1+1) ควรระบุรายละเอียดเหล่านี้ที่นี่

ต้นทุน

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
amountobject
(Money)

ใช้ร่วมกับ amount_range ไม่ได้

amount_rangeobject
(MoneyRange)

ใช้ร่วมกับ amount ไม่ได้

denomination_type

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
fixed_denominationsobject
(FixedDenominations)

ใช้ร่วมกับ custom_range ไม่ได้

ใช้เมื่อบัตรของขวัญมีมูลค่าที่เฉพาะเจาะจงและคงที่
custom_rangeobject
(MoneyRange)

ใช้ร่วมกับ fixed_denominations ไม่ได้

ใช้เมื่อแบรนด์อนุญาตให้ผู้ใช้เลือกมูลค่าหน้าตั๋วที่กำหนดเอง (ยืดหยุ่น) ภายในช่วงที่กำหนด

การอัปโหลดฟีด

คุณต้องอัปโหลดฟีดข้อเสนอ ไปยังเซิร์ฟเวอร์ 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
    • ข้อมูลที่เกี่ยวข้องสำหรับ PaymentInstrument Subscription หรือ 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
  • ร้านอาหารเสนอส่วนลด 10% สำหรับลูกค้าที่วอล์กอินและส่วนลด 5% เมื่อชำระเงินด้วย บัตรเครดิตที่เฉพาะเจาะจง ซึ่งสามารถใช้ร่วมกันได้

    • ข้อเสนอสำหรับลูกค้าที่วอล์กอิน 10% ควรติดแท็กเป็น OFFER_CATEGORY_BASE_OFFER
    • ข้อเสนอบัตรเครดิตลด 5% ควรมี 2 รายการ โดยรายการหนึ่งติดแท็กเป็น OFFER_CATEGORY_BASE_OFFER และอีกรายการติดแท็กเป็น OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
  • ร้านอาหารเสนอส่วนลด 10% สำหรับมื้อกลางวันในวันธรรมดาเท่านั้น และส่วนลด 5% ทุกเมื่อ เมื่อชำระเงินด้วยบัตรเครดิตที่เฉพาะเจาะจง

    • ข้อเสนอส่วนลด 10% ควรมี ValidityPeriod ตั้งค่าเพื่อระบุเฉพาะในช่วงเวลาอาหารกลางวันของร้านอาหารในวันธรรมดา
    • ควรส่งสำเนาข้อเสนอบัตรเครดิตที่ลด 5% จำนวน 2 ชุด
      • สำเนาหนึ่งควรติดแท็กเป็น OFFER_CATEGORY_BASE_OFFER โดยมีรายละเอียด PaymentInstrument รวมอยู่ด้วย ValidityPeriod ควรตั้งค่าให้ยกเว้นช่วงเวลาอาหารกลางวันในวันธรรมดาเมื่อข้อเสนอส่วนลด 10% สำหรับมื้อกลางวันใช้งานอยู่
      • สำเนาหนึ่งควรติดแท็กเป็น OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER with the PaymentInstrument พร้อมรายละเอียด
    • ข้อเสนอการชำระเงินอื่นๆ ทั้งหมดสำหรับร้านอาหารนี้ควรติดแท็กเป็น OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER

กระบวนการพัฒนาและการเปิดตัว

ตลอดการผสานรวม 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