Articles in this section

See more

台湾 - 住宅 Feed

Avatar
Thribee Help Center
  • Updated
Follow

如果您擁有刊登公開廣告的分類廣告網站，請將您的廣告納入 Trovit 中！
請遵循以下簡單的步驟：

  1. 請依照我們住宅縱向的特定格式（見下方），準備一個 UTF-8 XML feed。
  2. 將您的 XML feed 網址傳送至聯絡 Trovit（範例：http://www.yourdomain.com/wp_feed.xml）

一旦我們收到您的 feed，就會盡快將您的廣告編制到 Trovit, 的索引中。
如果您有疑問或顧慮，歡迎隨時聯繫我們！

XML FEED 格式

以下是一些準備 XML feed 的簡單指南。您可以使用我們的設計規格來查看每個標籤值的限制。如果您想了解更多關於 XML 格式的資訊，請前往維基百科。

*feed 應使用 UTF-8 編碼。檔案有一個「trovit」標籤，以及一個或多個「ad」元素。每一個「ad」元素有以下欄位：

必要欄位

若要使我們的系統將您的廣告納入 Trovit 中，以下欄位包含了最小必要資訊量，因此在 feed 中為必要。

  • id：您網站上的廣告編號（由數字或英文字母組成，必須是獨一無二的，因為我們會使用它來避免重複的項目）
  • url：您網站上的廣告網址
  • title：廣告標題（該項目的簡明摘要，不包含您網站的名稱或網址）。
  • type：為每個廣告選擇合適的房地產類型：
    • “for rent”：房地產出租
    • “for sale”：房地產出售
  • content：房地產描述（最少 30 字）。請注意，描述品質會強烈影響到瀏覽的訪客數量！

可選欄位

可選欄位在 feed 中為非必要。然而如果您擁有相關資訊，最好將它納入！Trovit 的演算法會優先處理較高品質的廣告，所以包含愈多資訊，將能最佳化您在我們搜尋引擎內的排名！

    • mobile_url：當使用者使用手機裝置瀏覽時，顯示的網站廣告網址。若您的網站有手機版，則此欄位很實用。
    • price：房地產價格。預設付款方式為每月，但您可以透過使用合適的代碼來指定替代的付款方式 (每週或每日): 
      <price period="weekly"><![CDATA[...]]></price>
<price period="daily"><![CDATA[...]]></price>

      請勿包含 $ 或 € 等符號。如果價格要以官方貨幣（美金／$）之外的特定貨幣顯示，請在「price」標籤中，使用 ISO-4217 使用合適的代碼。這會讓 Trovit 能夠將價格轉換為官方貨幣（美金／$）。

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

      在此範例中，每週租金價格為加拿大幣。Trovit 會將此貨幣轉換為美金。

    • property_type：公寓、住宅、工作室、大樓。（只適用於您在「type」欄位中填「出租」或「出售」的場合）

請檢視我們的設計規格表單以取得更多資訊。

  • address：地址
  • floor_number：樓層數
  • city_area：房地產所在的城市或鄰里
  • city：城市名稱
  • postcode：郵遞區號
  • region：縣市或直轄市
  • 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：房地產建造年份，顯示格式：YYYY
  • virtual_tour：房地產的虛擬導覽網址
  • eco_score：關於該房地產的能源效率資訊，文字格式不限。
  • pictures：此標籤包含房地產的不同圖片。
    定義特定圖片的欄位為 :
    • picture：此標籤包含圖片的欄位與標題（標題為可選）。您可以在屬性「featured」中定義該圖片是否為精選。 
      <picture featured="true"><![CDATA[...]]></picture>

      可在「featured」中使用的值為：「true」或「false」。

      在元素 中定義的欄位為：

      • picture_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 使用廣告圖片集的第一張圖片來作為顯示的廣告特定圖片，除非其中有圖片被標示為「featured」。
選擇合適的圖片能大幅改善使用者點擊數。

Trovit 不允許含有「圖片不可用」通知的公司照片。
如果我們偵測到此狀況發生，Trovit 保留封鎖您項目的權利。

一旦您的廣告被編入 Trovit 的索引中，該廣告的圖片， 包含在 feed 內修改圖片，即無法修改。
請確保您納入 feed 中的新廣告圖片正確。
圖片必須至少為 186×186 像素，且最大尺寸為 1MB。

  • date：廣告發布的日期與時間。有效格式：DD/MM/YYYY 或 DD/MM/YYYY HH:MM:SS 與 YYYY/MM/DD 或 YYYY/MM/DD HH:MM:SS。
  • expiration_date：廣告失效日期。有效格式：DD/MM/YYYY 或 DD/MM/YYYY HH:MM:SS 與 YYYY/MM/DD 或 YYYY/MM/DD HH:MM:SS。
  • 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>
<ad>
    ....
</ad>
...
</trovit>

設計規格

如需更多資訊，請查閱我們的：設計規格

Comments

0 comments

Please sign in to leave a comment.