ประเทศไทย - ที่อยู่อาศัย XML

หากคุณมีเว็บไซท์เพื่อการลงประกาศโฆษณาพร้อมโฆษณาสาธารณะ ลงประกาศของคุณกับ!
ทำตามขั้นตอนง่ายๆต่อไปนี้:

1. จัดเตรียม UTF-8 XML ในรูปแบบที่ระบุไว้สำหรับ หน้าหลัก แนวตั้ง(ดูด้านล่าง)
2. ส่งลิ้งค์ URL ที่เราสามารถอ่าน XML feed ของคุณไปยัง ติดต่อ Trovit (ตัวอย่าง: http://www.yourdomain.com/wp_feed.xml)

เมื่อได้รับ feed ของคุณ เราจะจัดโฆษณาของคุณเข้าหมวดหมู่ใน Trovit, Mitula, Nestoria, อย่างรวดเร็วที่สุดเท่าที่จะเป็นไปได้
หากคุณมีคำถามหรือข้อกังวลใดๆโปรดอย่าลังเลที่จะติดต่อเรา!

รูปแบบ XML FEED

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

*feed ควรเขียนในรหัสUTF-8 ไฟล์มีหนึ่ง ‘trovit’ tag และมีองค์ประกอบ ‘ad’ หนึ่งหรือมากกว่า แต่ละองค์ประกอบ ‘ad’ มีช่องข้อมูลดังต่อไปนี้:

ช่องข้อมูลที่จำเป็น

ช่องข้อมูลต่อไปนี้จำเป็นต้องมีใน feed เนื่องจากเป็นการจัดเก็บข้อมูลที่เบื้องต้นที่จำเป็นต่อระบบของเราในการรวมเอาโฆษณาของคุณเข้าไว้ในTrovit

• id: หมายเลขประจำตัวของประกาศบนเว็บไซท์ของคุณ (ตัวเลขหรือเป็นการรวมกันของตัวเลขและตัวอักษรก็ได้ อย่างไรก็ตาม หมายเลขประจำตัวนี้ต้อง มีลักษณะเฉพาะ เพราะเราใช้มันเพื่อหลีกเลี่ยงการลงข้อมูลซ้ำ)
• url: URL ของประกาศบนเว็บไซท์ของคุณ
• title: พาดหัวของประกาศ (สรุปประกาศแบบสั้นๆได้ใจความโดยไม่รวมชื่อเว็บไซท์หรือ URL)
• type: เลือกประเภทอสังหาริมทรัพย์ที่เหมาะสมสำหรับประกาศของคุณ:
  • “for rent”: อสังหาริมทรัพย์ให้เช่า
  • “for sale”: ขายอสังหาริมทรัพย์
• content: รายละเอียดอสังหาริมทรัพย์(ขั้นต่ำ 30 ตัวอักษร) โปรดทราบว่าคุณภาพของรายละเอียดที่ให้มีผลอย่างมากต่อจำนวนผู้เข้าชมที่คุณจะได้รับ!

ช่องข้อมูลทางเลือก

ช่องข้อมูลทางเลือกไม่จำเป็นใน feed อย่างไรก็ดี หากคุณมีข้อมูลอยู่ก็เป็นการดีที่สุดที่จะกรอกลงไปด้วย! อัลกอริธึมของ Trovit ให้ความสำคัญกับประกาศที่มีคุณภาพก่อน ดังนั้นยิ่งมีข้อมูลมากเท่าไหร่ ก็ยิ่งเพิ่มประสิทธิภาพในการจัดอันดับของคุณในโปรแกรมการค้นหาของเรา !

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

  <price period="weekly"><![CDATA[...]]></price>
  <price period="daily"><![CDATA[...]]></price>

  โปรดอย่าใส่เครื่องหมาย อย่างเช่น $ หรือ € หากราคาถูกระบุไว้ในหน่วยเงินตราอื่นนอกเหนือจากหน่วยเงินตราอย่างเป็นทางการ (ดอลลาร์สหรัฐฯ/$) โปรดใช้ซินแท็กซ์ภายใน tag ‘ราคา’ โดยใช้ ISO-4217 นี่จะทำให้ Trovit เปลี่ยนแปลงราคาไปเป็นหน่วยเงินตราอย่างเป็นทางการได้ (ดอลลาร์สหรัฐฯ/$)

  <price period="weekly" currency="CAD"><![CDATA[...]]></price>

  ในตัวอย่างนี้ ราคาค่าเช่ารายสัปดาห์อยู่ในสกุลดอลลาร์แคนาดา Trovit จะแปลงเป็นดอลลาร์สหรัฐฯ

• property_type: อพาร์ตเมนต์, บ้าน, สตูดิโอ,คอนโด (สามารถระบุได้เมื่อคุณกรอก “ให้เช่า” หรือ “ขาย” ในช่อง “ประเภท”) กรุณาอ่าน เอกสารข้อกำหนดทางเทคนิค ของเราสำหรับรายละเอียดเพิ่มเติม

• address: ที่อยู่ถนน
• floor_number: หมายเลขชั้น
• city_area: เขตเมืองหรือพื้นที่ใกล้เคียงที่อสังหาริมทรัพย์นั้นตั้งอยู่
• city: ชื่อเมือง
• postcode: รหัสไปรษณีย์
• region: รัฐ (sสามารถใช้ตัวย่อชื่อรัฐได้)
• latitude: ละติจูดของอสังหาริมทรัพย์ [-90.0, 90.0]
• longitude: ลองจิจูดของของอสังหาริมทรัพย์ [-180.0,180.0]
• orientation: ทิศของอสังหาริมทรัพย์: เหนือ, ใต้, ตะวันออก หรือตะวันตก
• agency: ชื่อของตัวแทนขาย
• mls_database: MLS ID#
• floor_area: พื้นที่อสังหาริมทรัพย์เป็นตารางฟุต (ตัวเลขจำนวนเต็ม)
• plot_area: ขนาดที่ดิน/ ความกว้างที่ดินซึ่งอสังหาริมทรัพย์ตั้งอยู่; เลือกหนึ่งในค่าต่อไปนี้:

  <plot_area unit="feet"><![CDATA[...]]></plot_area>
  <plot_area unit="acres"><![CDATA[...]]></plot_area>

• rooms: จำนวนห้องนอน
• bathrooms: จำนวนห้องน้ำ, อนุญาตให้ใช้ค่าทศนิยม
• condition: สภาพบ้าน เช่น: “ปรับปรุงใหม่” หรือ “อพาร์ตเมนต์มือสอง”
• year: ปีที่สร้างอสังหาริมทรัพย์ในรูปแบบ: ปี
• virtual_tour: URL ไปยังการนำชมภาพอสังหาริมทรัพย์แบบเสมือนจริง
• eco_score: ข้อมูลในรูปแบบข้อความอิสระ เกี่ยวกับประสิทธิภาพการใช้พลังงานของอสังหาริมทรัพย์
• pictures: tag นี้รวมถึงภาพที่ชัดเจนของอสังหาริมทรัพย์
  ช่องข้อมูลระบุภาพเจาะจงของอสังหาริมทรัพย์คือ <picture>:
  • picture: tag นี้รวมถึงช่องข้อมูลระบุ URL และชื่อภาพ (ชื่อภาพไม่บังคับ) คุณสามารถระบุได้หากภาพได้รับการเน้นภายในคุณสมบัติ “เด่น”

    <picture featured="true"><![CDATA[...]]></picture>

    ค่าที่สามารถใช้งานได้สำหรับคุณสมบัติ “เด่น” คือ: “จริง” หรือ “เท็จ”

    ช่องข้อมูลที่ระบุภายในส่วนประกอบ คือ:

    • picture_url: URL ภาพ
    • picture_title: ชื่อภาพ

  <pictures>
      <picture>
          <picture_url><![CDATA[...]]></picture_url>
          <picture_title><![CDATA[...]]>/picture_title>
      </picture> 
      <picture featured="true">
          <picture_url><![CDATA[...]]></picture_url>
          <picture_title><![CDATA[...]]>/picture_title>
      </picture>
          ...
  </pictures>

  ภาพที่แสดงใน Trovit สำหรับโฆษณาหนึ่งจะแสดงเป็นภาพแรกในชุดภาพสำหรับโฆษณานั้น เว้นแต่จะมีภาพใดภาพหนึ่งระบุเป็นภาพ “เด่น”
  เลือกรูปถ่ายที่ดูดีเพราะมันมีอิทธิพลกับจำนวนการคลิกของผู้ใช้อย่างมาก

  Trovit ไม่อนุญาตให้ใช้รูปภาพบริษัทพร้อมข้อความ “ไม่มีรูปภาพ”
  หากเราตรวจพบ Trovit สงวนสิทธิ์ในการปิดกั้นประกาศของคุณ

  เมื่อประกาศของคุณได้รับการจัดเข้าหมวดหมู่ใน Trovit รูปภาพที่เกี่ยวข้องกับประกาศไม่สามารถทำการดัดแปลงได้ นี่รวมถึงการที่คุณดัดแปลงภาพถ่ายใน feed ด้วย
  โปรดตรวจสอบด้วยว่าประกาศอันใหม่ของคุณใน feed มีภาพที่ถูกต้อง
  ภาพถ่ายต้องมีขนาดอย่างน้อย 186x186px และขนาดไฟล์สูงสุด 1MB

• date: วันที่และเวลาที่โฆษณาได้รับการประกาศ รูปแบบที่เหมาะสม: วัน/เดือน/ปี หรือ วัน/เดือน/ปี ชั่วโมง:นาที:วินาที และ ปี/เดือน/วัน หรือ ปี/เดือน/วัน ชั่วโมง:นาที:วินาที
• expiration_date:วันที่ประกาศหมดอายุ รูปแบบที่เหมาะสม: วัน/เดือน/ปี หรือ วัน/เดือน/ปี ชั่วโมง:นาที:วินาที และ ปี/เดือน/วัน หรือ ปี/เดือน/วัน ชั่วโมง:นาที:วินาที
• by_owner: อสังหาริมทรัพย์นั้นขายโดยเจ้าของหรือไม่ (รูปแบบ: 0 = ไม่, 1 = ใช่) ไม่จำเป็นต้องระบุช่องข้อมูลนี้หากอสังหาริมทรัพย์นั้นจำหน่ายโดยตัวแทนขายอสังหาริมทรัพย์
• is_rent_to_own: อสังหาริมทรัพย์นั้นสำหรับเช่าเพื่อซื้อหรือไม่
• parking: อสังหาริมทรัพย์นั้นมีที่จอดรถหรือไม่ (รูปแบบ: 0 = ไม่, 1 = ใช่)
• is_furnished: อสังหาริมทรัพย์นั้นตกแต่งพร้อมอยู่อาศัยหรือไม่ (รูปแบบ: 0 = ไม่, 1 = ใช่)
• is_new: อสังหาริมทรัพย์นั้นใหม่หรือไม่ (รูปแบบ: 0 = ไม่, 1 = ใช่)

รูปแบบ UTF-8 XML

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
    <id><![CDATA[...]]></id>
    <url><![CDATA[...]]></url>
    <title><![CDATA[...]]></title>
    <type><![CDATA[...]]></type>
    <content><![CDATA[...]]></content>
    <price><![CDATA[...]]></price>
    <property_type><![CDATA[...]]></property_type>
    <foreclosure><![CDATA[...]]></foreclosure>
    <foreclosure_type><![CDATA[...]]></foreclosure_type>    
    <address><![CDATA[...]]></address>
    <floor_number><![CDATA[...]]></floor_number>
    <city_area><![CDATA[...]]></city_area>
    <city><![CDATA[...]]></city>
    <postcode><![CDATA[...]]></postcode>
    <region><![CDATA[...]]></region>
    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>
    <orientation><![CDATA[...]]></orientation>
    <agency><![CDATA[...]]></agency>
    <mls_database><![CDATA[...]]></mls_database>
    <floor_area><![CDATA[...]]></floor_area>
    <plot_area unit="acres"><![CDATA[...]]></plot_area>
    <rooms><![CDATA[...]]></rooms>
    <bathrooms><![CDATA[...]]></bathrooms>
    <condition><![CDATA[...]]></condition>
    <year><![CDATA[...]]></year>
    <virtual_tour><![CDATA[...]]></virtual_tour>
    <pictures>¡
        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        ...
    </pictures>
    <date><![CDATA[...]]></date>
    <expiration_date><![CDATA[...]]></expiration_date>
    <by_owner><![CDATA[...]]></by_owner>
    <parking><![CDATA[...]]></parking>
    <is_furnished><![CDATA[...]]></is_furnished>
    <is_new><![CDATA[...]]></is_new>
</ad>
...
</trovit>

ข้อกำหนดทางเทคนิค

รายละเอียดเพิ่มเติม ดูได้ที่: ข้อกำหนดทางเทคนิค