แค็ตตาล็อก

API ข้อเสนอ

API ข้อเสนอใช้งานได้ในโปรแกรมเวอร์ชั่นเบต้าที่ปิดและต้องได้รับเชิญเท่านั้น โปรดติดต่อตัวแทน Meta ของคุณเพื่อขอสิทธิ์การเข้าถึง หากคุณได้รับเชิญให้เข้าร่วมโปรแกรม


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

สร้างข้อเสนอ

คุณสามารถสร้างข้อเสนอได้ผ่านฟีดข้อเสนอ หรือสร้างด้วยตนเองผ่านตัวจัดการการค้า

ฟีด

หากต้องการสร้างฟีดข้อเสนอ ให้ส่งคำขอ POST ไปยังจุดเชื่อมโยง/{product_catalog_id}/product_feeds และตั้งค่า feed_type เป็น OFFER เมื่อโพสต์ไปยังจุดเชื่อมโยงนี้ ฟีดสินค้าของประเภทข้อเสนอจะถูกสร้างขึ้นสำหรับแค็ตตาล็อกที่ระบุไว้ในช่อง product_catalog_id

เมื่อสร้างฟีดข้อเสนอแล้ว คุณสามารถอัพโหลดข้อมูลข้อเสนอได้ผ่านคำขอ POST ไปยังจุดเชื่อมโยง /{product_feed_id}/uploads

คอลัมน์ฟีด

คุณสามารถตั้งค่าช่องที่พร้อมใช้งานส่วนมากในรายการด้านล่างเป็นคอลัมน์ในไฟล์ฟีดของคุณได้ ส่วนช่องที่ระบุว่า "อ่านเท่านั้น" จะไม่สามารถตั้งค่าระหว่างการสร้างได้

อภิธานศัพท์

ชุดสินค้า

ชุดสินค้าคือกลุ่มสินค้าที่คล้ายกันในแค็ตตาล็อกสินค้า

รายการสินค้าเป้าหมายของข้อเสนอ

รายการเหล่านี้คือสินค้าที่สามารถใช้ข้อเสนอด้วยได้

ข้อกำหนดเบื้องต้นของข้อเสนอ

รายการเหล่านี้คือข้อกำหนดเบื้องต้นที่ต้องตรงตามเกณฑ์ก่อนจึงจะใช้ข้อเสนอได้ ตัวอย่างเช่น คุณสามารถกำหนดว่าข้อเสนอจะใช้ได้ก็ต่อเมื่อผู้คนซื้อสินค้าครบจำนวนหนึ่งหรือซื้อสินค้าถึงยอดรวมหรือมูลค่าที่กำหนด ขณะนี้ สินค้าที่เป็นข้อกำหนดเบื้องต้นเป็นสินค้าที่มาจากสินค้าเป้าหมาย ตัวอย่างเช่น ข้อเสนอส่วนลด 20% สำหรับรองเท้าทั้งหมดหมายความว่ารองเท้าในรถเข็นต้องตรงตามข้อกำหนดยอดรวม/จำนวนขั้นต่ำ

ประเภทการใช้งานของข้อเสนอ

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

ช่องพื้นฐาน

ช่องด้านล่างนี้สามารถใช้เพื่อกำหนดค่าประเภทข้อเสนอทั้งหมด

ช่องคำอธิบาย

id

ประเภท: numeric string

อ่านเท่านั้น

ตัวระบุที่ไม่ซ้ำกัน (Facebook ID) สำหรับรายการสินค้านี้

offer_id

ประเภท: string

จำเป็นต้องระบุ

ตัวระบุที่ผู้ขายแจ้งสำหรับข้อเสนอ


ช่องนี้ใช้เพื่อระบุข้อเสนออย่างไม่ซ้ำกันภายในแค็ตตาล็อกหนึ่งๆ

title

ประเภท: string

ระบุหรือไม่ก็ได้

ชื่อรายการข้อเสนอ


ขณะนี้มีการใช้ชื่อนี้เพื่อช่วยระบุข้อเสนอภายในตัวจัดการการค้าเท่านั้น และไม่แสดงต่อผู้ซื้อ

description

ประเภท: string

อ่านเท่านั้น

คำอธิบายที่สร้างอัตโนมัติเกี่ยวกับข้อเสนอ

application_type

