โฆษณาแค็ตตาล็อก Advantage+

โฆษณาโรงแรม - แค็ตตาล็อกและฟีด

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

คุณสามารถสร้างและจัดการแค็ตตาล็อกโรงแรมของคุณได้ในตัวจัดการการค้า

หากต้องการใช้ API เพื่อจัดการแค็ตตาล็อกของคุณ ให้ดำเนินการดังนี้

  1. สร้างแค็ตตาล็อกโรงแรม
  2. สร้างชุดสินค้าจากแค็ตตาล็อกโรงแรมของคุณ
  3. เชื่อมโยงแค็ตตาล็อกกับแหล่งที่มาของเหตุการณ์

ฟีดโรงแรม - อัพโหลดโรงแรมของคุณลงใน Facebook

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

รูปแบบฟีดโรงแรมที่รองรับ

CSV

ตัวอย่าง CSV | ตัวอย่าง TSV (ปรับให้เป็นระนาบเดียวกัน) | ตัวอย่าง TSV (สไตล์ JSON)

  • แถวแรกต้องแสดงรายชื่อช่องที่เลือกไว้ตามลำดับของการระบุค่า จากนั้น แถวต่อๆ มาจะแสดงค่าที่สอดคล้องกันสำหรับแต่ละโรงแรม
  • ช่องที่มีการเว้นวรรคหรือเครื่องหมายจุลภาคควรอยู่ในเครื่องหมาย "อัญประกาศคู่"
  • ทั้งนี้ ช่องที่ซ้อนกันหรือมีหลายค่า เช่น address, neighborhood หรือ image สามารถแสดงโดยใช้ค่าที่มีการเข้ารหัส JSON หรือโดยชุดคอลัมน์ข้อความธรรมดาที่ "ปรับให้เป็นระนาบเดียว" โดยใช้ไวยากรณ์พาธ JSON เช่น address.city, neighborhood[0], image[0].url, image[0].tag[0] และ image[0].tag[1] ทั้ง 2 รูปแบบสามารถใช้แทนกันได้ในไฟล์เดียวกัน

XML

ตัวอย่าง XML

  • โหนด XML <listings> รากจะครอบคลุมชุดโหนด <listing> ซึ่งแต่ละโหนดจะหมายถึงโรงแรมแต่ละแห่ง
  • ไฟล์ต้องเริ่มต้นด้วยแท็กประกาศ <?xml ที่ถูกต้อง

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

ช่องที่รองรับ — โฆษณาโรงแรม

ช่องที่รองรับต่อไปนี้ออกแบบมาสำหรับสินค้าที่คุณเพิ่มลงในแค็ตตาล็อกสินค้า

โปรดดูช่องที่รองรับสำหรับโฆษณาโรงแรมสำหรับแค็ตตาล็อกที่ปรับให้เข้ากับท้องถิ่น

ช่องและประเภทคำอธิบาย

hotel_id

ประเภท: สตริง

ต้องระบุ

ความยาวสูงสุด: 100

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

ตัวอย่าง: FB_hotel_1234

room_id

ประเภท: สตริง

ต้องระบุ หากเพิ่มข้อมูลของห้องพักภายในโรงแรม

ป้อน ID ที่ไม่ซ้ำกันของประเภทห้องพักภายในโรงแรม อักขระสูงสุด: 100 ตัวอย่าง: FB_hotel_room_1234

name

ประเภท: สตริง

ต้องระบุ

ชื่อที่เป็นที่รู้จักมากที่สุดของโรงแรมดังกล่าว

ตัวอย่าง: Facebook Hotel

description

ประเภท: สตริง

ต้องระบุ

ขนาดสูงสุด: 5,000

คำอธิบายโดยย่อของโรงแรม

ตัวอย่าง: Only 30 minutes away from San Francisco.

checkin_date

ประเภท: สตริง

จำเป็นต้องระบุ หากเพิ่มข้อมูลของห้องพักภายในโรงแรม

