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

ข้อเสนอ

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

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

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

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

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

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

• อย่างใดอย่างหนึ่ง
  • ฟีดของผู้ขาย (ใช้การกำหนดค่า Merchant)
  • หรือ ฟีดเอนทิตี (ใช้การกำหนดค่า Generic)
• และ ฟีดข้อเสนอ (ใช้การกำหนดค่า Generic )

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
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)		ระดับความพร้อมใช้งานของข้อเสนอ

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
offer_display_text	สตริง	ต้องระบุ	ข้อความข้อเสนอที่ผู้ให้บริการข้อเสนอต้องการแสดงต่อลูกค้าในหน้าผลการค้นหา โปรดทราบว่าข้อมูลนี้อาจไม่ตรงกับสิ่งที่แสดงต่อผู้ใช้ทุกประการ และเราอาจใช้ข้อมูลเมตาอื่นๆ เพื่อเขียน/เรียบเรียงใหม่ ต้องระบุ
	oneOf (offer_specification)	ต้องระบุ	ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้
max_discount_value	object (Money)		ส่วนลดสูงสุดที่ใช้ได้ เช่น ลด 10% สูงสุด 1, 000 บาท
min_spend_value	object (Money)		มูลค่าการใช้จ่ายขั้นต่ำเพื่อรับส่วนลด เช่น ลด 10% เมื่อราคารวมเท่ากับ 3, 000 บาทขึ้นไป
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)		ตั้งค่าได้เพียงช่องเดียวใน oneOf นี้

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

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
name	สตริง	ต้องระบุ	ชื่อของค่าธรรมเนียมเพิ่มเติม ตัวอย่าง: ค่าธรรมเนียมเพิ่มเติม ค่าธรรมเนียมการจัดการ ฯลฯ ต้องระบุ
fee	object (Fee)

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
	oneOf (denomination_type)		ตั้งค่าได้เพียงช่องเดียวใน oneOf นี้

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
amounts	อาร์เรย์ของออบเจ็กต์ (Money)		รายการมูลค่าที่แยกกันทั้งหมดที่มี (เช่น [100, 500, 1000])

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
combinable_with_other_offers	บูลีน		ข้อเสนอนี้ใช้ร่วมกับข้อเสนออื่นๆ ได้หรือไม่ เมื่อเป็นจริง พาร์ทเนอร์จะระบุได้ว่าข้อเสนอนี้ใช้ร่วมกับข้อเสนอใดได้ หากตั้งค่าทั้ง combinable_offer_categories และ combinable_offer_ids ข้อเสนอที่ตรงกับเงื่อนไขใดเงื่อนไขหนึ่งข้างต้นจะใช้ร่วมกันได้
combinable_offer_categories	อาร์เรย์ของ enum (OfferCategory)		รายการประเภทข้อเสนอที่ข้อเสนอนี้ใช้ร่วมกันได้ เช่น ข้อเสนอนี้ อาจใช้ร่วมกับคูปองอื่นๆ ได้ หาก combinable_with_other_offers เป็นจริงและไม่ได้ตั้งค่าช่องนี้ ระบบจะรวมข้อเสนอทุกประเภทได้
combinable_offer_ids	อาร์เรย์ของสตริง		รายการ offer_id ที่ใช้ร่วมกับข้อเสนอนี้ได้ ข้อเสนอบางรายการอาจใช้ร่วมกับ offer_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	อาร์เรย์ของสตริง		เงื่อนไขพิเศษสำหรับข้อเสนอนี้ที่ต้องแสดงต่อผู้ใช้ ตัวอย่าง: "ใช้ได้เฉพาะการชำระเงินใน [พื้นที่]", "ไม่รวมการชำระเงินออนไลน์", "ใช้บัตรกำนัลได้ในช่วงลดราคา"

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

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
meal_types	อาร์เรย์ของ enum (MealType)		ประเภทอาหารที่ใช้ข้อเสนอได้ เช่น อาหารกลางวันหรืออาหารเย็น หากไม่ได้ตั้งค่า ข้อเสนอจะใช้ได้กับอาหารทุกประเภท
restricted_to_certain_courses	บูลีน		ข้อเสนอใช้ได้กับบางหลักสูตรเท่านั้นหรือไม่

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
text	สตริง		ข้อความคูปองที่ผู้ให้บริการข้อเสนอต้องการแสดงต่อผู้ใช้
code	สตริง	ต้องระบุ	ต้องระบุรหัสคูปองเพื่อแลกสิทธิ์ข้อเสนอ ต้องระบุ

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
items	อาร์เรย์ของออบเจ็กต์ (PaymentInstrumentItem)	ต้องระบุ	รายการเครื่องมือการชำระเงินที่ใช้รับข้อเสนอได้ ต้องระบุ
provider_name	สตริง		ชื่อผู้ให้บริการเครื่องมือการชำระเงิน อาจเป็นพาร์ทเนอร์ด้านการธนาคาร ชื่อธนาคาร ฯลฯ เช่น American Express, HDFC, ICICI

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
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 วินาทีจะแสดงด้วยช่อง seconds ที่มีค่าเป็น 0 และช่อง nanos ที่มีค่าเป็นบวกหรือลบ สำหรับระยะเวลาตั้งแต่ 1 วินาทีขึ้นไป ค่าที่ไม่ใช่ 0 สำหรับช่อง nanos ต้องมีเครื่องหมายเดียวกับช่อง seconds ต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
url	สตริง		URL ของข้อกำหนดและเงื่อนไขของพาร์ทเนอร์
restricted_to_certain_users	บูลีน		ข้อเสนอจำกัดไว้สำหรับผู้ใช้บางรายหรือไม่
terms_and_conditions	สตริง		ข้อความข้อกำหนดและเงื่อนไขหลักที่พาร์ทเนอร์ระบุ
additional_terms_and_conditions	อาร์เรย์ของสตริง		ข้อกำหนดและเงื่อนไขเพิ่มเติมจากข้อกำหนดและเงื่อนไขหลักของพาร์ทเนอร์

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
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	ตัวเลข		ระยะเวลา (เป็นวัน) ที่บัตรกำนัล/คูปองใช้ได้เมื่อซื้อแล้ว

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
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	ตัวเลข		เศษส่วนของวินาทีที่ไม่เป็นลบที่ความละเอียดระดับนาโนวินาที ช่องนี้เป็นส่วนนาโนวินาทีของระยะเวลา ไม่ใช่ทางเลือกแทนวินาที ค่าวินาทีที่เป็นลบซึ่งมีเศษส่วนยังคงต้องมีค่า nanos ที่ไม่เป็นลบซึ่งนับเวลาไปข้างหน้า ต้องอยู่ระหว่าง 0 ถึง 999,999,999 รวมด้วย

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
time_windows	object (TimeOfDayRange)	ต้องระบุ	กรอบเวลาที่สามารถสั่งซื้อ/ดำเนินการตามคำสั่งซื้อได้ ต้องระบุ
day_of_week	อาร์เรย์ของ enum (DayOfWeek)		รายการวันในสัปดาห์ที่มีการใช้กรอบเวลา หากไม่ได้ตั้งค่าไว้ หมายความว่านโยบายนี้จะมีผลกับทุกวันในสัปดาห์ ไม่บังคับ
day_of_month	อาร์เรย์ของออบเจ็กต์ (DayOfMonthRange)		วันที่ในเดือนที่มีการใช้ช่วงเวลา หากไม่ได้ตั้งค่าใดๆ หมายความว่าจะมีผลกับทุกวันในเดือน ไม่บังคับ

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
open_time	object (TimeOfDay)		เวลาที่ระบุเวลาเริ่มต้นของวันในช่วง (รวม) หากไม่ได้ตั้งค่า หมายความว่า 00:00:00 ไม่บังคับ
close_time	object (TimeOfDay)		เวลาที่ระบุเวลาสิ้นสุดของวันในช่วง (ไม่รวม) หากไม่ได้ตั้งค่าไว้ ระบบจะถือว่าเป็นเวลา 23:59:59 น. ไม่บังคับ

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
hours	ตัวเลข		ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ต้องมากกว่าหรือเท่ากับ 0 และ โดยปกติแล้วต้องน้อยกว่าหรือเท่ากับ 23 API อาจเลือกอนุญาตค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการของธุรกิจ
minutes	ตัวเลข		นาทีของชั่วโมง ต้องมากกว่าหรือเท่ากับ 0 และน้อยกว่าหรือเท่ากับ 59
seconds	ตัวเลข		วินาทีของนาที ต้องมากกว่าหรือเท่ากับ 0 และโดยทั่วไปต้องน้อยกว่าหรือเท่ากับ 59 API อาจอนุญาตค่า 60 หากอนุญาต วินาทีอธิกสุรทิน
nanos	ตัวเลข		เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องมากกว่าหรือเท่ากับ 0 และน้อยกว่าหรือเท่ากับ 999,999,999

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
valid_from_day	ตัวเลข	ต้องระบุ	วันเริ่มต้นของช่วง (รวมวันที่เริ่มต้น) ต้องระบุ
valid_through_day	ตัวเลข		วันสิ้นสุดของช่วง (รวมวันสิ้นสุด) หากไม่ได้ตั้งค่าไว้ หมายความว่าช่วงนี้แสดงถึงวันเดียว (valid_from_day) ไม่บังคับ

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
exceptional_period	object (ValidityRange)		การประทับเวลาเริ่มต้นและสิ้นสุดที่ข้อเสนอใช้ไม่ได้ เวลาเหล่านี้ต้องแสดงถึงวันที่แตกต่างกัน กล่าวคือ เวลาเริ่มต้นต้องเป็น 00:00 น. (ต้นวัน) และเวลาสิ้นสุดต้องเป็น 00:00 น. (ไม่รวม) ในวันที่ระยะเวลาการยกเว้นสิ้นสุดลง

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
year	ตัวเลข		ปีของวันที่ ต้องมีค่าตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี
month	ตัวเลข		เดือนของปี ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day	ตัวเลข		วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียวหรือปีและเดือนที่วันที่ไม่ สำคัญ