ประเภท: enum{SALE, AUTOMATIC_AT_CHECKOUT, BUYER_APPLIED}

จำเป็นต้องระบุ

กำหนดวิธีและเวลาที่ใช้ข้อเสนอ ตัวเลือกที่มีได้แก่

  • SALE: รายการสินค้ามีการลดราคาโดยตรง ซึ่งแสดงให้ผู้ซื้อเห็นในรูปแบบราคาที่ถูกขีดทับ ข้อเสนอเหล่านี้ไม่กำหนดให้ผู้ซื้อต้องดำเนินการตามข้อกำหนดเบื้องต้น และไม่ได้รับผลกระทบจากรายการสินค้าชื้นอื่นๆ ในขั้นตอนการชำระเงิน การลดราคาที่ให้ราคาสินค้าต่ำที่สุดจะถูกเลือกไว้เสมอ เนื่องจากไม่มีการใช้การลดราคาร่วมกันในทุกกรณี การลดราคาสามารถใช้ร่วมกับข้อเสนอประเภทอื่นได้ แต่การลดราคาจะมีผลก่อนเสมอ หากสินค้ามีการกำหนดช่อง sale_price ไว้แล้ว ระบบจะคำนวณราคาขั้นสุดท้ายโดยใช้ sale_price เป็นราคาฐาน
  • AUTOMATIC_AT_CHECKOUT: ข้อเสนอจะมีผลโดยอัตโนมัติในขั้นตอนการชำระเงิน เมื่อผู้ซื้อมีคุณสมบัติตรงตามเกณฑ์การแลกรับที่จำเป็น ข้อเสนอนี้มีการกำหนดค่าบางประการที่ส่งผลให้ข้อเสนอไม่มีคุณสมบัติเป็นการลดราคา โดยสามารถใช้ร่วมกับข้อเสนอการลดราคาเท่านั้น และใช้ข้อเสนอดังกล่าวพร้อมกันได้สูงสุด 25 ข้อเสนอ
  • BUYER_APPLIED: ข้อเสนอนี้จะมีผลในขั้นตอนการชำระเงินตามการดำเนินการของผู้ซื้อ เช่น การป้อนรหัสโปรโมชั่น ข้อเสนอเหล่านี้ไม่สามารถนำมาใช้ร่วมกันเอง หรือใช้ร่วมกับข้อเสนอที่มีผลโดยอัตโนมัติในขั้นตอนการชำระเงิน ต้องระบุ [public_coupon_code, coupon_codes] อย่างใดอย่างหนึ่ง

coupon_codes

ประเภท: Array<string>

รายการรหัสคูปองที่ไม่จำเป็นต้องตรงตามตัวอักษรพิมพ์เล็ก/ใหญ่ที่ลูกค้าใช้ในขั้นตอนการชำระเงินเพื่อแลกรับข้อเสนอ มีรหัสคูปองได้สูงสุด 100 รหัส ตัวอย่างเช่น ["10OFF", "HOLIDAY_SALE"]


รหัสคูปองจะระบุได้ก็ต่อเมื่อ application_type คือ BUYER_APPLIED เท่านั้น


หากตั้งค่าช่องนี้ไว้ public_coupon_code ต้องเป็น Null

public_coupon_code

ประเภท: string

ระบุหรือไม่ก็ได้

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


ตามค่าเริ่มต้น ข้อเสนอที่มีรหัสคูปองจะไม่มีการโปรโมทในลักษณะที่ปรากฏให้ผู้ซื้อเห็นในพื้นที่เลือกซื้อสินค้าบน Facebook หรือ Instagram เช่น หน้ารายละเอียดสินค้า เพื่อป้องกันไม่ให้รหัสส่วนตัวหรือรหัสลับรั่วไหลไปสู่ผู้ซื้อโดยไม่ได้ตั้งใจ คุณสามารถเปลี่ยนพฤติกรรมนี้ได้โดยการระบุรหัสคูปองสาธารณะเพื่อใช้โปรโมทข้อเสนอของคุณ ข้อเสนอที่มีรหัสสาธารณะจะปรากฏเหมือนกับข้อเสนอที่มี application_type เป็น AUTOMATIC_AT_CHECKOUT แต่จะมีข้อความรหัสด้วย