วันที่เช็คอินเพื่อเข้าพักในโรงแรม คุณสามารถเพิ่มได้สูงสุด 180 วัน นับจากวันที่อัพโหลดฟีด ใช้มาตรฐาน ISO-8601 (YYYY-MM-DD)

ตัวอย่าง: 2017-08-01

length_of_stay

ประเภท: สตริง

จำเป็นต้องระบุ หากเพิ่มข้อมูลของห้องพักภายในโรงแรม

จำนวนคืนที่เข้าพักในโรงแรม

ตัวอย่าง: 7

base_price

ประเภท: สตริง

จำเป็นต้องระบุ หากเพิ่มข้อมูลของห้องพักภายในโรงแรม

ราคาขั้นต่ำของห้องพักภายในโรงแรมต่อคืน อย่าลืมเพิ่มประเภทของสกุลเงินในราคา (ตัวอย่างเช่น USD สำหรับดอลลาร์สหรัฐ) ให้จัดรูปแบบราคาโดยเริ่มต้นด้วยราคา ตามด้วยรหัสสกุลเงิน ISO โดยเว้นวรรคระหว่างราคากับสกุลเงินไว้

ตัวอย่าง: 199.00 EUR

price

ประเภท: สตริง

จำเป็นต้องระบุ หากเพิ่มข้อมูลของห้องพักภายในโรงแรม

ราคารวมของการเข้าพักโรงแรม โดยอิงตาม checkin_date และ length_of_stay ให้จัดรูปแบบราคาโดยเริ่มต้นด้วยราคา ตามด้วยรหัสสกุลเงิน ISO โดยเว้นวรรคระหว่างราคากับสกุลเงิน

ตัวอย่าง: 1393.00 USD

tax

ประเภท: สตริง

จำเป็นต้องระบุ หากเพิ่มข้อมูลของห้องพักภายในโรงแรม

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

ตัวอย่าง: 14.00 USD

fees

ประเภท: สตริง

จำเป็นต้องระบุ หากเพิ่มข้อมูลของห้องพักภายในโรงแรม

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

ตัวอย่าง: 253.00 USD

url

ประเภท: สตริง

ต้องระบุ

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

ตัวอย่าง: https://www.facebook.com/hotel

image[0].url

ประเภท: อ็อบเจ็กต์

โปรดดูพารามิเตอร์อ็อบเจ็กต์รูปภาพ

image[0].tag

ประเภท: อ็อบเจ็กต์

โปรดดูพารามิเตอร์อ็อบเจ็กต์รูปภาพ

brand

ประเภท: สตริง

ต้องระบุ

ชื่อแบรนด์ของเครือโรงแรม

ตัวอย่าง: Hilton

address

ประเภท: อ็อบเจ็กต์

โปรดดูพารามิเตอร์อ็อบเจ็กต์ที่อยู่

neighborhood[0]

ประเภท: สตริง

ต้องระบุ

จำนวนย่านสูงสุดที่อนุญาต: 20

ย่านที่โรงแรมตั้งอยู่ หากมีย่านมากกว่า 1 ย่านในละแวกนั้น ให้เพิ่มคอลัมน์สำหรับแต่ละย่านและใช้ไวยากรณ์พาธ JSON ในชื่อคอลัมน์แต่ละรายการเพื่อระบุจำนวนของย่าน

ตัวอย่าง: Belle Haven

latitude

ประเภท: ทศนิยม

ต้องระบุ

ละติจูดของโรงแรม

ตัวอย่าง: 37.484100

longitude

ประเภท: ทศนิยม

ต้องระบุ

ลองจิจูดของโรงแรม

ตัวอย่าง: -122.148252

sale_price

ประเภท: สตริง

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