ชื่อ	คำอธิบาย
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

ชื่อ	คำอธิบาย
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY	ข้อเสนอนี้ใช้ได้กับบริการนำส่งอาหาร
ACTION_TYPE_FOOD_TAKEOUT	ข้อเสนอนี้ใช้ได้กับการสั่งอาหารกลับบ้านหรือคำสั่งซื้อแบบไปรับเอง
ACTION_TYPE_DINING	ข้อเสนอใช้สำหรับการรับประทานอาหารที่ร้านอาหาร
ACTION_TYPE_APPOINTMENT	ข้อเสนอนี้ใช้ได้กับบริการจองเวลานัดหมาย
ACTION_TYPE_SHOPPING_IN_STORE	ข้อเสนอนี้ใช้ได้กับการซื้อสินค้าในร้านค้าออฟไลน์

ชื่อ	คำอธิบาย
OFFER_MODE_OTHER	ใช้สำหรับวิธีการปฏิบัติตามคำสั่งซื้อที่โหมดอื่นๆ ที่เฉพาะเจาะจงไม่ครอบคลุม
OFFER_MODE_WALK_IN	ข้อเสนอนี้มีให้บริการสำหรับการเข้าชมในสถานที่โดยไม่ต้องจองล่วงหน้า
OFFER_MODE_FREE_RESERVATION	ข้อเสนอนี้จะมีผลเมื่อผู้ใช้ทำการจองที่ไม่ต้องชำระค่าธรรมเนียมล่วงหน้า
OFFER_MODE_PAID_RESERVATION	ข้อเสนอจะมีผลเมื่อผู้ใช้ทำการจองที่ต้องชำระเงินล่วงหน้า
OFFER_MODE_ONLINE_ORDER	ข้อเสนอนี้ใช้ได้กับคำสั่งซื้อที่ดำเนินการผ่านเว็บไซต์หรือแพลตฟอร์มดิจิทัล
OFFER_MODE_GIFT_CARD_PURCHASE	ระบุว่าการซื้อบัตรของขวัญเป็นขั้นตอนหลักที่จำเป็นในการรับดีล