รหัสคูปองสาธารณะต้องมีความยาวไม่เกิน 20 อักขระ และแค็ตตาล็อกของคุณสามารถมีข้อเสนอที่มีรหัสคูปองสาธารณะที่ใช้งานอยู่พร้อมกันได้สูงสุด 10 ข้อเสนอ


คุณสามารถตั้งค่ารหัสคูปองสาธารณะได้ก็ต่อเมื่อ application_type คือ BUYER_APPLIED


หากตั้งค่าช่องนี้ไว้ coupon_codes ต้องเป็น Null

start_date_time

ประเภท: timestamp

จำเป็นต้องระบุ

ประทับเวลา Unix เป็นหน่วยวินาทีของเวลาเริ่มต้นของข้อเสนอ


อินพุตต้องเป็นประทับเวลา Unix เป็นหน่วยวินาที หรือสตริงวันที่รูปแบบ ISO-8601 (เช่น 2021-09-25T12:34:56Z)

end_date_time

ประเภท: timestamp

ระบุหรือไม่ก็ได้ ค่าเริ่มต้นคือ null

ประทับเวลา Unix ในหน่วยวินาทีของเวลาสิ้นสุดของข้อเสนอ หากเว้นว่างหรือมีค่า null ข้อเสนอจะไม่มีวันที่สิ้นสุด


อินพุตต้องเป็นประทับเวลา Unix ในหน่วยวินาที หรือสตริงวันที่รูปแบบ ISO-8601 (เช่น 2021-09-25T12:34:56Z)

min_quantity

ประเภท: int64

ระบุหรือไม่ก็ได้ ค่าเริ่มต้นคือ 0


ใช้ช่องนี้หากข้อเสนอของคุณใช้ได้ก็ต่อเมื่อลูกค้าซื้อสินค้าถึงจำนวนขั้นต่ำ


ช่องนี้คือจำนวนสินค้าที่ลูกค้าต้องซื้อให้ถึงเพื่อให้สามารถใช้ข้อเสนอได้ ตัวอย่างเช่น "ซื้อเสื้อ 5 ตัว รับส่วนลด 20%"


ตั้งค่าได้เพียงอย่างใดอย่างหนึ่งระหว่าง min_quantity หรือ min_subtotal เท่านั้น

min_subtotal

ประเภท: string

ระบุหรือไม่ก็ได้ ค่าเริ่มต้นคือ null


ใช้ช่องนี้หากข้อเสนอของคุณใช้ได้ก็ต่อเมื่อคำสั่งซื้อของลูกค้ามีมูลค่าถึงยอดรวมที่กำหนด


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


ช่องนี้ควรมีรูปแบบเป็นจำนวนเงิน ตามด้วยรหัสสกุลเงิน ISO 3 หลัก โดยเว้นวรรคระหว่างจำนวนเงินและสกุลเงิน ตัวอย่างเช่น สตริง "30.99 USD" คือยอดรวมที่เป็นข้อกำหนดเบื้องต้นมูลค่า $30.99 เพื่อให้สามารถใช้ข้อเสนอได้


ตั้งค่าได้เพียงอย่างใดอย่างหนึ่งระหว่าง min_quantity หรือ min_subtotal เท่านั้น

redeem_limit_per_user

ประเภท: int64

ระบุหรือไม่ก็ได้ ค่าเริ่มต้นคือ 0 (ไม่จำกัด)

จำนวนครั้งสูงสุดที่ผู้ใช้รายหนึ่งสามารถใช้ข้อเสนอได้


ให้ตั้งค่าช่องนี้เป็น 1 เพื่อสร้างรหัสคูปองที่ใช้ได้ครั้งเดียว


คุณควรตั้งค่าช่องนี้เฉพาะในกรณีที่ application_type คือ BUYER_APPLIED เท่านั้น

value_type

ประเภท: enum {FIXED_AMOUNT, PERCENTAGE}

จำเป็นต้องระบุ

ประเภทส่วนลดของข้อเสนอ


ตัวเลือกที่มีได้แก่

  • FIXED_AMOUNT: ใช้ส่วนลดที่มาจากค่า fixed_amount_off
  • PERCENTAGE: ใช้ส่วนลดที่เป็นอัตราร้อยละที่มาจากค่า percent_off

fixed_amount_off

ประเภท: string

จำเป็นต้องระบุหากตั้งค่า value_type เป็น FIXED_AMOUNT

