บัตรของขวัญ (หรือที่เรียกว่าบัตรกำนัล)

คู่มือนี้จะอธิบายข้อกำหนด คำแนะนำในการสร้างโมเดลข้อมูล และแนวทางปฏิบัติแนะนำสำหรับการใช้บัตรของขวัญ (หรือที่เรียกว่าบัตรกำนัล) ในฟีดข้อเสนอ คำแนะนำเหล่านี้จะช่วยเสริมเอกสารประกอบมาตรฐานของศูนย์การดำเนินการ และกล่าวถึงแง่มุมการผสานรวมเฉพาะบัตรของขวัญ

โหมดข้อเสนอและการจัดหมวดหมู่

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

  • โหมดข้อเสนอ: offer_modes ต้องตั้งค่าเป็นอาร์เรย์แบบ Singleton เสมอ ซึ่งมี "OFFER_MODE_GIFT_CARD_PURCHASE":

    "offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]

  • บัตรกำนัลที่มีมูลค่าที่เก็บไว้เทียบกับส่วนลดทันทีสำหรับลูกค้าที่เข้ามาใช้บริการ:

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

  • การประมาณมูลค่า: มูลค่าบัตรของขวัญควรแสดงถึงมูลค่าของบัตรกำนัล (สิ่งที่แลกได้) ไม่ใช่สิ่งที่ผู้ใช้ชำระ (ผู้ใช้ชำระราคาที่ลดแล้ว)

  • การรวมมูลค่าหลายรายการ: บัตรกำนัลหลายใบที่มีส่วนลดและข้อกำหนดเหมือนกันทุกประการ แต่มีมูลค่าหน้าบัตรแตกต่างกันจะต้อง จัดกลุ่มไว้ในรายการข้อเสนอเดียว เนื่องจาก denomination_type ทำงานเป็น oneof พาร์ทเนอร์จึงต้องเลือกระหว่างการตั้งค่า fixed_denominations หรือ custom_range

    • มูลค่าคงที่: ใช้เมื่อมีการเสนอจำนวนเงินในบัตรของขวัญที่แยกกันและกำหนดไว้ล่วงหน้า (เช่น ₹500, ₹1,000 และ ₹2,000 โดยทั้งหมดมีส่วนลด 10% คงที่) ตรวจสอบว่าได้ยกเว้นมูลค่าคงที่ที่ขายหมดแล้วหรือไม่พร้อมให้บริการในหน้า Landing Page จากการส่งฟีดอย่างชัดเจน
    • ช่วงที่กำหนดเอง: ใช้เฉพาะเมื่อผู้ใช้ป้อนมูลค่าหน้าตั๋วใดก็ได้ อย่างอิสระภายในขอบเขตที่กำหนดในหน้าการซื้อ (เช่น มูลค่าใดก็ได้ ระหว่าง ₹100 ถึง ₹5,000 พร้อมส่วนลด 5%) หากหน้า Landing Page ปลายทางมีจำนวนเงินที่แยกกันและกำหนดไว้ล่วงหน้า ให้สร้างรูปแบบพื้นที่โฆษณาภายใต้ fixed_denominations อย่างเคร่งครัด นอกจากนี้ หากข้อเสนอมีทั้งมูลค่าคงที่และมูลค่าที่กำหนดเอง พาร์ทเนอร์ควรตั้งค่าช่วงที่กำหนดเองแบบยืดหยุ่น

ฟีเจอร์ที่ไม่รองรับ: เกณฑ์การซื้อขั้นต่ำ / เกณฑ์การเรียกเก็บเงินขั้นต่ำ (min_spend_value)

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

