โฆษณาอสังหาริมทรัพย์ - เริ่มต้นใช้งาน

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

ขั้นตอนที่ 1: สร้างแค็ตตาล็อกการลงประกาศขายบ้าน

ขั้นตอนที่ 2: ตั้งค่าการลงประกาศขายและการกำหนดราคา

ขั้นตอนที่ 4: กรองแค็ตตาล็อกการลงประกาศให้เป็นชุดการลงประกาศ

ขั้นตอนที่ 5: ส่งคอนเวอร์ชั่นแบบออฟไลน์ (ไม่บังคับ)

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

ขั้นตอนที่ 7: สร้างและแสดงโฆษณาสำหรับการลงประกาศขายบ้าน

ขั้นตอนที่ 8: รับข้อมูลการแสดงโฆษณาเพื่อดูว่าผู้คนบน Facebook แสดงความสนใจในโฆษณาของคุณอย่างไร โปรดดูข้อมูลเชิงลึกของโฆษณา

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

ขั้นตอนที่ 1: สร้างแค็ตตาล็อกการลงประกาศขายบ้าน

สำหรับโฆษณาแค็ตตาล็อก Advantage+

แค็ตตาล็อกของคุณควรมีรายการอสังหาริมทรัพย์ที่คุณต้องการโฆษณา โปรดดูข้อมูลอ้างอิงเกี่ยวกับแค็ตตาล็อก

หากต้องการสร้างแค็ตตาล็อกการลงประกาศขายบ้านสำหรับโฆษณาแค็ตตาล็อก Advantage+ ให้ตั้งค่า vertical เป็น home_listings

curl \
  -F 'name=Home Listing Catalog Name' \
  -F 'vertical=home_listings' \
  -F 'access_token=<ACCESS TOKEN>' \
  https://graph.facebook.com/<API_VERSION>

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

สำหรับการค้า

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

ขั้นตอนที่ 2: ตั้งค่าการลงประกาศและราคา

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

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

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

สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณต้องระบุฟีดการลงประกาศในรูปแบบใดรูปแบบหนึ่งดังนี้

รูปแบบไฟล์	คำอธิบาย	ไฟล์ตัวอย่าง
XML	โดยปกติแล้ว ระบบของผู้ให้บริการฟีดอัตโนมัติจะสร้างไฟล์รูปแบบนี้ โหนด XML `<listings>` รากจะครอบคลุมชุดโหนด `<listing>` ซึ่งแต่ละโหนดจะหมายถึงการลงประกาศขายบ้านหนึ่งรายการ ไฟล์จะต้องขึ้นต้นด้วยแท็กประกาศ `<?xml` ที่ถูกต้อง	ดาวน์โหลด
CSV, TSV	แถวแรกต้องแสดงรายการช่องที่เลือกไว้ตามลำดับค่าที่จะระบุ จากนั้น แถวต่อๆ มาจะแสดงค่าที่สอดคล้องกันสำหรับการลงประกาศขายบ้านแต่ละรายการ ช่องที่ซ้อนกันหรือมีหลายค่า เช่น รูปภาพ สามารถแสดงได้โดยใช้ค่าที่เข้ารหัส JSON หรือชุดคอลัมน์ข้อความธรรมดาที่ “ปรับให้เป็นระนาบเดียว” และมีการกำกับโดยใช้รูปแบบคำสั่งพาธ JSON เช่น `image[0].url`, `image[0].tag[0]` และ `image[0].tag[1]`	ดาวน์โหลด (CSV)

สำหรับการค้า คุณต้องระบุฟีดการลงประกาศในรูปแบบ XML

รูปแบบไฟล์ คำอธิบาย

รูปแบบไฟล์	คำอธิบาย
XML	โดยปกติแล้ว ระบบของผู้ให้บริการฟีดอัตโนมัติจะสร้างไฟล์รูปแบบนี้ โหนด XML `<listings>` รากจะครอบคลุมชุดโหนด `<listing>` ซึ่งแต่ละโหนดจะหมายถึงการลงประกาศขายบ้านหนึ่งรายการ ไฟล์จะต้องขึ้นต้นด้วยแท็กประกาศ `<?xml` ที่ถูกต้อง
CSV, TSV, JSON	*ขณะนี้ระบบยังไม่รองรับรูปแบบเหล่านี้*

XML

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

CSV, TSV, JSON

ขณะนี้ระบบยังไม่รองรับรูปแบบเหล่านี้

ตัวอย่างฟีด XML

<?xml version="1.0" encoding="UTF-8"?>
<listings>
    <title>example.com Feed</title>
    <link rel="self" href="http://www.example.com"/>
    <listing>
        <home_listing_id>12345678</home_listing_id>
        <name>1 Hacker Way, Menlo Park, CA 94025</name>
        <availability>for_rent</availability>
        <description>An amazing listing</description>
        <address format="simple">
            <component name="addr1">1 Hacker Way</component>
            <component name="city">Menlo Park</component>
            <component name="region">California</component>
            <component name="country">United States</component>
            <component name="postal_code">94025</component>
        </address>
        <latitude>1.11414</latitude>
        <longitude>-1.835003</longitude>
        <neighborhood>Menlo Oaks</neighborhood>
        <image>
            <url>http://example.com/12345678-1.jpg</url>
        </image>
        <image>
            <url>http://example.com/12345678-2.jpg</url>
        </image>
        <image>
            <url>http://example.com/12345678-3.jpg</url>
        </image>
        <listing_type>for_rent_by_agent</listing_type>
        <num_baths>6</num_baths>
        <num_beds>5</num_beds>
        <num_units>1</num_units>
        <price>110000 USD</price>
        <property_type>house</property_type>
        <url>http://www.example.com/link_to_listing</url>
        <year_built>2007</year_built>
    </listing>