ส่วนลดที่เป็นจำนวนเงินของข้อเสนอ ควรมีรูปแบบเป็นจำนวนเงิน ตามด้วยรหัสสกุลเงิน ISO 3 หลัก โดยเว้นวรรคระหว่างจำนวนเงินและสกุลเงิน ตัวอย่างเช่น สตริง "30.99 USD" คือส่วนลดมูลค่า $30.99


คุณควรตั้งค่าช่องนี้เฉพาะในกรณีที่ value_type คือ FIXED_AMOUNT เท่านั้น

percent_off

ประเภท: int64

จำเป็นต้องระบุหากตั้งค่า value_type เป็น PERCENTAGE

ส่วนลดที่เป็นอัตราร้อยละของข้อเสนอ ซึ่งควรเป็นจำนวนเต็มตั้งแต่ 0 ถึง 100 ตัวอย่างเช่น "30" คือส่วนลด 30%


คุณควรตั้งค่าช่องนี้เฉพาะในกรณีที่ value_type คือ PERCENTAGE เท่านั้น

target_granularity

ประเภท: enum {ITEM_LEVEL, ORDER_LEVEL}

จำเป็นต้องระบุ

ความละเอียดของการนำส่วนลดของข้อเสนอไปใช้


ตัวเลือกที่มีได้แก่

  • ITEM_LEVEL: คือส่วนลดที่นำไปใช้กับรายการสินค้าเป้าหมายแต่ละชิ้นในรถเข็น
  • ORDER_LEVEL: คือส่วนลดที่นำไปใช้กับรายการสินค้าเป้าหมายทั้งหมดในรถเข็น ตัวอย่างเช่น หากคุณมีข้อเสนอ "ส่วนลด $30 สำหรับรองเท้า" กับรองเท้า 3 คู่ในรถเข็น ITEM_LEVEL จะใช้ส่วนลด $30 กับรองเท้าแต่ละคู่ (มูลค่า $90) ขณะที่ ORDER_LEVEL จะใช้ส่วนลด $30 กับยอดรวมของรองเท้าทั้ง 3 คู่ (มูลค่าสูงสุด $30)

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

offer_terms

ประเภท: string

ระบุหรือไม่ก็ได้

ข้อกำหนดและเงื่อนไขเพิ่มเติมใดๆ ที่กำหนดการใช้ข้อเสนอของผู้ซื้อ สูงสุด 2,500 อักขระ


Facebook จะสร้างข้อกำหนดขึ้นมาอัตโนมัติเพื่ออธิบายข้อเสนอตามการกำหนดค่าของข้อเสนอ นอกจากข้อกำหนดเหล่านี้ คุณยังสามารถใช้ offer_terms เพื่อเพิ่มข้อความอธิบายข้อกำหนดของคุณเองสำหรับข้อเสนอ ข้อกำหนดเหล่านี้จะปรากฏอยู่ด้านล่างข้อกำหนดเกี่ยวกับข้อเสนอของ Facebook


เนื้อหาต้องเป็นไปตามนโยบายเนื้อหาของเรา

การระบุสินค้าที่เข้าเกณฑ์

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

ช่องคำอธิบาย

target_selection

ประเภท: enum{ALL_CATALOG_PRODUCTS, SPECIFIC_PRODUCTS}

จำเป็นต้องระบุ

ช่องนี้ใช้เพื่อจำแนกระหว่างข้อเสนอที่ใช้กับทั้งแค็ตตาล็อกสินค้าและข้อเสนอที่จำกัดอยู่ที่เฉพาะบางรายการสินค้าภายในแค็ตตาล็อก


ตัวเลือกที่มีได้แก่

  • ALL_CATALOG_PRODUCTS: ข้อเสนอสามารถใช้ได้กับสินค้าทุกชิ้นในแค็ตตาล็อก
  • SPECIFIC_PRODUCTS: ข้อเสนอสามารถใช้ได้กับสินค้าเป้าหมายที่กำหนดไว้โดย target_filter, target_product_retailer_ids, target_product_group_retailer_ids หรือ target_product_set_retailer_ids

หาก target_selection คือ SPECIFIC_PRODUCTS ต้องระบุรายการใดรายการหนึ่งต่อไปนี้ target_filter, target_product_retailer_ids, target_product_group_retailer_ids หรือ target_product_set_retailer_ids

target_filter

ประเภท: JSON-encoded string

ระบุหรือไม่ก็ได้


