Articles in this section

See more

日本 - 不動産フィード

Avatar
Thribee Help Center
  • Updated
Follow

広告掲載をしているウェブサイトをお持ちの場合は、Trovit/Mitula/Nestoriaにご登録を！
以下の簡単な手順で登録可能です。

  1. 不動産用にUTF-8の文字コードで作成されたXMLフィードをご用意ください(以下を参照)。
  2. XMLフィードが設置されているURLをContact からお知らせください。(例: http://www.yourdomain.com/wp_feed.xml)

フィードを受け取り次第、Trovit/Mitula/Nestoriaはすぐにあなたの広告を検索結果に表示いたします。
ご質問、お問い合せ等、お気軽にお問い合わせください！

XMLフィードの形式

こちらが、XMLフィードのガイドラインとなります。技術仕様をご覧になって各タグの制限をご確認ください。 XMLフィードに関しての詳細な情報はWikipediaを御覧ください。

*XMLフィードはUTF-8で作成してください。ファイルは1つの「trovit」タグと1つ以上の「ad」要素で構成してください。各「ad」要素は以下のフィールドを保持している必要があります。

必須項目

Trovit/Mitula/Nestoriaがデータを取り込む上で以下の項目は最低限含まれている必要があります。

  • id: あなたのウェブサイト上での広告のID(数値または英数字、重複コンテンツの判定に利用するので必ず一意（ユニーク）である必要があります)
  • url: あなたのウェブサイト上での広告のURL
  • title: 広告の見出し(サイト名やURLが含まれていない簡潔な概要にしてください)
  • type: 広告毎に適切な物件種別を選択する:
    • “for rent”: 賃貸物件
    • “for sale”: 売買物件
  • content: 物件の詳細情報(最低30文字)。説明内容の品質が集客に大きく影響するということを気に留めておいてください！

任意の項目

任意の項目であり必須ではありません。必須ではありませんが、情報をお持ちでしたら是非追加してください！Trovit/Mitula/Nestoria/Nuroaのアルゴリズムは高品質の広告を優先します。より多くの情報を提供することが、あなたの広告の順位に良い影響を与えます！

  • mobile_url: あなたのサイト上のモバイル用のURL。モバイルユーザにとって有用です。
  • price: 物件価格。デフォルトの支払期間は月単位です。 ただし、別途支払期間の指定は可能です。 (週単位 または 日単位) 特定の記述構文で指定可能です: 
    <price period="weekly"><![CDATA[...]]></price>
<price period="daily"><![CDATA[...]]></price>

    「円」や「￥」などの記号は含めないでください。もし、公式な通貨(JPY)以外で指定される場合は、「price]タグ内で特定の記述構文で指定してくださいISO-4217。これに準拠していれば、Trovit/Mitula/Nestoria/Nuroaはその価格を公式の価格(JPY)へ変換します。

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

    この例では、毎週の賃料をカナダドルで指定されています。Trovit/Mitula/Nestoria/NuroaはこのカナダドルからJPYへ変換します。

  • property_type: apartment, home, studio, condo. (「type」の項目に「for rent」か「for sale」を指定した場合のみ有効です) より詳しい詳細は技術仕様を御覧ください。
  • address: 番地
  • floor_number: 階数/総階数
  • neighborhood: 物件の存在する番地など (町域名より詳細な住所情報)
  • city: 物件の存在する市区町村名
  • city_area: 物件の存在する町域名
  • postcode: 郵便番号
  • region: 物件の存在する都道府県名
  • latitude: 物件所在地の緯度 [-90.0, 90.0]
  • longitude: 物件所在地の経度 [-180.0,180.0]
  • orientation: 物件の方角: 北、 南、 東、 西、 北東、北西、南東、南西
  • agency: 取扱会社名
  • mls_database: MLS ID番号（*日本の不動産以外で利用する項目です）
  • floor_area: 面積(数値)
  • plot_area: 敷地面積 / 土地面積。 以下から1つをお選びください。 
    <plot_area unit="feet"><![CDATA[...]]></plot_area>
<plot_area unit="acres"><![CDATA[...]]></plot_area>
  • rooms: 部屋数
  • bathrooms: 浴室数、小数でも登録可(例: 2.5)
  • condition: 物件の状態 例:「リフォーム済み」や「中古アパート」など
  • year: 物件の築年数 (形式: YYYY)
  • virtual_tour: 物件のバーチャルツアーが見れるURL
  • eco_score: エコシステム、エネルギー効率化などに関する情報をフリーテキストで入力してください。
  • pictures: 物件がはっきりと分かる画像。
    <picture>項目内で詳細を記述してください:
    • picture: 画像のURLとタイトルを指定します(タイトルは任意)。「featured」属性を利用してどの画像が重要かを指定できます。 
      <picture featured="true"><![CDATA[...]]></picture>

      「featured」に指定可能な値は: 「true」か「false」のいずれかです。

      <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/Mitula/Nestoria/Nuroaで特定の広告の画像として利用されるのは、「featured」の指定をしない限り、1つ目の画像となります。
    ユーザが広告をクリックしてくれるかに大きく影響するので画像は慎重にお選びください。

    Trovit/Mitula/Nestoria/Nuroaでは、「画像が存在しません」等のメッセージと共に会社画像を表示することは許可しておりません。
    発見次第、Trovit/Mitula/Nestoria/Nuroaはあなたの広告をブロックいたします。

    一度でもTrovit/Mitula/Nestoria/Nuroaに広告が登録されたら、たとえフィードで修正した画像を登録したとしても、その広告に関する画像の修正はできません。
    新規の広告画像が正しく設定されていることにご注意ください。
    画像は、小さくとも「186x186px」サイズで「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: 購入選択権付き賃貸の判定 (形式: 0 = いいえ、 1 = はい)
  • 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.