ชื่อ	คำอธิบาย
OFFER_CATEGORY_UNSPECIFIED	ไม่ควรใช้ค่า enum ที่ไม่ได้ระบุหรือค่าเริ่มต้นในฟีด
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

ชื่อ	คำอธิบาย
FEE_UNIT_UNSPECIFIED	ไม่ควรใช้ค่า enum ที่เป็น UNSPECIFIED หรือค่าเริ่มต้นในฟีด
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

ชื่อ	คำอธิบาย
FEE_TYPE_UNSPECIFIED	ไม่ควรใช้ค่า enum UNSPECIFIED หรือค่าเริ่มต้นในฟีด
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

ชื่อ	คำอธิบาย
OFFER_DISCOUNT_TYPE_UNSPECIFIED
OFFER_DISCOUNT_TYPE_INSTANT_DISCOUNT
OFFER_DISCOUNT_TYPE_CASHBACK
OFFER_DISCOUNT_TYPE_REWARD_POINT

ชื่อ	คำอธิบาย
MEAL_TYPE_UNSPECIFIED	ไม่ควรใช้ค่า enum ที่เป็น UNSPECIFIED หรือค่าเริ่มต้นในฟีด
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

ชื่อ	คำอธิบาย
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED	ไม่ควรใช้ค่า enum ที่ไม่ระบุหรือค่าเริ่มต้นในฟีด
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	วันอาทิตย์