กฎตัวกรองเพื่อระบุสินค้าที่สามารถใช้ข้อเสนอได้ ใช้ตรรกะกฎตัวกรองเดียวกันที่ใช้สำหรับเพิ่มสินค้าลงในชุดสินค้า


หากกฎตัวกรองที่ระบุตรงกับตัวกรองของชุดสินค้าที่มีอยู่ ข้อเสนอนี้ก็จะกำหนดเป้าหมายเป็นชุดสินค้าดังกล่าว แต่หากไม่ตรง ก็จะมีการสร้างชุดสินค้าใหม่ขึ้นมา


คุณควรตั้งค่าช่องนี้เฉพาะในกรณีที่ตั้งค่า target_selection เป็น SPECIFIC_PRODUCTS เท่านั้น

target_product_retailer_ids

ประเภท: Array<product_retailer_id>

ระบุหรือไม่ก็ได้


รายการ ID ผู้ขายปลีกของรายการสินค้าสำหรับสินค้าที่สามารถใช้ข้อเสนอได้


คุณควรตั้งค่าช่องนี้เฉพาะในกรณีที่ตั้งค่า target_selection เป็น SPECIFIC_PRODUCTS เท่านั้น

target_product_group_retailer_ids

ประเภท: Array<product_group_retailer_id>

ระบุหรือไม่ก็ได้


รายการ ID ผู้ขายปลีกของกลุ่มสินค้าสำหรับสินค้าที่สามารถใช้ข้อเสนอได้


แบบสินค้าทั้งหมดที่รวมอยู่ในกลุ่มสินค้าจะมีคุณสมบัติเข้าเกณฑ์สำหรับข้อเสนอ


คุณควรตั้งค่าช่องนี้เฉพาะในกรณีที่ตั้งค่า target_selection เป็น SPECIFIC_PRODUCTS เท่านั้น

target_product_set_retailer_ids

ประเภท: Array<product_set_retailer_id>

ระบุหรือไม่ก็ได้


รายการ ID ผู้ขายปลีกของชุดสินค้าซึ่งมีสินค้าที่สามารถใช้ข้อเสนอได้ ข้อเสนอจะใช้กับชุดรวมสินค้าทั้งหมดที่ได้มาจากการประเมินชุดสินค้าที่ระบุ

prerequisite_filter

ประเภท: JSON-encoded string

ระบุหรือไม่ก็ได้


กฎตัวกรองเพื่อระบุสินค้าที่ผู้ซื้อต้องซื้อเพื่อแลกรับข้อเสนอ ใช้ตรรกะกฎตัวกรองเดียวกันที่ใช้สำหรับเพิ่มสินค้าลงในชุดสินค้า โดยปกติแล้วจะใช้ในข้อเสนอรูปแบบ "ซื้อ X รับ Y"


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


หากตั้งค่าช่องนี้ไว้ prerequisite_product_retailer_ids, prerequisite_product_group_retailer_ids และ prerequisite_product_set_retailer_ids ต้องเป็น null

prerequisite_product_retailer_ids

ประเภท: Array<product_retailer_id>

ระบุหรือไม่ก็ได้


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


หากตั้งค่าช่องนี้ไว้ prerequisite_filter, prerequisite_product_group_retailer_ids และ prerequisite_product_set_retailer_ids ต้องเป็น null

prerequisite_product_group_retailer_ids

ประเภท: Array<product_group_retailer_id>

ระบุหรือไม่ก็ได้


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


หากตั้งค่าช่องนี้ไว้ prerequisite_filter, prerequisite_product_retailer_ids และ prerequisite_product_set_retailer_ids ต้องเป็น null

prerequisite_product_set_retailer_ids

ประเภท: Array<product_set_retailer_id>

ระบุหรือไม่ก็ได้


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


หากตั้งค่าช่องนี้ไว้ prerequisite_filter, prerequisite_product_retailer_ids และ prerequisite_product_group_retailer_ids ต้องเป็น null

exclude_sale_priced_products

ประเภท: bool enum {YES, NO}

ระบุหรือไม่ก็ได้

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


ตั้งค่าช่องนี้เป็น YES เพื่อไม่ให้เกิดกรณีที่สินค้าอาจได้รับส่วนลดซ้อนกันสองครั้ง เว้นช่องนี้ว่างไว้ หรือตั้งค่าเป็น NO เพื่อให้รวมสินค้าที่มีการตั้งค่า sale_price ลดลงในแค็ตตาล็อกของคุณด้วย


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