ราคาลดพิเศษต่อคืนของการเข้าพักโรงแรม โดยอิงตาม checkin_date และ length_of_stay ให้ใช้เมื่อคุณต้องการโฆษณาส่วนลดจากราคาปกติของโรงแรม อย่าลืมเพิ่มประเภทของสกุลเงินในราคา (ตัวอย่างเช่น USD สำหรับดอลลาร์สหรัฐ) ตรวจสอบให้แน่ใจว่า sale_price ของโรงแรมต่ำกว่า base_price ให้จัดรูปแบบราคาโดยขึ้นต้นด้วยราคา ตามด้วยรหัสสกุลเงิน ISO โดยเว้นวรรคระหว่างราคากับสกุลเงิน

ตัวอย่าง: 149.00 USD

guest_ratings.score

ประเภท: อ็อบเจ็กต์

โปรดดูพารามิเตอร์อ็อบเจ็กต์การให้คะแนนจากผู้เข้าพัก

guest_ratings.rating_system

ประเภท: อ็อบเจ็กต์

โปรดดูพารามิเตอร์อ็อบเจ็กต์การให้คะแนนจากผู้เข้าพัก

star_rating

ประเภท: ทศนิยม

โปรดดูพารามิเตอร์อ็อบเจ็กต์การให้คะแนนจากผู้เข้าพัก

loyalty_program

ประเภท: สตริง

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

โปรแกรมความภักดีที่คุณใช้เพื่อรับคะแนนจากการเข้าพักที่โรงแรม

ตัวอย่าง: Premium program

margin_level

ประเภท: จำนวนเต็ม

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

ตัวบ่งชี้ความสามารถในการทำกำไรของโรงแรม โดยค่าจะอยู่ที่ 1 ถึง 10

ตัวอย่าง: 9

phone

ประเภท: สตริง

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

หมายเลขโทรศัพท์หลักสำหรับโรงแรม

ตัวอย่าง: +61 296027455

applink

ประเภท: อ็อบเจ็กต์

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

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

  1. ในระดับโฆษณาโดยใช้ template_url_spec
  2. ดำเนินการในฟีดโดยใช้อ็อบเจ็กต์ลิงก์ที่ไปยังแอพ
  3. โดยเพิ่มแท็กเมตาของลิงก์ที่ไปยังแอพในเว็บไซต์ของคุณ

โปรดเรียนรู้เพิ่มเติมเกี่ยวกับ Deep Link ของสินค้า

priority

ประเภท: จำนวนเต็ม

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

ตัวบ่งชี้ลำดับความสำคัญของโรงแรม โดยค่าจะอยู่ที่ 0 (ลำดับความสำคัญต่ำสุด) ถึง 5 (ลำดับความสำคัญสูงสุด) ตัวอย่าง: 5

category

ประเภท: สตริง

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

ประเภทของคุณสมบัติ หมวดหมู่นี้สามารถเป็นคำอธิบายที่ใช้เป็นการภายในประเภทใดก็ได้ที่ต้องการ ตัวอย่าง: Resort, Day Room

number_of_rooms

ประเภท: จำนวนเต็ม

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

จำนวนห้อง/ยูนิตทั้งหมดในรายการโรงแรมนี้

ตัวอย่าง: 150

status

ประเภท: สตริง

ควบคุมว่าจะเปิดใช้งานหรือจัดเก็บสินค้าในแค็ตตาล็อก ซึ่งผู้คนจะเห็นเฉพาะสินค้าที่เปิดใช้งานในโฆษณา ร้านค้า หรือช่องทางอื่นๆ ของคุณ ค่าที่รองรับ: active, archived ทั้งนี้ สินค้าจะเปิดใช้งานเป็นค่าเริ่มต้น โปรดเรียนรู้เพิ่มเติมเกี่ยวกับการจัดเก็บสินค้า


ตัวอย่าง: active


หมายเหตุ: แพลตฟอร์มของพาร์ทเนอร์บางแพลตฟอร์ม เช่น Shopify อาจซิงค์สินค้ากับแค็ตตาล็อกของคุณโดยใช้สถานะ "กำลังจัดเตรียม" ซึ่งมีลักษณะการทำงานเช่นเดียวกับ archived