</listings>

ช่องที่รองรับ - การลงประกาศขายบ้าน

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

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

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

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

ชื่อและประเภทของช่อง	คำอธิบาย
`home_listing_id` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ID การลงประกาศขายบ้าน (อพาร์ทเมนท์/คอนโด) ที่ไม่ซ้ำกัน โดยเป็น ID ที่มีรายละเอียดมากที่สุดเท่าที่จะเป็นไปได้ ตัวอย่าง: `FB_home_1234`
`home_listing_group_id` ประเภท: สตริง	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ ID ที่ไม่ซ้ำกันของอาคารหรืออพาร์ทเมนท์ โดยต้องไม่ซ้ำกันในแต่ละกลุ่ม
`name` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ชื่อของการลงประกาศขายบ้าน ตัวอย่าง: `Modern Eichler in Green Oaks`
`availability` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ความพร้อมจำหน่ายของการลงประกาศขายบ้านในปัจจุบัน ค่าที่รองรับได้แก่ `for_sale`, `for_rent`, `sale_pending`, `recently_sold`, `off_market`, `available_soon` สำหรับการค้า ระบบจะรองรับเฉพาะค่า "for_rent" เท่านั้น
`address` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ที่อยู่ของอสังหาริมทรัพย์ที่ต้องระบุตำแหน่งที่ตั้งได้อย่างถูกต้อง โปรดดูพารามิเตอร์อ็อบเจ็กต์ที่อยู่ ตัวอย่าง: `1 Hacker Way`
`address.city` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า เมืองที่อสังหาริมทรัพย์ตั้งอยู่ โปรดดูพารามิเตอร์อ็อบเจ็กต์ที่อยู่ ตัวอย่าง: `Menlo Park`
`address.region` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า รัฐ เขตปกครอง ภูมิภาค หรือจังหวัดของอสังหาริมทรัพย์ โปรดดูพารามิเตอร์อ็อบเจ็กต์ที่อยู่ ตัวอย่าง: `Menlo Park`
`address.country` ประเภท: อ็อบเจ็กต์	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ประเทศที่อสังหาริมทรัพย์ตั้งอยู่ โปรดดูพารามิเตอร์อ็อบเจ็กต์ที่อยู่ ตัวอย่าง: `United States`
`address.postal_code` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ประเทศที่อสังหาริมทรัพย์ตั้งอยู่ โปรดดูพารามิเตอร์อ็อบเจ็กต์ที่อยู่ ตัวอย่าง: `United States`
`latitude` ประเภท: ทศนิยม	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ละติจูดของการลงประกาศ ตัวอย่าง: `37.484100`
`longitude` ประเภท: ทศนิยม	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ลองจิจูดของการลงประกาศ ตัวอย่าง: `-122.148252`
`neighborhood` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ แต่เราแนะนำอย่างยิ่งให้ระบุ จำนวนย่านสูงสุดที่อนุญาตคือ 20 ย่าน ย่านของการลงประกาศขายอสังหาริมทรัพย์ ซึ่งสามารถมีได้หลายย่าน หากคุณมีย่านมากกว่า 1 ย่านในละแวกนั้น ให้เพิ่มคอลัมน์สำหรับแต่ละประเภทและใช้รูปแบบคำสั่งพาธ JSON ในชื่อคอลัมน์แต่ละรายการเพื่อระบุจำนวนย่าน ตัวอย่าง: `neighborhood[0]; neighborhood[1]`
`price` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ราคาขายหรือเช่าของอสังหาริมทรัพย์ รูปแบบของราคาที่เป็นค่าใช้จ่ายอิงตาม [รหัสสกุลเงิน ISO จำนวน 3 หลัก] (https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70"> โดยมีการเว้นวรรคระหว่างค่าใช้จ่ายและสกุลเงิน ตัวอย่าง: `13,999 USD`
`image` ประเภท: อ็อบเจ็กต์	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า จำนวนรูปภาพสูงสุดคือ 20 รูป ขนาดสูงสุดคือ 4 MB URL สำหรับรูปภาพที่ใช้ในโฆษณาของคุณ สำหรับอัตราส่วนภาพสี่เหลี่ยมจัตุรัส (1:1) ในรูปแบบโฆษณาแบบภาพสไลด์ รูปภาพของคุณควรมีขนาด 600x600 สำหรับโฆษณาแบบรูปเดียว รูปภาพของคุณควรมีขนาดอย่างน้อย 1200x630 พิกเซล สำหรับการค้า รูปภาพแรกจะแสดงในฟีดการค้าเป็นรูปภาพหน้าปก ตัวอย่าง: `image[0].url`, `image[0].tag[0]` โปรดดูพารามิเตอร์อ็อบเจ็กต์รูปภาพ
`url` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า ลิงก์ไปยังหน้าการลงประกาศขายอสังหาริมทรัพย์ โดยจะต้องเป็น URL ที่ถูกต้อง โปรดดูพารามิเตอร์อ็อบเจ็กต์รูปภาพ ตัวอย่าง: `http://www.realestate.com`
`description` ประเภท: สตริง	สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณจะระบุหรือไม่ก็ได้ แต่คุณจำเป็นต้องระบุหากเป็นกรณีของการค้า อักขระสูงสุด 5,000 ตัว คำอธิบายของอสังหาริมทรัพย์ ตัวอย่าง: `Beautiful 3BD home available in Belmont`
`num_beds` ประเภท: ทศนิยม	สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณจะระบุหรือไม่ก็ได้ แต่คุณจำเป็นต้องระบุหากเป็นกรณีของการค้า จำนวนห้องนอนทั้งหมด สำหรับห้องแบบสตูดิโอ คุณสามารถระบุค่านี้เป็น `0` ได้ ตัวอย่าง: `2`
`num_baths` ประเภท: ทศนิยม	สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณจะระบุหรือไม่ก็ได้ จำนวนห้องน้ำทั้งหมด สำหรับการค้า จะต้องระบุค่านี้เป็น `1` เป็นอย่างน้อย
`num_rooms` ประเภท: ทศนิยม	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ แต่คุณจำเป็นต้องระบุหากเป็นกรณีของการค้า จำนวนห้องทั้งหมดของอสังหาริมทรัพย์
`property_type` ประเภท: สตริง	สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณจะระบุหรือไม่ก็ได้ ประเภทของอสังหาริมทรัพย์ ค่าที่รองรับสำหรับโฆษณาแค็ตตาล็อก Advantage+ ได้แก่ `apartment`, `condo`, `house`, `land`, `manufactured`, `other` และ `townhouse` ค่าที่รองรับสำหรับการค้า ได้แก่ `apartment`, `builder_floor`, `condo`, `house`, `house_in_condominium`, `house_in_villa`, `loft`, `penthouse`, `studio`, `townhouse` และ `other`
`listing_type` ประเภท: สตริง	สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณจะระบุหรือไม่ก็ได้ ประเภทของการลงประกาศขายอสังหาริมทรัพย์ ค่าที่รองรับสำหรับโฆษณาแค็ตตาล็อก Advantage+ ได้แก่ `for_rent_by_agent`, `for_rent_by_owner`, `for_sale_by_agent`, `for_sale_by_owner`, `foreclosed`, `new_construction` และ `new_listing` ค่าที่รองรับสำหรับการค้า ได้แก่ `for_rent_by_agent` และ `for_rent_by_owner`
`area_size` ประเภท: จำนวนเต็ม	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ แต่คุณจำเป็นต้องระบุหากเป็นกรณีของการค้า พื้นที่หรือเนื้อที่ของแบบแปลนชั้นที่ลงประกาศ
`area_unit` ประเภท: สตริง	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ แต่คุณจำเป็นต้องระบุหากเป็นกรณีของการค้า ค่าของหน่วยพื้นที่ของชั้น (เป็นตารางฟุตหรือตารางเมตร) ค่าที่รองรับ ได้แก่ `sq_ft` และ `sq_m`
`ac_type` ประเภท: สตริง	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ ประเภทของเครื่องปรับอากาศ ค่าที่รองรับ ได้แก่ `central`, `other` และ `none`
`furnish_type` ประเภท: สตริง	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ ประเภทของเฟอร์นิเจอร์ที่มีอยู่ในอสังหาริมทรัพย์ ค่าที่รองรับ ได้แก่ `furnished`, `semi-furnished` และ `unfurnished`
`heating_type` ประเภท: สตริง	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ ประเภทของเครื่องทำความร้อนที่มีอยู่ในอสังหาริมทรัพย์ ค่าที่รองรับ ได้แก่ `central`, `gas`, `electric`, `radiator`, `other` และ `none`
`laundry_type` ประเภท: สตริง	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ ประเภทของเครื่องซักผ้าที่มี ค่าที่รองรับ ได้แก่ `in_unit`, `in_building`, `other` และ `none`
`num_units` ประเภท: จำนวนเต็ม	สำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า คุณจะระบุหรือไม่ก็ได้ จำนวนยูนิตทั้งหมด (อพาร์ทเมนท์ คอนโด) ที่มีให้เช่า ตัวอย่าง: `0`
`parking_type` ประเภท: สตริง	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ ประเภทของที่จอดรถที่มีอยู่ในอสังหาริมทรัพย์ ค่าที่รองรับ ได้แก่ `garage`, `street`, `off-street`, `other` และ `none`
`partner_verification` ประเภท: สตริง	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ บริษัทของพาร์ทเนอร์ได้ยืนยันการลงประกาศแล้วหรือไม่ ค่าที่รองรับ ได้แก่ `verified` และ `none`
`year_built` ประเภท: สตริง	ปีที่สร้างอสังหาริมทรัพย์ โดยใช้รูปแบบ ปปปป เป็นเลขปี 4 หลัก ตัวอย่างเช่น 1994
`pet_policy` ประเภท: สตริง	ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ ระบุสัตว์เลี้ยงที่ได้รับอนุญาตให้เข้าอยู่ในอสังหาริมทรัพย์ได้ ซึ่งได้แก่ `cat`, `dog`, `all` และ `none`
`available_dates_price_config` ประเภท: อ็อบเจ็กต์	รายการวันที่และราคาที่การลงประกาศพร้อมจำหน่าย เมื่อคุณระบุค่าต่างๆ Facebook จะสามารถแนะนำการลงประกาศตามวันที่พร้อมจำหน่ายและแสดงราคาที่เกี่ยวข้องในโฆษณาของคุณแบบไดนามิกได้ โปรดดูพารามิเตอร์อ็อบเจ็กต์วันที่พร้อมจำหน่าย
`applink` ประเภท: อ็อบเจ็กต์	ลิงก์ของแอพที่ไปยังการลงประกาศ
`status` ประเภท: สตริง	ควบคุมว่าจะเปิดใช้งานหรือจัดเก็บสินค้าในแค็ตตาล็อก ซึ่งผู้คนจะเห็นเฉพาะสินค้าที่เปิดใช้งานในโฆษณา ร้านค้า หรือช่องทางอื่นๆ ของคุณ ค่าที่รองรับ: `active`, `archived` ทั้งนี้ สินค้าจะเปิดใช้งานเป็นค่าเริ่มต้น โปรดเรียนรู้เพิ่มเติมเกี่ยวกับการจัดเก็บสินค้า ตัวอย่าง: `active` หมายเหตุ: แพลตฟอร์มของพาร์ทเนอร์บางแพลตฟอร์ม เช่น Shopify อาจซิงค์สินค้ากับแค็ตตาล็อกของคุณโดยใช้สถานะ "กำลังจัดเตรียม" ซึ่งมีลักษณะการทำงานเช่นเดียวกับ `archived` ช่องนี้มีชื่อเดิมว่า `visibility` แม้เราจะรองรับชื่อช่องแบบเดิมอยู่ แต่เราก็ขอแนะนำให้คุณใช้ชื่อแบบใหม่

home_listing_id

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ID การลงประกาศขายบ้าน (อพาร์ทเมนท์/คอนโด) ที่ไม่ซ้ำกัน โดยเป็น ID ที่มีรายละเอียดมากที่สุดเท่าที่จะเป็นไปได้

ตัวอย่าง: FB_home_1234

home_listing_group_id

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

ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้

ID ที่ไม่ซ้ำกันของอาคารหรืออพาร์ทเมนท์ โดยต้องไม่ซ้ำกันในแต่ละกลุ่ม

name

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ชื่อของการลงประกาศขายบ้าน ตัวอย่าง: Modern Eichler in Green Oaks

availability

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ความพร้อมจำหน่ายของการลงประกาศขายบ้านในปัจจุบัน ค่าที่รองรับได้แก่ for_sale, for_rent, sale_pending, recently_sold, off_market, available_soon สำหรับการค้า ระบบจะรองรับเฉพาะค่า "for_rent" เท่านั้น

address

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ที่อยู่ของอสังหาริมทรัพย์ที่ต้องระบุตำแหน่งที่ตั้งได้อย่างถูกต้อง

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

ตัวอย่าง: 1 Hacker Way

address.city

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

เมืองที่อสังหาริมทรัพย์ตั้งอยู่

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

ตัวอย่าง: Menlo Park

address.region

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

รัฐ เขตปกครอง ภูมิภาค หรือจังหวัดของอสังหาริมทรัพย์

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

ตัวอย่าง: Menlo Park

address.country

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ประเทศที่อสังหาริมทรัพย์ตั้งอยู่

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

ตัวอย่าง: United States

address.postal_code

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ประเทศที่อสังหาริมทรัพย์ตั้งอยู่

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

ตัวอย่าง: United States

latitude

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ละติจูดของการลงประกาศ

ตัวอย่าง: 37.484100

longitude

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ลองจิจูดของการลงประกาศ

ตัวอย่าง: -122.148252

neighborhood

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

จำเป็นต้องระบุสำหรับโฆษณาแค็ตตาล็อก Advantage+ ส่วนกรณีของการค้า คุณจะระบุหรือไม่ก็ได้ แต่เราแนะนำอย่างยิ่งให้ระบุ

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

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

ตัวอย่าง: neighborhood[0]; neighborhood[1]

price

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ราคาขายหรือเช่าของอสังหาริมทรัพย์ รูปแบบของราคาที่เป็นค่าใช้จ่ายอิงตาม [รหัสสกุลเงิน ISO จำนวน 3 หลัก] (https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70"> โดยมีการเว้นวรรคระหว่างค่าใช้จ่ายและสกุลเงิน

ตัวอย่าง: 13,999 USD

image

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

จำนวนรูปภาพสูงสุดคือ 20 รูป

ขนาดสูงสุดคือ 4 MB

URL สำหรับรูปภาพที่ใช้ในโฆษณาของคุณ

สำหรับอัตราส่วนภาพสี่เหลี่ยมจัตุรัส (1:1) ในรูปแบบโฆษณาแบบภาพสไลด์ รูปภาพของคุณควรมีขนาด 600x600
สำหรับโฆษณาแบบรูปเดียว รูปภาพของคุณควรมีขนาดอย่างน้อย 1200x630 พิกเซล
สำหรับการค้า รูปภาพแรกจะแสดงในฟีดการค้าเป็นรูปภาพหน้าปก

ตัวอย่าง: image[0].url, image[0].tag[0]

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

url

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

ลิงก์ไปยังหน้าการลงประกาศขายอสังหาริมทรัพย์ โดยจะต้องเป็น URL ที่ถูกต้อง

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

ตัวอย่าง: http://www.realestate.com

description

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

สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณจะระบุหรือไม่ก็ได้ แต่คุณจำเป็นต้องระบุหากเป็นกรณีของการค้า

อักขระสูงสุด 5,000 ตัว

คำอธิบายของอสังหาริมทรัพย์

ตัวอย่าง: Beautiful 3BD home available in Belmont

num_beds

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

จำนวนห้องนอนทั้งหมด สำหรับห้องแบบสตูดิโอ คุณสามารถระบุค่านี้เป็น 0 ได้

ตัวอย่าง: 2

num_baths

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

สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณจะระบุหรือไม่ก็ได้

จำนวนห้องน้ำทั้งหมด สำหรับการค้า จะต้องระบุค่านี้เป็น 1 เป็นอย่างน้อย

num_rooms

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

ไม่สามารถใช้ได้กับโฆษณาแค็ตตาล็อก Advantage+ แต่คุณจำเป็นต้องระบุหากเป็นกรณีของการค้า

จำนวนห้องทั้งหมดของอสังหาริมทรัพย์

property_type

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

สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณจะระบุหรือไม่ก็ได้

ประเภทของอสังหาริมทรัพย์ ค่าที่รองรับสำหรับโฆษณาแค็ตตาล็อก Advantage+ ได้แก่ apartment, condo, house, land, manufactured, other และ townhouse ค่าที่รองรับสำหรับการค้า ได้แก่ apartment, builder_floor, condo, house, house_in_condominium, house_in_villa, loft, penthouse, studio, townhouse และ other

listing_type

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

สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณจะระบุหรือไม่ก็ได้

ประเภทของการลงประกาศขายอสังหาริมทรัพย์ ค่าที่รองรับสำหรับโฆษณาแค็ตตาล็อก Advantage+ ได้แก่ for_rent_by_agent, for_rent_by_owner, for_sale_by_agent, for_sale_by_owner, foreclosed, new_construction และ new_listing ค่าที่รองรับสำหรับการค้า ได้แก่ for_rent_by_agent และ for_rent_by_owner

area_size

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

พื้นที่หรือเนื้อที่ของแบบแปลนชั้นที่ลงประกาศ

area_unit

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

ค่าของหน่วยพื้นที่ของชั้น (เป็นตารางฟุตหรือตารางเมตร) ค่าที่รองรับ ได้แก่ sq_ft และ sq_m

ac_type

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

ประเภทของเครื่องปรับอากาศ ค่าที่รองรับ ได้แก่ central, other และ none

furnish_type

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

ประเภทของเฟอร์นิเจอร์ที่มีอยู่ในอสังหาริมทรัพย์ ค่าที่รองรับ ได้แก่ furnished, semi-furnished และ unfurnished

heating_type

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

ประเภทของเครื่องทำความร้อนที่มีอยู่ในอสังหาริมทรัพย์ ค่าที่รองรับ ได้แก่ central, gas, electric, radiator, other และ none

laundry_type

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

ประเภทของเครื่องซักผ้าที่มี ค่าที่รองรับ ได้แก่ in_unit, in_building, other และ none

num_units

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

สำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า คุณจะระบุหรือไม่ก็ได้

จำนวนยูนิตทั้งหมด (อพาร์ทเมนท์ คอนโด) ที่มีให้เช่า

ตัวอย่าง: 0

parking_type

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

ประเภทของที่จอดรถที่มีอยู่ในอสังหาริมทรัพย์ ค่าที่รองรับ ได้แก่ garage, street, off-street, other และ none

partner_verification

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

บริษัทของพาร์ทเนอร์ได้ยืนยันการลงประกาศแล้วหรือไม่ ค่าที่รองรับ ได้แก่ verified และ none

year_built

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

ปีที่สร้างอสังหาริมทรัพย์ โดยใช้รูปแบบ ปปปป เป็นเลขปี 4 หลัก

ตัวอย่างเช่น 1994

pet_policy

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

ระบุสัตว์เลี้ยงที่ได้รับอนุญาตให้เข้าอยู่ในอสังหาริมทรัพย์ได้ ซึ่งได้แก่ cat, dog, all และ none

available_dates_price_config

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

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

โปรดดูพารามิเตอร์อ็อบเจ็กต์วันที่พร้อมจำหน่าย

applink

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

ลิงก์ของแอพที่ไปยังการลงประกาศ

status

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

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

ตัวอย่าง: active

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

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

ช่องที่ต้องระบุเฉพาะบางประเทศ — สำหรับการค้าเท่านั้น

ไปที่เอกสารประกอบของแพลตฟอร์ม Marketplace เพื่อดูช่องที่ต้องระบุเฉพาะบางประเทศสำหรับการค้า

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

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

ชื่อและประเภทของช่อง	คำอธิบาย
`url` ประเภท: สตริง	จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า URL แหล่งที่มาของรูปภาพ ดำเนินการตามข้อมูลจำเพาะสำหรับรูปภาพต่อไปนี้ รูปภาพทั้งหมดต้องเป็นรูปแบบ JPG, GIF หรือ PNG สำหรับโฆษณาแบบภาพสไลด์และโฆษณาคอลเลกชั่น: รูปภาพที่แสดงต้องเป็นแบบสี่เหลี่ยมจัตุรัส (1:1) และมีขนาดขั้นต่ำที่ 500 x 500 พิกเซล เราขอแนะนำให้ใช้รูปภาพขนาด 1024 x 1024 พิกเซล เพื่อให้ได้คุณภาพที่ดีที่สุด สำหรับโฆษณาที่มีรูปภาพรูปเดียว: รูปภาพที่แสดงต้องมีอัตราส่วนกว้างยาวเท่ากับ 1.91:1 และมีขนาดขั้นต่ำที่ 500 x 500 พิกเซล เราขอแนะนำให้ใช้รูปภาพขนาด 1200 x 628 พิกเซล เพื่อให้ได้คุณภาพที่ดีที่สุด
`tag` ประเภท: สตริง	สำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า คุณจะระบุหรือไม่ก็ได้ แท็กที่ต่อท้ายรูปภาพที่จะบอกว่าในรูปภาพมีอะไรอยู่ โดยรูปภาพหนึ่งรูปสามารถมีแท็กที่เชื่อมโยงกับรูปภาพได้หลายแท็ก ตัวอย่าง: `Fitness Center`, `Swimming Pool` `INSTAGRAM_STANDARD_PREFERRED` - ทำให้ผู้ลงโฆษณาสามารถแท็กรูปภาพที่ต้องการในฟีดเป็นรูปภาพเริ่มต้นที่จะใช้สำหรับ Instagram แท็กนี้คำนึงถึงอักษรตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

url

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

จำเป็นต้องระบุสำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า

URL แหล่งที่มาของรูปภาพ ดำเนินการตามข้อมูลจำเพาะสำหรับรูปภาพต่อไปนี้

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

tag

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

สำหรับโฆษณาแคตตาล็อก Advantage+ และการค้า คุณจะระบุหรือไม่ก็ได้

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

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

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

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

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

ชื่อและประเภทของช่อง	คำอธิบาย
`addr1` ประเภท: สตริง	จำเป็นต้องระบุ ที่อยู่ของโรงแรม ตัวอย่าง: `675 El Camino Real`
`city` ประเภท: สตริง	จำเป็นต้องระบุ เมืองที่โรงแรมตั้งอยู่ ตัวอย่าง: `Palo Alto`
`region` ประเภท: สตริง	จำเป็นต้องระบุ รัฐ เขตปกครอง ภูมิภาค หรือจังหวัดของโรงแรม ตัวอย่าง: `California`
`country` ประเภท: สตริง	จำเป็นต้องระบุ ประเทศที่โรงแรมตั้งอยู่ ตัวอย่าง: `United States`
`postal_code` ประเภท: สตริง	รหัสไปรษณีย์ของอสังหาริมทรัพย์ จำเป็นต้องระบุ ยกเว้นประเทศที่ไม่มีระบบรหัสไปรษณีย์ ตัวอย่าง: `94125`, `NW1 3FG`

addr1

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

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

ที่อยู่ของโรงแรม

ตัวอย่าง: 675 El Camino Real

city

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

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

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

ตัวอย่าง: Palo Alto

region

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

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

รัฐ เขตปกครอง ภูมิภาค หรือจังหวัดของโรงแรม

ตัวอย่าง: California

country

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

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

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

ตัวอย่าง: United States

postal_code

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

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

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

การกำหนดค่าวันที่พร้อมให้บริการและราคา

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

พารามิเตอร์อ็อบเจ็กต์วันที่พร้อมให้บริการ

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

ชื่อและประเภทของช่อง	คำอธิบาย
`start_date` ประเภท: สตริง	หากมีการระบุ `end_date` คุณจะระบุหรือไม่ก็ได้ วันที่เริ่มต้นของช่วงวันที่ที่พร้อมให้บริการในรูปแบบ ISO-8601 ซึ่งจะรวมวันที่เริ่มต้นไว้ หากคุณระบุแค่ `start_date` ค่า `end_date` จะมีค่าเริ่มต้นเป็นหนึ่งปีนับจากวันที่ที่คุณได้ระบุไว้ ตัวอย่าง: `YYYY-MM-DD` เช่น `2018-01-01`
`end_date` ประเภท: สตริง	หากมีการระบุ `start_date` คุณจะระบุหรือไม่ก็ได้ วันที่สิ้นสุดของช่วงวันที่ที่พร้อมให้บริการในรูปแบบ ISO-8601 ซึ่งจะไม่รวมวันที่สิ้นสุดไว้ หากคุณระบุแค่ `end_date` ค่า `start_date` จะมีค่าเริ่มต้นเป็นวันที่ปัจจุบัน ตัวอย่าง: `YYYY-MM-DD` เช่น `2018-02-01`
`rate` ประเภท: สตริง	ราคาที่เป็นจำนวนเต็มของการลงประกาศในช่วงเวลานี้ ตัวอย่าง: `10000` หากการลงประกาศเป็น `$100.00 USD`
`currency` ประเภท: สตริง	จำเป็นต้องระบุ หากคุณระบุ `rate` รหัสสกุลเงิน ISO-4217 ตัวอย่าง: `USD`, `GBP` เป็นต้น
`interval` ประเภท: สตริง	ระยะเวลาเข้าพักอาศัยในอัตราที่ระบุ ค่าที่อนุญาต ได้แก่ `nightly`, `weekly`, `monthly` และ `sale`

start_date

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

หากมีการระบุ end_date คุณจะระบุหรือไม่ก็ได้

วันที่เริ่มต้นของช่วงวันที่ที่พร้อมให้บริการในรูปแบบ ISO-8601 ซึ่งจะรวมวันที่เริ่มต้นไว้ หากคุณระบุแค่ start_date ค่า end_date จะมีค่าเริ่มต้นเป็นหนึ่งปีนับจากวันที่ที่คุณได้ระบุไว้

ตัวอย่าง: YYYY-MM-DD เช่น 2018-01-01

end_date

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

หากมีการระบุ start_date คุณจะระบุหรือไม่ก็ได้

วันที่สิ้นสุดของช่วงวันที่ที่พร้อมให้บริการในรูปแบบ ISO-8601 ซึ่งจะไม่รวมวันที่สิ้นสุดไว้ หากคุณระบุแค่ end_date ค่า start_date จะมีค่าเริ่มต้นเป็นวันที่ปัจจุบัน

ตัวอย่าง: YYYY-MM-DD เช่น 2018-02-01

rate

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

ราคาที่เป็นจำนวนเต็มของการลงประกาศในช่วงเวลานี้

ตัวอย่าง: 10000 หากการลงประกาศเป็น $100.00 USD

currency

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

จำเป็นต้องระบุ หากคุณระบุ rate

รหัสสกุลเงิน ISO-4217

ตัวอย่าง: USD, GBP เป็นต้น

interval

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

ระยะเวลาเข้าพักอาศัยในอัตราที่ระบุ

ค่าที่อนุญาต ได้แก่ nightly, weekly, monthly และ sale

นี่คือตัวอย่างความพร้อมให้บริการของการลงประกาศและการแสดงผลในรูปแบบ JSON

"available_dates_price_config": [
    {
        // available until 11/01 at $150/night
        "end_date": "2018-11-01",
        "rate": "15000",
        "currency": "USD",
        "interval": "nightly",
    },
    {
        // available from 11/01 - 12/01 at $200/night
        "start_date": "2018-11-01",
        "end_date": "2018-12-01",
        "rate": "20000",
        "currency": "USD",
        "interval": "nightly",
    },
    {
        // available from 11/01 onward at $500/week
        "start_date": "2018-11-01",
        "rate": "50000",
        "currency": "USD",
        "interval": "weekly",
    },
]

Deep Link ของสินค้า

ระบุ Deep Linkในฟีดตามข้อมูลจำเพาะของลิงก์ที่ไปยังแอพ ข้อมูล Deep Link ในฟีดมีความสำคัญมากกว่าข้อมูลใดๆ ที่ Facebook เก็บรวบรวมไว้ผ่านเมตาดาต้าของลิงก์ที่ไปยังแอพโดยเว็บครอว์เลอร์ของเรา

หากคุณมีข้อมูล Deep Link จากลิงก์ที่ไปยังแอพอยู่แล้ว คุณไม่ต้องระบุข้อมูลนี้ Facebook ใช้ข้อมูลจากลิงก์ที่ไปยังแอพเพื่อแสดง Deep Link ที่ถูกต้อง หากต้องการแสดง Deep Link ในโฆษณาของคุณ โปรดดูโฆษณาแค็ตตาล็อก Advantage+, เทมเพลตโฆษณา

ขั้นตอนที่ 3: อัพเดตตัวเลือก

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

สำหรับโฆษณาแค็ตตาล็อก Advantage+ คุณสามารถรีเฟรชข้อมูลการลงประกาศขายบ้านในแค็ตตาล็อกได้ด้วยวิธีต่อไปนี้ผ่านการอัพโหลดโดยตรง โปรดดูข้อมูลอ้างอิงเกี่ยวกับฟีดการอัพโหลดโดยตรง

ตัวอย่าง — คุณสามารถอัพโหลดแบบครั้งเดียวได้ด้วยตนเอง

curl \
  -F "url=http://www.example.com/sample_feed.xml" \
  -F "access_token=

การค้า

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

ตั้งกำหนดเวลาสำหรับการอัพโหลดฟีดข้อมูลแค็ตตาล็อกของคุณ

ไปที่ตัวจัดการการค้า
คลิก "แหล่งข้อมูล"
คลิก "เพิ่มแหล่งข้อมูล"
คลิก "ใช้ฟีดข้อมูล" แล้วคลิก "ถัดไป"
คลิก "ตั้งกำหนดเวลา"
เลือกว่าคุณต้องการให้ Facebook ตรวจสอบฟีดข้อมูลของคุณเพื่อดำเนินการอัพเดตบ่อยแค่ไหน โดยมีตัวเลือกคือ ทุกวันทุกชั่วโมง และทุกสัปดาห์ หากคุณเลือกความถี่เป็น ทุกชั่วโมงหรือทุกสัปดาห์ คุณจะสามารถระบุได้ด้วยว่าจะดำเนินการอัพโหลดที่กำหนดเวลาไว้ซ้ำอีกครั้งเมื่อใด
ป้อน URL ตรงสำหรับฟีดของคุณ คุณสามารถใช้ URL ที่ใช้ HTTP, HTTPS, FTP หรือ SFTP ได้ หมายเหตุ: URL ควรจะนำไปยังไฟล์ฟีดข้อมูลของคุณโดยตรง มิฉะนั้นการอัพโหลดอาจล้มเหลวได้
ป้อนชื่อผู้ใช้และรหัสผ่านสำหรับผู้ให้บริการฟีดข้อมูล (ไม่บังคับ) ซึ่งจะไม่เหมือนกับชื่อผู้ใช้และรหัสผ่านที่คุณใช้ในการเข้าถึงบัญชีโฆษณา Facebook ของคุณ
ป้อนชื่อฟีดข้อมูลของคุณ
เลือกประเภทสกุลเงินสำหรับฟีดข้อมูลของคุณ ประเภทสกุลเงินนี้จะใช้สำหรับฟีดข้อมูลของคุณ หากคุณไม่ได้ระบุไว้ในไฟล์ฟีดข้อมูล
คลิก "ถัดไป"
ตรวจทานไฟล์ฟีดข้อมูลของคุณเพื่อหาข้อผิดพลาด หากคุณไม่มีคอลัมน์ที่จำเป็นต้องมีในไฟล์ของคุณ หรือมีคอลัมน์ที่ Facebook ไม่รู้จัก คุณสามารถแมปคอลัมน์เหล่านั้นกับคอลัมน์ที่เหมาะสมได้ที่นี่ ระบบจะบันทึกคอลัมน์ที่แมปไว้สำหรับการอัพโหลดฟีดข้อมูลในอนาคต
คลิก "ถัดไป"

การอัพโหลดฟีดหลายภาษา

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

ฟีเจอร์นี้ใช้ได้กับพาร์ทเนอร์บางประเทศเท่านั้น โปรดติดต่อตัวแทน Facebook ของคุณเพื่อดูว่าใช้ฟีเจอร์นี้ได้หรือไม่ในประเทศของคุณ

สร้างแค็ตตาล็อกที่มีฟีดข้อมูลสำหรับภาษาและประเทศเริ่มต้น
สร้างไฟล์ XML ที่มีเฉพาะ ID การลงประกาศ (home_listing_id) และช่องเพิ่มเติมที่กำหนดให้ต้องเขียนทับด้วยภาษาท้องถิ่น เช่น ชื่อ คำอธิบาย หรือช่องเพิ่มเติม หากต้องการเขียนทับข้อมูล home_listing_id จะต้องตรงกับ ID ที่มีอยู่ในฟีดข้อมูลแค็ตตาล็อกดั้งเดิม
เพิ่มฟีดข้อมูลเพิ่มเติมจากตัวจัดการการค้า

เพิ่มฟีดเพิ่มเติมจากตัวจัดการการค้า [เพิ่มข้อมูลการลงประกาศขายบ้าน] - [เพิ่มข้อมูลภาษา]
ยืนยันแหล่งข้อมูล 2 แหล่งภายในแค็ตตาล็อกเดียวกัน

ขั้นตอนที่ 4: กรองแค็ตตาล็อกการลงประกาศให้เป็นชุดการลงประกาศ

นี่คือกลุ่มของรายการในแค็ตตาล็อกที่คุณโฆษณาในโฆษณาแค็ตตาล็อก Advantage+ ของคุณ โดยแค็ตตาล็อกการลงประกาศแต่ละรายการสามารถมีชุดการลงประกาศได้หลายชุด

curl \
  -F "name=test set" \
  -F 'filter={"availability":{"eq":"for_sale"}}' \
  -F "access_token=" \
  https://graph.facebook.com/

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

ตัวดำเนินการ	ประเภทของตัวกรอง
`i_contains`	มีสตริงย่อย (ไม่บังคับใช้ตัวอักษรพิมพ์เล็กหรือพิมพ์ใหญ่)
`i_not_contains`	ไม่มีสตริงย่อย (ไม่บังคับใช้ตัวอักษรพิมพ์เล็กหรือพิมพ์ใหญ่)
`contains`	มีสตริงย่อย (ต้องตรงตามตัวพิมพ์เล็กหรือใหญ่)
`not_contains`	ไม่มีสตริงย่อย (ต้องตรงตามตัวพิมพ์เล็กหรือใหญ่)
`eq`	เท่ากับ (ไม่บังคับใช้ตัวอักษรพิมพ์เล็กหรือพิมพ์ใหญ่)
`neq`	ไม่เท่ากับ (ไม่บังคับใช้ตัวอักษรพิมพ์เล็กหรือพิมพ์ใหญ่)
`lt`	น้อยกว่า (ช่องตัวเลขเท่านั้น)
`lte`	น้อยกว่าหรือเท่ากับ (ช่องตัวเลขเท่านั้น)
`gt`	มากกว่า (ช่องตัวเลขเท่านั้น)
`gte`	มากกว่าหรือเท่ากับ (ช่องตัวเลขเท่านั้น)

ข้อมูล	ข้อมูลที่จะกรอง
`availability`	ความพร้อมให้บริการของการลงประกาศ ตัวอย่าง: `for_sale`
`listing_type`	ประเภทของการลงประกาศ ตัวอย่าง: `for_sale_by_agent`
`property_type`	ประเภทของอสังหาริมทรัพย์ ตัวอย่าง: `house`
`price`	ราคาของการลงประกาศ
`name`	ชื่อ
`city`	เมือง
`country`	ประเทศ
`region`	ภูมิภาคหรือรัฐ
`postal_code`	รหัสไปรษณีย์
`num_beds`	จำนวนห้องนอน
`num_baths`	จำนวนห้องน้ำ

ขั้นตอนที่ 5: ส่งคอนเวอร์ชั่นแบบออฟไลน์

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

คีย์การจับคู่

คีย์การจับคู่จะเปรียบเทียบคอนเวอร์ชั่นกับผู้ใช้

คีย์	คำอธิบาย
`email`	อีเมล แฮช
`phone`	หมายเลขโทรศัพท์ แฮช
`fn`	ชื่อ แฮช
`ln`	นามสกุล แฮช
`madid`	ID การโฆษณาของ Apple หรือ Android แฮช
`zip`	รหัสไปรษณีย์ แฮช
`ct`	เมือง แฮช
`st`	รัฐ แฮช
`country`	ประเทศ แฮช
`dob`	วันเกิด (รูปแบบ วว) แฮช
`doby`	วันเกิด (รูปแบบ ปปปป) แฮช
`gen`	เพศ แฮช
`age`	อายุ แฮช
`lead_id`	ID ข้อมูลลูกค้าของข้อมูลลูกค้าใน Marketplace

ข้อมูลแบบกำหนดเอง

ข้อมูลแบบกำหนดเองจะเปรียบเทียบคอนเวอร์ชั่นกับตัวแทนจำหน่าย

ช่อง	คำอธิบาย
`content_ids`	`home_listing_id` จากการอัพโหลดแค็ตตาล็อก
`content_type`	ตั้งค่าเป็น `APARTMENT`

รายละเอียดเหตุการณ์

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

ช่อง	คำอธิบาย
`event_name`	จำเป็นต้องระบุ enum ของประเภทเหตุการณ์มีดังต่อไปนี้ `ViewContent` `Search` `AddToCart` `AddToWishlist` `Lead` = มีการโทรศัพท์หรือข้อมูลลูกค้าอื่นๆ ที่ผ่านเกณฑ์ `CompleteRegistration` = การตั้งค่าการนัดหมาย `InitiateCheckout` = การเข้าพบเอเจนซี่ `AddPaymentInfo` = การเข้าชมอสังหาริมทรัพย์ `Purchase` = มีการลงนามสัญญาเช่า `Other`
`event_time`	จำเป็นต้องระบุ เวลาของเหตุการณ์
`value`	จำเป็นต้องระบุ ค่าของการเช่า ตั้งค่าเป็น `0` สำหรับเหตุการณ์ที่ไม่มีการเช่า
`currency`	จำเป็นต้องระบุ รหัสสกุลเงิน