ข้อเสนอการจัดส่ง

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

หากต้องการสร้างข้อเสนอการจัดส่ง ต้องตั้งค่า target_type เป็น SHIPPING ขณะนี้รองรับเฉพาะข้อเสนอการจัดส่งฟรีเท่านั้น แล้วก็ด้วยเหตุนี้ value_type จึงต้องเป็น PERCENTAGE โดยตั้งค่า percent_off เป็น 100 เสมอ

ช่องคำอธิบาย

target_type

ประเภท: enum{LINE_ITEM, SHIPPING}

จำเป็นต้องระบุ

ประเภทอ็อบเจ็กต์ในการนำข้อเสนอไปใช้

  • LINE_ITEM: ข้อเสนอมีผลกับรายการสินค้า
  • SHIPPING: ข้อเสนอมีผลกับค่าจัดส่ง ตัวเลือกนี้จะใช้ได้ก็ต่อเมื่อ target_granularity คือ ITEM_LEVEL เท่านั้น

target_shipping_option_types

ประเภท: Array<shipping_service_tier>

จำเป็นต้องระบุหาก target_type คือ SHIPPING

รายการระดับบริการจัดส่ง (เช่น STANDARD, RUSH, EXPEDITED) ที่สามารถใช้ข้อเสนอได้


ตัวอย่างเช่น หากต้องการระบุข้อเสนอการจัดส่งที่จะใช้กับการจัดส่งในความเร็วมาตรฐานและเร่งด่วน แต่ไม่ใช่การจัดส่งข้ามคืน ให้ใช้ค่าต่อไปนี้

  • target_type ของ SHIPPING
  • target_shipping_option_types ของ ["STANDARD", "RUSH"]

สำหรับผู้ขายที่เปิดใช้งานการชำระเงินบน Facebook หรือ Instagram ไว้ คุณสามารถใช้ API โปรไฟล์การจัดส่งเพื่อจัดการโปรไฟล์การจัดส่งในบัญชีการค้าของคุณได้

ข้อเสนอ "ซื้อ X รับ Y"

ข้อเสนอแบบ "ซื้อ X รับ Y" ทำให้ผู้ซื้อสามารถซื้อ "สินค้า X" ที่ร่วมรายการในจำนวนที่กำหนด เพื่อรับ "สินค้า Y" อย่างน้อย 1 ชิ้นในราคาที่ลดลงหรือฟรี อีกทั้งยังรองรับข้อเสนอ "ใช้จ่าย X รับ Y" ที่ผู้ซื้อต้องใช้จ่ายให้ถึงเกณฑ์ขั้นต่ำสำหรับสินค้า X เพื่อให้ได้รับส่วนลด คุณสามารถสร้างข้อเสนอ "ซื้อ X รับ Y" ได้ด้วยการตั้งค่าช่อง target_quantity และช่อง min_quantity หรือ min_subtotal

ในบางกรณี เช่น ข้อเสนอ "ซื้อ 1 แถม 1" ที่พบได้บ่อย X และ Y อาจอ้างอิงถึงสินค้าชุดเดียวกัน แต่คุณสามารถใช้ prerequisite_filter, prerequisite_product_retailer_ids, prerequisite_product_group_retailer_ids และ prerequisite_product_set_retailer_ids เพื่อกำหนดชุดสินค้า X ให้แตกต่างจากสินค้า Y เป้าหมายได้ด้วย โปรดดูวิธีกำหนดค่าช่องเหล่านี้ในส่วนระบุสินค้าที่เข้าเกณฑ์

ช่องคำอธิบาย

target_quantity

ประเภท: int64

ระบุหรือไม่ก็ได้ ค่าเริ่มต้นคือ 0 (ไม่จำกัด)

จำนวนสินค้าที่จะได้รับส่วนลดสำหรับการแลกรับข้อเสนอแต่ละครั้ง การตั้งค่า target_quantity มากกว่า 0 เป็นข้อเสนอรูปแบบ "ซื้อ X รับ Y"