ช่องนี้มีชื่อเดิมว่า visibility แม้เราจะรองรับชื่อช่องแบบเดิมอยู่ แต่ก็ขอแนะนำให้คุณใช้ชื่อแบบใหม่

custom_label_0
custom_label_1
custom_label_2
custom_label_3
custom_label_4

ประเภท: สตริง

จำกัดอักขระสูงสุด: 100 ตัว

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


ตัวอย่าง: Summer Sale

ฟีดเสริมรองรับช่องนี้

custom_number_0
custom_number_1
custom_number_2
custom_number_3
custom_number_4

ประเภท: int

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


ช่องนี้รองรับจำนวนเต็มระหว่าง 0 จนถึง 4294967295 และไม่รองรับเลขที่เป็นจำนวนลบ เลขทศนิยม หรือเครื่องหมายจุลภาค เช่น -2, 5.5 หรือ 10,000


ตัวอย่าง: 2022

internal_label

ประเภท: สตริง

เพิ่มป้ายภายในเพื่อช่วยในการกรองสินค้าเมื่อคุณสร้างชุดสินค้า ตัวอย่างเช่น คุณสามารถเพิ่มป้าย "ฤดูร้อน" ให้กับสินค้าทั้งหมดที่อยู่ภายใต้โปรโมชั่นฤดูร้อน จากนั้นจึงกรองสินค้าเหล่านั้นให้เป็นชุด ป้ายจะปรากฏให้คุณเห็นเพียงคนเดียวเท่านั้น