ข้อเสนอที่กำหนดให้มีมูลค่าธุรกรรมขั้นต่ำเพื่อแลกรับบัตรกำนัลที่มีมูลค่าที่เก็บไว้ (เช่น "ซื้อบัตรกำนัลมูลค่า ₹800 ในราคา ₹150 ซึ่งจะแลกรับได้เมื่อมียอดเรียกเก็บเงินขั้นต่ำ ₹5,000 ขึ้นไปเท่านั้น") อยู่นอกขอบเขตปัจจุบันของการผสานรวมข้อเสนอของศูนย์การดำเนินการเนื่องจากเหตุผลต่อไปนี้

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

ขอให้พาร์ทเนอร์ดำเนินการ

หากพื้นที่โฆษณามีโปรโมชันบัตรกำนัลที่มีการเรียกเก็บเงินขั้นต่ำแบบมีเงื่อนไข ให้ทำดังนี้

  • นำออกจากฟีด: อย่าส่งบัตรกำนัลที่มีเงื่อนไขการใช้จ่ายขั้นต่ำ โดยใช้ OFFER_MODE_GIFT_CARD_PURCHASE (หรือพยายามหลีกเลี่ยงโดย ส่งบัตรกำนัลดังกล่าวภายใต้ OFFER_MODE_WALK_IN) นำโปรโมชันที่เฉพาะเจาะจงเหล่านี้ ออกจากไฟล์ส่งออกฟีดทั้งหมด
  • คำขอพิจารณาฟีเจอร์อีกครั้ง: หากเชื่อว่าบัตรกำนัลที่มีเงื่อนไข การเรียกเก็บเงินขั้นต่ำเหล่านี้แสดงถึงมูลค่าทางธุรกิจที่สำคัญ คุณสามารถแชร์ ข้อมูลที่อธิบายรายละเอียดผลกระทบต่อความครอบคลุมของผู้ขาย อัตรา Conversion ของธุรกรรม และปริมาณโดยรวมกับผู้ติดต่อของ Google (POC) ทีมวิศวกรของเราอาจตรวจสอบเมตริกเหล่านี้เพื่อประเมินการรองรับในอนาคต แต่โปรดทราบว่าการให้ข้อมูลไม่ได้เป็นการรับประกันว่าเราจะจัดลําดับความสําคัญหรือรองรับฟีเจอร์นี้

การจัดการเชนที่มีหลายสาขา

สำหรับบัตรกำนัลที่ใช้ได้ในเครือข่ายร้านค้าปลีกหรือร้านอาหารขนาดใหญ่ซึ่งมีข้อกำหนดเหมือนกันในจุดที่น่าสนใจ (POI) หลายแห่ง โปรดอย่า ระบุออบเจ็กต์ข้อเสนอแยกต่างหากสำหรับร้านค้าแต่ละแห่ง แต่ให้ใช้ วิธีการป้อนข้อมูลแบบรวมโดยระบุออบเจ็กต์ข้อเสนอเดียวที่มีรายการ รหัสเอนทิตีร้านค้าทั้งหมดที่เข้าร่วม (entity_ids)

การสร้างแบรนด์พอร์ทัล (brand_id)

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

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

โครงสร้างความถูกต้อง (ValidityScope)

บัตรของขวัญมีโครงสร้างความถูกต้องที่ไม่ซ้ำกันซึ่งแยกกรอบเวลาในการซื้อดีลออกจากระยะเวลาในการแลกสิทธิ์บัตร พาร์ทเนอร์ต้องใช้ค่าแจกแจง ValidityScope ที่เกี่ยวข้องเสมอ

  • VALIDITY_SCOPE_CLAIM: กำหนดกรอบเวลาที่ข้อเสนอบัตรของขวัญพร้อมให้ซื้อในแพลตฟอร์มพาร์ทเนอร์ ต้องมีรายการนี้เสมอ เมื่อส่งฟีด ให้ระบุระยะเวลาที่อ้างสิทธิ์ได้ โดยเริ่มจากวันที่ส่งฟีดที่แน่นอน นอกจากนี้ อย่าปล่อยให้ระยะเวลาการอ้างสิทธิ์ ไม่มีกำหนดหากหน้า Landing Page โฆษณาวันที่สิ้นสุดของแคมเปญอย่างชัดเจน ให้ตรงกับวันที่หมดอายุที่โฆษณาvalid_through_time
  • VALIDITY_SCOPE_REDEEM: กำหนดระยะเวลาการแลกรับข้อเสนอหลังการซื้อ (กรอบเวลาที่ผู้ใช้ต้องแลกรับบัตรกำนัลที่ร้านค้าหลังจากซื้อ ซึ่งระบุเป็นระยะเวลาหรือกรอบเวลาได้)