ใช้ช่องนี้เพื่อควบคุมจำนวนสินค้าที่จะได้รับส่วนลดเมื่อผู้ซื้อมีคุณสมบัติตรงตามข้อกำหนดเบื้องต้นในการแลกรับข้อเสนอ ตัวอย่างเช่น ในข้อเสนอ "ซื้อ 2 ชิ้น ลด 50% สำหรับชิ้นถัดไป" จำนวนเป้าหมายคือ 1 และในข้อเสนอ "ซื้อ 5 ชิ้น ฟรี 2 ชิ้น" จำนวนเป้าหมายคือ 2

redemption_limit_per_order

ประเภท: int64

ระบุหรือไม่ก็ได้ ค่าเริ่มต้นคือ 0 (ไม่จำกัด)

จำนวนครั้งที่สามารถแลกรับข้อเสนอนี้ต่อคำสั่งซื้อ


ใช้ช่องนี้เพื่อจำกัดจำนวนครั้งที่สามารถใช้ข้อเสนอหนึ่งกับสินค้าในการซื้อของผู้ซื้อ ตัวอย่างเช่น ในข้อเสนอ "ซื้อเสื้อ 1 ตัว รับฟรี 1 ตัว" ตามค่าเริ่มต้น ผู้ซื้อที่ซื้อเสื้อ 6 ตัวจะได้รับเสื้อ 3 ตัวในราคาเต็มและรับฟรีอีก 3 ตัว แต่ในตัวอย่างเดียวกัน หากตั้งค่า redemption_limit_per_order เป็น 2 ผู้ซื้อก็จะได้รับเสื้อฟรี 2 ตัวและอีก 4 ตัวในราคาเต็ม


หากตั้งค่าช่องนี้ไว้ target_quantity ต้องมากกว่า 0

การใช้ข้อเสนอร่วมกัน

สำหรับผู้ขายที่เปิดใช้งานการชำระเงินบน Facebook หรือ Instagram ไว้ การสนับสนุนจะมีข้อจำกัดสำหรับการใช้ข้อเสนอหลายอย่างร่วมกันภายในธุรกรรมเดียว ความสามารถในการใช้ข้อเสนอหนึ่งร่วมกับข้อเสนออื่นขึ้นอยู่กับประเภทการใช้งานและประเภทเป้าหมายของข้อเสนอดังกล่าวเป็นหลัก ผู้ขายไม่สามารถกำหนดค่าการทำงานนี้ได้ในขณะนี้ กฎด้านล่างสรุปข้อมูลเกี่ยวกับการใช้ข้อเสนอซ้อนกัน ดังนี้

  • สำหรับสินค้าชิ้นหนึ่งๆ หากมีข้อเสนอใดที่จะส่งผลให้มีราคาที่ถูกขีดทับ (application_type = SALE) ข้อเสนอที่ให้ราคาสินค้าที่ต่ำสุดจะมีผล โดยจะดำเนินการนี้ซ้ำกับรายการสินค้าทุกชิ้นในรถเข็นของผู้ซื้อ ราคาส่วนลดใหม่ของรายการสินค้าจะถูกนำไปใช้ในการคำนวณข้อกำหนดเบื้องต้นของข้อเสนอในอนาคตทั้งหมด
  • ในคำสั่งซื้อเดียว ผู้ซื้อสามารถแลกรับข้อเสนอ BUYER_APPLIED จำนวน 1 รายการ หรือ AUTOMATIC_AT_CHECKOUT จำนวน 1 รายการต่อ target_type (LINE_ITEM หรือ SHIPPING) ตัวอย่างเช่น ผู้ซื้อสามารถใช้คูปองจัดส่งฟรีและคูปองซื้อ 1 แถม 1 ได้ แต่ไม่สามารถแลกรับข้อเสนอ 2 รายการที่ให้ส่วนลดสำหรับราคาสินค้าทั้งคู่ได้
  • Meta อาจออกค่าใช้จ่ายสำหรับข้อเสนอให้เป็นครั้งคราวเพื่อดึงดูดลูกค้าใหม่และลูกค้าที่กลับมาซื้ออีกครั้ง โดยที่ผู้ขายไม่เสียค่าใช้จ่าย โดยสามารถใช้ข้อเสนอที่ Meta ออกค่าใช้จ่ายให้ร่วมกับข้อเสนอที่ผู้ขายเป็นผู้ออกค่าใช้จ่ายได้ทุกกรณี

การจำกัดคุณสมบัติของผู้ใช้สำหรับข้อเสนอ

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

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