ปิดหัวและท้ายแต่ละป้ายด้วยเครื่องหมายอัญประกาศเดี่ยว (') แล้วแยกป้ายหลายป้ายด้วยเครื่องหมายจุลภาค (,) อย่าขึ้นต้นหรือปิดท้ายป้ายด้วยการเว้นวรรค ขีดจำกัดอักขระ: ไม่เกิน 5,000 ป้ายต่อสินค้า และ 110 อักขระต่อป้าย

ตัวอย่าง (TSV, XLSX, Google Sheets): ['ฤดูร้อน','มาแรง']

ตัวอย่าง (CSV): “['ฤดูร้อน','มาแรง']”

หมายเหตุ: หากคุณกำลังใช้ป้ายที่กำหนดเอง (custom_label_0 ถึง custom_label_4) ในการกรองชุดสินค้า เราขอแนะนำให้เปลี่ยนมาใช้ป้ายภายใน (internal_label) แทน ป้ายภายในต่างจากป้ายที่กำหนดเอง เนื่องจากคุณสามารถเพิ่มหรืออัพเดตป้ายภายในได้บ่อยตามที่ต้องการโดยไม่ต้องส่งสินค้าเข้ารับการตรวจสอบตามนโยบายทุกครั้ง ซึ่งอาจส่งผลต่อการแสดงโฆษณาได้

ช่องนี้มีชื่อเดิมว่า product_tags แม้เราจะรองรับชื่อช่องแบบเดิมอยู่ แต่ก็ขอแนะนำให้คุณใช้ชื่อแบบใหม่

พารามิเตอร์อ็อบเจ็กต์รูปภาพ


ชื่อและประเภทของช่องคำอธิบาย

url

ประเภท: สตริง

ต้องระบุ

รายการสูงสุด: 20

ลิงก์ URL ที่นำไปยังรูปภาพของสินค้าที่จะปรากฏในโฆษณาของคุณ ดำเนินการตามข้อมูลจำเพาะสำหรับรูปภาพต่อไปนี้

  • รูปภาพทั้งหมดต้องเป็นรูปแบบ JPG, GIF หรือ PNG

  • สำหรับโฆษณาแบบภาพสไลด์และโฆษณาคอลเลกชั่น: รูปภาพที่แสดงต้องเป็นแบบสี่เหลี่ยมจัตุรัส (1:1) ขนาดขั้นต่ำของรูปภาพคือ 500 x 500 พิกเซล เราขอแนะนำให้ใช้รูปภาพขนาด 1024 x 1024 พิกเซล เพื่อให้ได้คุณภาพที่ดีที่สุด

  • สำหรับโฆษณาที่มีรูปภาพรูปเดียว: รูปภาพที่แสดงต้องมีอัตราส่วนกว้างยาวเท่ากับ 1.91:1 ขนาดขั้นต่ำของรูปภาพคือ 500 x 500 พิกเซล เราขอแนะนำให้ใช้ขนาด 1200 x 628 พิกเซล เพื่อให้ได้คุณภาพที่ดีที่สุด

  • หากคุณมีรูปภาพมากกว่า 1 รูป ให้เพิ่มคอลัมน์สำหรับแต่ละรูปและใช้ไวยากรณ์พาธ JSON ในชื่อคอลัมน์แต่ละรายการเพื่อระบุจำนวนของรูปภาพ

ตัวอย่าง: image[0].url; image[1].url

ตัวอย่าง: https://www.facebook.com/facebook_hotel.jpg

tag

ประเภท: สตริง

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

แท็กที่ต่อท้ายรูปภาพที่จะบอกว่าในรูปภาพมีอะไรอยู่ รูปภาพ 1 รูปสามารถมีแท็กที่เชื่อมโยงกับรูปภาพได้หลายแท็ก

ตัวอย่าง: Fitness Center, Swimming Pool, suite

INSTAGRAM_STANDARD_PREFERRED - ทำให้ผู้ลงโฆษณาสามารถแท็กรูปภาพที่ต้องการในฟีดของตนเป็นรูปภาพเริ่มต้นเพื่อใช้สำหรับ Instagram ได้ แท็กนี้คำนึงถึงอักษรตัวพิมพ์เล็กและตัวพิมพ์ใหญ่


พารามิเตอร์อ็อบเจ็กต์ที่อยู่

ช่องที่ซ้อนกันหรือมีหลายค่า เช่น address สามารถแสดงได้โดยใช้ค่าที่เข้ารหัส JSON หรือชุดคอลัมน์ข้อความธรรมดาที่ “ปรับให้เป็นระนาบเดียว” และมีการกำกับโดยใช้รูปแบบคำสั่งพาธ JSON เช่น address.region ทั้ง 2 รูปแบบสามารถใช้แทนกันได้ในไฟล์เดียวกัน


ชื่อและประเภทของช่องคำอธิบาย

addr1 (address.addr1)

ประเภท: อ็อบเจ็กต์

ต้องระบุ

ที่อยู่ขั้นแรกของโรงแรม

ตัวอย่าง: 1600 Pennsylvania Avenue

address.addr2

ประเภท: อ็อบเจ็กต์

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

ที่อยู่ขั้นที่สองของโรงแรม

ตัวอย่าง: Apartment 1

address.addr3

ประเภท: อ็อบเจ็กต์

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

ที่อยู่ขั้นที่สามของโรงแรม

ตัวอย่าง: Downstairs

address.city_id (city_id)

ประเภท: สตริง

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

ค่าที่ใช้ใน URL ของ Deep Link (หรือ template_url) ในชิ้นงานโฆษณา

ตัวอย่าง: 12345

address.city (city)

ประเภท: สตริง

ต้องระบุ

เมืองที่โรงแรมตั้งอยู่

ตัวอย่าง: New York

address.region (region)

ประเภท: สตริง

ต้องระบุ

รัฐ เขตปกครอง หรือจังหวัดที่โรงแรมตั้งอยู่

ตัวอย่าง: California

address.country (country)

ประเภท: สตริง

ต้องระบุ

ประเทศที่โรงแรมตั้งอยู่

ตัวอย่าง: United States

address.postal_code (postal_code)

ประเภท: สตริง

จำเป็นต้องระบุสำหรับประเทศที่มีระบบรหัสไปรษณีย์

รหัสไปรษณีย์ของโรงแรม

ตัวอย่าง: 94125, NW1 3FG

พารามิเตอร์อ็อบเจ็กต์การให้คะแนนจากผู้เข้าพัก


ชื่อและประเภทของช่องคำอธิบาย

guest_ratings.score (score)

ประเภท: อ็อบเจ็กต์

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

จำนวนผู้ที่รีวิวโรงแรมของคุณทั้งหมด หากกำหนดไว้ คุณต้องระบุ score, max_score, number_of_reviewers และ rating_system ด้วย

ตัวอย่าง: 9.0/10

guest_ratings.number_of_reviewers (number_of_reviewers) ประเภท: จำนวนเต็ม

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

จำนวนผู้ที่ให้คะแนนโรงแรมนี้ทั้งหมด

ตัวอย่าง: 5287

guest_ratings.rating_system (rating_system)

ประเภท: สตริง

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

ระบบที่คุณใช้สำหรับรีวิวของผู้เข้าพัก

ตัวอย่าง: Expedia, TripAdvisor

max_score

ประเภท: จำนวนเต็ม

ต้องระบุ

ค่าสูงสุดสำหรับคะแนนที่ให้โรงแรม ต้องมากกว่าหรือเท่ากับ 0 และน้อยกว่าหรือเท่ากับ 100

ตัวอย่าง: 10

API โรงแรม - สร้างและจัดการโรงแรมโดยตรง

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

ส่วนต่อไปนี้เกี่ยวข้องกับการจัดการแค็ตตาล็อกของคุณโดยใช้ API นี้เท่านั้น

สร้างแค็ตตาล็อกโรงแรมโดยใช้ API

เอกสารอ้างอิง

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

หากต้องการสร้างแค็ตตาล็อกโรงแรมสำหรับโฆษณาโรงแรม ให้ตั้งค่า vertical เป็น hotels:

curl -X POST \
  -F 'name="Test Hotel Catalog"' \
  -F 'vertical="hotels"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs

อัพโหลดฟีดโรงแรมของคุณผ่านทาง API

เมื่อคุณได้สร้างแค็ตตาล็อกแล้ว คุณจะต้องอัพโหลดฟีดโรงแรมของคุณใน Facebook ใช้ API เพื่อสร้างอ็อบเจ็กต์ฟีดสำหรับทุกๆ ฟีดที่คุณต้องการอัพโหลด เรารองรับการอัพโหลดที่กำหนดเวลาและการอัพโหลดโดยตรง

กรองแค็ตตาล็อกโรงแรมให้เป็นชุดโรงแรม

เอกสารอ้างอิง

ชุดโรงแรมเป็นชุดย่อยของแค็ตตาล็อกของคุณ คุณจะต้องมีชุดโรงแรมจึงจะตั้งค่าโฆษณาโรงแรมได้ ดังนั้น คุณจึงต้องสร้างชุดโรงแรมอย่างน้อย 1 ชุด

ชุดโรงแรมจะกำหนดโดยตัวกรองที่ใช้กับแค็ตตาล็อกโรงแรม ตัวอย่างเช่น คุณสามารถสร้างชุดโรงแรมเป็นโรงแรมทุกรายการที่มี star_rating มากกว่า 3 ได้ หมายเหตุ: คุณสามารถสร้างชุดโรงแรมแบบไม่มีตัวกรองได้เช่นกัน ในกรณีดังกล่าว ชุดโรงแรมจะประกอบด้วยโรงแรมทั้งหมดในแค็ตตาล็อกของคุณ

หากต้องการสร้างชุดโรงแรมที่ประกอบด้วยโรงแรมทุกรายการที่มี "ตัวอย่างแบรนด์" ระบุไว้ในช่อง brand:

curl -X POST \
  -F 'name="Test Hotel Set"' \
  -F 'filter={
       "brand": {
         "i_contains": "sample brand"
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PRODUCT_CATALOG_ID>/product_sets
Open In Graph API Explorer
'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const ProductCatalog = bizSdk.ProductCatalog;
const ProductSet = bizSdk.ProductSet;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<PRODUCT_CATALOG_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'name' : 'Test Hotel Set',
  'filter' : {'brand':{'i_contains':'sample brand'}},
};
const product_sets = (new ProductCatalog(id)).createProductSet(
  fields,
  params
);
logApiCallResult('product_sets api call complete.', product_sets);
Open In Graph API Explorer
require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\ProductCatalog;
use FacebookAds\Object\ProductSet;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<PRODUCT_CATALOG_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'name' => 'Test Hotel Set',
  'filter' => array('brand' => array('i_contains' => 'sample brand')),
);
echo json_encode((new ProductCatalog($id))->createProductSet(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);
Open In Graph API Explorer
from facebook_business.adobjects.productcatalog import ProductCatalog
from facebook_business.adobjects.productset import ProductSet
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<PRODUCT_CATALOG_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'name': 'Test Hotel Set',
  'filter': {'brand':{'i_contains':'sample brand'}},
}
print ProductCatalog(id).create_product_set(
  fields=fields,
  params=params,
)
Open In Graph API Explorer
import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<PRODUCT_CATALOG_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new ProductCatalog(id, context).createProductSet()
      .setName(\"Test Hotel Set\")
      .setFilter(\"{\\"brand\\":{\\"i_contains\\":\\"sample brand\\"}}\")
      .execute();

  }
}
Open In Graph API Explorer
require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<PRODUCT_CATALOG_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