การแมปประเภทการดำเนินการ

พาร์ทเนอร์มักจัดหมวดหมู่บัตรกำนัลโดยใช้โครงสร้าง เช่น "แลกสิทธิ์ ออนไลน์/ออฟไลน์" "ออนไลน์/เอาต์เล็ต" หรือ "ในร้านค้า" ในการส่งฟีด คุณต้อง เชื่อมโยงค่านี้กับ ActionType enum เพื่อกำหนดวิธีใช้ผลิตภัณฑ์อย่างถูกต้อง

  • ธุรกิจร้านอาหาร / อาหาร: แมปบัตรของขวัญ "ทานที่ร้าน" กับ ACTION_TYPE_DINING แมปบัตรของขวัญ "การนำส่ง" ไปยัง ACTION_TYPE_FOOD_DELIVERY แมปบัตรของขวัญ "สั่งกลับบ้าน" ไปยัง ACTION_TYPE_FOOD_TAKEOUT
  • ธุรกิจค้าปลีกของ Shopping: แมปบัตรของขวัญ "ในร้านค้า" กับ ACTION_TYPE_SHOPPING_IN_STORE (หมายเหตุ: ระบบไม่รองรับบัตรกำนัลสำหรับร้านค้าปลีกที่ใช้ทางออนไลน์เท่านั้น)
  • การแมปช่องเดียว: offer_id แต่ละรายการเป็นของ ActionType ได้เพียงรายการเดียวเท่านั้น หากสินค้าคงคลังรองรับช่องทางการปฏิบัติตามคำสั่งซื้อหลายช่องทาง (เช่น ทั้งการนำส่งอาหารและการซื้อกลับบ้าน) ให้สร้างออบเจ็กต์ข้อเสนอที่แตกต่างกันโดยมี รหัสที่ไม่ซ้ำกันสำหรับแต่ละโหมด

ส่วนลดตามลำดับชั้นและข้อเสนอส่วนเสริม

  • ส่วนลดแบบเป็นขั้นตามวิธีการชำระเงิน: หากมีส่วนลด เป็นเปอร์เซ็นต์ที่แตกต่างกันตามเครื่องมือการชำระเงินที่เฉพาะเจาะจงที่ใช้ (เช่น ส่วนลดที่สูงกว่าสำหรับกระเป๋าเงินอิเล็กทรอนิกส์เมื่อเทียบกับบัตรเครดิต) คุณจะต้อง สร้างโมเดลเป็นออบเจ็กต์ข้อเสนอแยกต่างหาก พาร์ทเนอร์ควรให้ความครอบคลุมด้านโปรโมชันอย่างละเอียด ในเครื่องมือการชำระเงินที่รองรับทั้งหมด (เช่น กระเป๋าเงินอิเล็กทรอนิกส์ บัตรเครดิต บัตรเดบิต การธนาคารทางอินเทอร์เน็ต) เพื่อให้มั่นใจว่าผู้ใช้จะได้รับประสบการณ์การประหยัดที่เชื่อถือได้ หากข้อเสนอใช้ได้กับวิธีการชำระเงินทั้งหมด ที่ยอมรับในแพลตฟอร์ม คุณไม่ควรตั้งค่าฟิลด์เครื่องมือการชำระเงิน
  • โครงสร้างข้อเสนอเสริม: หากต้องการแสดงสิทธิประโยชน์ที่ซ้อนกัน เช่น คะแนนสะสมเฉพาะธนาคารหรือแคชแบ็กเพิ่มเติมที่ใช้ได้กับการซื้อบัตรของขวัญ ให้ส่งเป็นข้อเสนอเสริมที่แยกกันโดยใช้ OfferCategory enum - OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER ที่เหมาะสม อธิบายรางวัลภายใน OfferDetails.other_offer_details_text (เช่น "คะแนนสะสมสูงสุด 5 เท่า") และลิงก์กับดีลบัตรของขวัญพื้นฐานโดย ป้อนข้อมูล OfferRestrictions.combinable_offer_ids ด้วย offer_id ของบัตรของขวัญพื้นฐาน