ชื่อ	คำอธิบาย
VALIDITY_SCOPE_UNSPECIFIED
VALIDITY_SCOPE_CLAIM
VALIDITY_SCOPE_REDEEM

ชื่อ	คำอธิบาย
OFFER_TAG_UNSPECIFIED	ไม่ควรใช้ค่า enum UNSPECIFIED หรือค่าเริ่มต้นในฟีด
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

ชื่อ	คำอธิบาย
AVAILABILITY_LEVEL_UNSPECIFIED
AVAILABILITY_LEVEL_LOW	ระบุว่าข้อเสนอมีจำนวนเหลือน้อย เราขอแนะนำให้ผู้ใช้แลกรับรางวัลก่อนที่รางวัลจะหมด เราอาจเพิ่มระดับปานกลางและสูงในภายหลัง

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

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
amount	object (Money)	ใช้ร่วมกับ amount_range ไม่ได้
amount_range	object (MoneyRange)	ไม่รวมกับ amount

ชื่อช่อง	ประเภท	ข้อกำหนด	คำอธิบาย
fixed_denominations	object (FixedDenominations)	ไม่รวมกับ custom_range	ใช้เมื่อบัตรของขวัญมีจำนวนเงินที่เฉพาะเจาะจงและคงที่
custom_range	object (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 จะช่วยให้ข้อมูลและความคิดเห็นเกี่ยวกับการพัฒนาของคุณได้ กระบวนการพัฒนาจะเป็นไปตามขั้นตอนต่อไปนี้

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

การตรวจสอบ

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

ตรวจสอบว่าหน้าเว็บใช้เวลาโหลดน้อยกว่า 5 วินาที เพื่อโหลดข้อเสนอทั้งหมด ไม่เช่นนั้นระบบจะถือว่าไม่สำเร็จและจะแจ้งว่าBad link

การตรวจสอบอัตโนมัติ (Crawler)

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

จำนวนคำค้นหา

ตัวอย่างเช่น หากเราตัดสินใจส่งการตรวจสอบ 5,000 ครั้งต่อวัน หมายความว่า 5,000 ครั้งต่อวัน (กระจายอย่างสม่ำเสมอตลอดทั้งวัน ซึ่งเท่ากับประมาณ 1 ครั้งทุกๆ 17 วินาที) Crawler ของเราจะดำเนินการต่อไปนี้ทั้งหมดที่ผู้ใช้ทั่วไปจะทำ

• เริ่มจาก Google Search แล้วคลิกลิงก์พาร์ทเนอร์
• มองหาข้อมูลข้อเสนอ
• หากข้อเสนอกำหนดให้ต้องจอง ระบบจะดำเนินการต่อในขั้นตอนการจองเพื่อยืนยันว่าข้อเสนอพร้อมให้บริการในเวลาที่ระบุ (จะไม่มีการจอง)

การตรวจจับ Web Scraper

โปรดตรวจสอบว่าระบบอนุญาตให้ 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 และ Crawler อื่นๆ ของ Google" ในกรณีของเรา การแปลง DNS แบบย้อนกลับจะเป็นไปตามรูปแบบนี้ google-proxy-***-***-***-***.google.com

ลักษณะการทำงานทางเทคนิค

กำลังแคช

โดยทั่วไปแล้ว โปรแกรมรวบรวมข้อมูลของเราได้รับการกำหนดค่าให้ยึดตามส่วนหัวการแคช HTTP มาตรฐานทั้งหมดที่มีอยู่ในการตอบกลับ เพื่อลดภาระงานในเว็บไซต์พาร์ทเนอร์ ซึ่งหมายความว่าสำหรับเว็บไซต์ที่กำหนดค่าอย่างถูกต้อง เราจะหลีกเลี่ยงการดึงข้อมูลเนื้อหาที่เปลี่ยนแปลงไม่บ่อย (เช่น ไลบรารี JavaScript) ซ้ำๆ อ่านรายละเอียดเพิ่มเติมเกี่ยวกับวิธีใช้การแคชได้ในเอกสารประกอบเกี่ยวกับการแคช HTTP