product_catalog = FacebookAds::ProductCatalog.get(id)
product_sets = product_catalog.product_sets.create({
    name: 'Test Hotel Set',
    filter: {'brand':{'i_contains':'sample brand'}},
})
Open In Graph API Explorer

พารามิเตอร์ filter จะประกอบด้วยตัวดำเนินการและข้อมูลต่อไปนี้

ตัวควบคุมประเภทของฟิลเตอร์

i_contains

ประกอบด้วยสตริงย่อย ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

i_not_contains

ไม่ต้องประกอบด้วยสตริงย่อย ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

contains

ประกอบด้วยสตริงย่อย ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

not_contains

ไม่ต้องประกอบด้วยสตริงย่อย ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

eq

เท่ากับ ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

neq

ไม่เท่ากับ ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

lt

น้อยกว่า สำหรับช่องตัวเลขเท่านั้น

lte

น้อยกว่าหรือเท่ากับ สำหรับช่องตัวเลขเท่านั้น

gt

มากกว่า สำหรับช่องตัวเลขเท่านั้น

gte

มากกว่าหรือเท่ากับ สำหรับช่องตัวเลขเท่านั้น

ข้อมูลข้อมูลที่กำลังกรอง

hotel_id

ตัวระบุที่ไม่ซ้ำกันสำหรับโรงแรมในแค็ตตาล็อก

brand

แบรนด์ของเครือโรงแรม

base_price_amount

ราคาขั้นต่ำต่อคืนสำหรับโรงแรมนี้ ราคาในหน่วยเซ็นต์ (4999 หมายถึง $49.99)

sale_price_amount

ราคาลดพิเศษต่อคืนสำหรับโรงแรมนี้ ราคาในหน่วยเซ็นต์ (4999 หมายถึง $49.99)

currency

สกุลเงิน

city

เมืองที่โรงแรมตั้งอยู่

country

ประเทศที่โรงแรมตั้งอยู่

name

ชื่อที่เป็นที่รู้จักมากที่สุดของโรงแรมนี้

star_rating

การให้คะแนนเป็นดาวของโรงแรม ค่าที่ใช้ได้จะอยู่ระหว่าง 1 ถึง 5 และค่าควรเพิ่มขึ้นทีละ 0.5