ข้อกำหนดและเงื่อนไขพิเศษ

พาร์ทเนอร์ควรใช้ terms.terms_and_conditions เพื่อระบุข้อกำหนดและเงื่อนไขทางกฎหมายทั้งหมดของบัตรของขวัญหรือบัตรกำนัล รวมคำสั่งที่ผู้ใช้มองเห็นและหลักเกณฑ์การใช้งานทั้งหมดไว้ในช่องนี้

หากข้อจำกัดที่สำคัญกำหนดให้ต้องมีการแสดง UI ที่เฉพาะเจาะจง (เช่น การหมดอายุของยอดคงเหลือแบบใช้ครั้งเดียว การไม่คืนเงิน หรือขีดจำกัดการรวมธุรกรรม เช่น "รวมบัตรกำนัลได้สูงสุด 2 ใบต่อใบเรียกเก็บเงิน") ให้ไฮไลต์ข้อจำกัดเหล่านั้นในoffer_restrictions.special_conditions

คำแนะนำชื่อข้อเสนอ

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

กรณีการใช้งาน ตำแหน่งที่แนะนำ
ส่วนลดแบบคงที่สำหรับบัตรกำนัล X% off on Gift Cards
ส่วนลดแบบผันแปรตามวิธีการชำระเงิน X% off on Gift Cards using {e-wallet}
ส่วนลดแบบผันแปรสำหรับ มูลค่าต่างๆ X% off on Gift Cards (ส่งส่วนลดที่แตกต่างกันเป็นข้อเสนอแยกต่างหาก)
บัตรของขวัญ B2B2C X% off on Gift Cards (การสร้างแบรนด์จะ แสดงผ่านภาพปกโดยใช้ brand_id)
ข้อเสนอเสริม Flat/Up to 5X reward points/ <Platform> coins

ข้อกำหนดของหน้า Landing Page

offer_url ที่โฆษณาทุกรายการต้องแสดงผล HTTP 200 OK โดยตรงโดยไม่มี การเปลี่ยนเส้นทางระดับกลาง และต้องเปลี่ยนเส้นทางไปยังหน้าปลายทางที่ใช้งานอยู่ซึ่งยืนยัน ข้อเสนอ

ฟีดต้องไม่มีมูลค่าที่ขายหมดแล้วหรือไม่พร้อมให้บริการ รักษาระดับการซิงค์ สินค้าคงคลังอย่างเคร่งครัดระหว่างฟิลด์การระบุฟีดกับตัวเลือกการซื้อแบบเรียลไทม์ ในหน้า Landing Page ของปลายทาง

หน้า Landing Page ปลายทางควรระบุอย่างชัดเจนว่าข้อเสนอใช้ได้กับบัตรของขวัญหรือบัตรกำนัลโดยเฉพาะ

ตัวอย่างเช่น หากหน้า Landing Page ของพาร์ทเนอร์แสดงเฉพาะคำกระตุ้นให้ดำเนินการ (Call-To-Action) ในการชำระเงินทั่วไป เช่น "ชำระบิล" โดยไม่ได้ระบุอย่างชัดเจนตั้งแต่แรกว่าการทำธุรกรรมให้เสร็จสมบูรณ์จะออกบัตรกำนัลบัตรของขวัญที่มีมูลค่าที่เก็บไว้ ผู้ใช้ที่เปลี่ยนเส้นทางจาก Google โดยคาดหวังว่าจะซื้อบัตรของขวัญอาจสับสนหรือละทิ้งการซื้อ แม้ว่าประกาศบัตรกำนัลจะปรากฏในขั้นตอนการชำระเงินในภายหลัง แต่คุณก็ยังต้องระบุข้อมูลอย่างชัดเจนในหน้า Landing Page เริ่มต้น

ข้อเสนอที่มีรหัสคูปอง

ข้อเสนอบางอย่างกำหนดให้ผู้ใช้ต้องป้อนรหัสคูปอง เช่น "ใช้รหัส SAVE20 เพื่อรับส่วนลด 20% สำหรับยอดเงินทั้งหมด" โปรดทราบว่า Google ไม่แสดงรหัสคูปองจากคำจำกัดความของคูปอง พาร์ทเนอร์อาจรวมข้อมูลนี้ไว้ใน OfferDetails.offer_display_text เพื่อให้แสดงต่อผู้ใช้ โดยทั่วไปแล้ว ข้อเสนอที่อิงตามคูปองจะแบ่งออกเป็น 2 หมวดหมู่ ดังนี้

  • ข้อเสนอที่ระบบแสดงคูปองโดยอัตโนมัติที่จุดชำระเงินต่อผู้ใช้ที่มาจาก Google ซึ่งเราอนุญาตให้ทำได้
  • ไม่อนุญาตให้ใช้ข้อเสนอที่กำหนดให้ผู้ใช้ป้อนรหัสคูปองในระหว่างชำระเงิน แต่ไม่ได้ ระบุวิธีการใช้รหัสคูปองในหน้า Landing Page ของ URL ข้อเสนอ หรือไม่ได้ใช้คูปองโดยอัตโนมัติเมื่อทำตาม URL ข้อเสนอ

ตัวอย่าง JSON ของข้อเสนอบัตรของขวัญ

{
  "data": [
    {
      "offer_id": "example-dining-gift-card-10off",
      "entity_ids": [
        "dining-1",
        "dining-2"
      ],
      "offer_modes": [
        "OFFER_MODE_GIFT_CARD_PURCHASE"
      ],
      "action_type": "ACTION_TYPE_DINING",
      "offer_source": "OFFER_SOURCE_AGGREGATOR",
      "offer_category": "OFFER_CATEGORY_BASE_OFFER",
      "offer_details": {
        "offer_display_text": "10% off on Gift Cards",
        "discount_percent": 10.0,
        "gift_card_info": {
          "fixed_denominations": {
            "amounts": [
              {
                "units": 500,
                "currency_code": "INR"
              },
              {
                "units": 1000,
                "currency_code": "INR"
              },
              {
                "units": 2000,
                "currency_code": "INR"
              }
            ]
          }
        }
      },
      "offer_restrictions": {
        "combinable_with_other_offers": false,
        "special_conditions": [
          "Single-use balance expiration applies",
          "Maximum 2 gift card vouchers can be combined per bill",
          "No cash refund will be provided against this voucher"
        ]
      },
      "terms": {
        "restricted_to_certain_users": false,
        "terms_and_conditions": "1. Redeemable exclusively at participating dining outlets.\n2. Single-use balance expiration applies.\n3. Maximum 2 gift card vouchers can be combined per bill.\n4. No cash refund will be provided against this voucher."
      },
      "validity_periods": [
        {
          "valid_period": {
            "valid_from_time": {
              "seconds": "1774934350"
            },
            "valid_through_time": {
              "seconds": "1806470350"
            }
          },
          "validity_scope": "VALIDITY_SCOPE_CLAIM"
        },
        {
          "validity_duration_in_days": 365,
          "validity_scope": "VALIDITY_SCOPE_REDEEM"
        }
      ],
      "offer_url": "https://www.example-portal.com/dining-gift-cards/buy"
    }
  ]
}