Vos annonces sur Trovit Maroc

Flux immobilier

Si vous possédez un site web de plus de 50 petites annonces immobilières actives, indexez-les sur Trovit Immobilier! Suivez les étapes ci-dessous: vous verrez, c’est très simple!

  1. Préparez un flux XML UTF-8 au format indiqué pour notre catégorie Immobilier (voir ci-dessous)
  2. Envoyez-nous l’URL sur laquelle se trouve votre flux par le biais de notre formulaire de contact. (Exemple: http://www.votredomaine.com/wp_feed.xml)

Une fois que nous aurons reçu votre flux, nous indexerons vos annonces dans nos résultats de recherche le plus rapidement possible. Votre flux sera alors lu chaque jour, afin d’intégrer vos nouvelles annonces, d’effectuer les dernières modifications et de supprimer les annonces périmées si elles ne sont plus présentes dans votre flux.

Si vous avez la moindre question ou le moindre doute, n’hésitez pas à nous contacter!

Format du flux XML

Voici les instructions pour la préparation de votre flux XML et l’intégration de vos annonces sur Trovit. Si vous avez besoin de plus d’informations sur le format XML, consultez Wikipedia.

La codification du fichier XML devra absolument être en UTF-8

Le fichier XML UTF-8 devra contenir un tag “trovit” et une série d’éléments “ad” (annonce). Chaque élément “ad” possède les champs suivants:

CHAMPS OBLIGATOIRES

  • id: référence de l’annonce sur votre site web (numérique ou alphanumérique, elle doit absolument être unique puisque nous l’utiliserons pour identifier et éliminer les annonces dupliquées)
  • url: l’URL de l’annonce sur votre site web
  • title: titre de l’annonce (il doit être totalement en relation avec votre annonce, il ne peut contenir ni le nom ni l’URL de votre site internet).
  • type: type d’annonce:
    • “For Rent”: Location
    • “For Sale”: Vente
  • content: descriptif du bien (au minimum 30 caractères). Rappelez-vous que plus la description du bien sera complète et détaillée, meilleur sera le positionnement de votre annonce dans nos résultats de recherche!

CHAMPS OPTIONNELS

Si vous disposez de ces champs sur votre web, n’hésitez pas à les inclure dans votre flux! En revanche, si vous ne possédez pas ces informations, il n’est pas nécessaire de mettre les champs vides. L’algorithme du classement de Trovit donne priorité à la qualité des annonces donc plus une annonce aura de champs renseignés, meilleure sera sa “qualité” et, de ce fait, son positionnement dans la liste des résultats de recherche!

mobile_url

    • : URL de l’annonce sur votre site Internet quand l’utilisateur accède depuis son smartphone. (Utile quand votre site Internet est préparé pour ce genre de dispositif.)

Price

      • : Prix du bien à vendre ou à louer. Le prix sera mensuel par défaut. Mais il est possible de préciser la période de location (

monthly

      • ,

daily

      • ou

weekly

      • ) comme attribut dans ce tag.
<price period="weekly"><![CDATA[...]]></price>

Lorsque le prix est spécifié dans une monnaie qui n’est pas la devise officielle du pays, l’attribut “currency” devra être utilisé. Les valeurs seront établies selon la norme ISO-4217. De cette façon, Trovit pourra réaliser la conversion dans la monnaie officielle.

Voici un exemple de syntaxe:

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

Cet exemple précise le prix d’une location hebdomadaire, en dollars. Il ne faut pas inclure le symbole de la monnaie à côté du prix.

 

  • property_type: Type de bien: appartement, maison, riad, villa, etc…
  • address: adresse du bien immobilier.
  • floor_number: étage: étage auquel se trouve le bien.
  • city_area: quartier de la ville ou se trouve le bien.
  • city: nom de la ville où se trouve le bien.
  • region: région.
  • postcode: code postal.
  • latitude: latitude où se trouve le bien immobilier. Voir spécificités techniques pour plus de détails.
  • longitude: longitude où se trouve le bien immobilier.Voir spécificités techniques pour plus de détails.
  • orientation : Information textuelle sur l’orientation du bien: nord, sud, est ou ouest
  • agency: nom de l’agence. Voir champ by_owner pour plus d’informations.
  • mls_database: Identifiant unique assigné à chaque bien immobilier depuis une base de données MLS (Multiple Listing Service).
  • floor_area: Surface du bien en mètres carré (précisez: unit=”meters”; nombre entier). Si l’annonce a une unité de mesure différente du mètre carré, vous pouvez le renseigner avec la syntaxe suivante:
    <floor_area unit="feet"><![CDATA[...]]></floor_area>

    Les différentes unités de mesures acceptées seront: “meters” ou “feet”.

  • plot_area : surface du terrain sur lequel se trouve le bien (nombre entier). Si l’annonce a une unité de mesure différente du mètre carré, vous pouvez le renseigner avec la syntaxe suivante:
    <plot_area unit="hectares"><![CDATA[...]]></plot_area>

    Les différentes unités de mesures acceptées seront: “meters”, “feet”, “acres” o “hectares”.

  • rooms: nombre de pièces du bien.
  • bathrooms: nombre de salles de bain du bien.
  • condition : commentaire sur l’état du bien (par exemple, récemment rénové)
  • year : année de construction. Le format requis est: AAAA
  • virtual_tour : l’URL de la visite virtuelle du bien
  • eco_score : Information textuelle sur l’efficacité énergétique du bien immobilier.
  • pictures: Le champ “pictures” (photos) englobe les différentes images du bien. Le tag qui définit une photo en particulier est <picture>:
    • picture: Ce tag englobe tous les champs pour spécifier l’URL et le titre de la photo (ce dernier est optionnel). Il est possible de préciser si la photo est la photo principale avec le champ “featured”.
      <picture featured="true">...</picture>

      Les valeurs de ‘featured’ disponibles sont: “true” ou “false”.

      Les champs à définir à l’intérieur du champ <picture> sont:

      • picture_url: URL de la photo.
      • picture_title: Titre de la photo.
    <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>

    La photo montrée sur Trovit sera la première du set de photos de l’annonce. Choisissez bien l’image qui sera presentée car cela a une grande influence sur le nombre de clicks des utilisateurs.

    Trovit ne permet pas l’insertion de photos corporatives avec le message “Aucune image n’est disponible”. Si c’est le cas, Trovit se réserve le droit de bloquer vos annonces.

    Une fois que vos annonces auront été inserées sur Trovit, les photos associées aux annonces ne pourrons être modifiées, pas même à la prochaine lecture de votre flux.
    Assurez-vous que les nouvelles annonces que vous intégrez à votre feed contiennent les bonnes images.

  • date: date de publication de l’annonce. Format requis: JJ/MM/AAAA ou JJ/MM/AAAA HH:MM:SS et AAAA/MM/JJ ou AAAA/MM/JJ HH:MM:SS
  • expiration_date: date d’expiration de l’annonce. Format requis: JJ/MM/AAAA ou JJ/MM/AAAA HH:MM:SS et AAAA/MM/JJ ou AAAA/MM/JJ HH:MM:SS
  • Les champs suivants doivent être renseignés par les valeurs 1 ou 0, selon si la condition décrite est Vraie (1) ou Fausse (0). Voir spécificités techniques pour plus de détails.
    • by_owner: Si le bien immobilier est offert par un particulier. Par défaut le (0) sous-entendra que l’annonce vient d’une agence.
    • is_rent_to_own: Si il s’agit d’un bien immobilier en location avec option d’achat ou non.
    • parking: 0 si le bien ne dispose pas de parking, 1 si le bien dispose d’un parking.
    • foreclosure: information sur le fait que le bien soit sous saisie ou non .
    • is_furnished: 0 si le bien n’est pas meublé, 1 si le bien est meublé.
    • is_new: 1 s’il s’agit d’un bien neuf, 0 s’il ne s’agit pas d’un bien neuf.

    Le flux XML doit avoir ce schéma:

    <?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>
    
        <floor_area unit="feet"><![CDATA[...]]></floor_area>
        <rooms><![CDATA[...]]></rooms>
        <bathrooms><![CDATA[...]]></bathrooms>
        <parking><![CDATA[...]]></parking>
    
        <address><![CDATA[...]]></address>
        <city><![CDATA[...]]></city>
        <city_area><![CDATA[...]]></city_area>
        <postcode><![CDATA[...]]></postcode>
    
        <region><![CDATA[...]]></region>
    
        <latitude><![CDATA[...]]></latitude>
        <longitude><![CDATA[...]]></longitude>
    
        <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>
    
        <virtual_tour><![CDATA[...]]></virtual_tour>
    
        <date><![CDATA[...]]></date>
    
    </ad>
    
    <ad>
        ....
    </ad>
    
    <ad>
        ....
    </ad>
    
    ...
    
    </trovit>

    Exemple de flux XML

    <?xml version="1.0" encoding="utf-8"?>
    <trovit>
    <ad>
    	<id><![CDATA[7004578]]></id>
    	<url><![CDATA[http://www.votredomaine.com/ad/7004578]]></url>
    	<title><![CDATA[Maison à vendre à Tanger]]></title>
    	<type><![CDATA[For sale]]></type>
    	<agency><![CDATA[Agence Immo XX]]></agency>
    	<content><![CDATA[maison indépendante, bien finie, constituée de RDC et 2 étages,
    construite sur un terrain de 100 m2. Composition: RDC: magasin et salle d’eau ; Premier étage:
    suite parentale avec salle de bain et dressing, chambre avec placard et balcon, cuisine équipée
    (plaque à 4 feux, hotte, frigidaire et machine à laver), salle de bain et grand séjour ;
    Deuxième étage: deux salons ouverts, une chambre avec placard, cuisine, salle de bain et vasque ;
    Terrasse avec buanderie. Maison dotée de chauffe-eau solaire (200 litres), 2 climatiseurs,
    escaliers en marbre gris rosé, bonne protection contre l'humidité. Quartier calme, propre ;
    à 6 mn de la plage]]></content>
    	<price><![CDATA[1650000]]></price>
    	<property_type><![CDATA[Maison]]></property_type>
    	<floor_area unit="feet"><![CDATA[280]]></floor_area>
    	<rooms><![CDATA[3]]></rooms>
    	<bathrooms><![CDATA[3]]></bathrooms>
    	<parking><![CDATA[0]]></parking>
    	<address><![CDATA[]]></address>
    	<city><![CDATA[Tanger]]></city>
    	<city_area><![CDATA[]]></city_area>
    	<postcode><![CDATA[90000]]></postcode>
    	<region><![CDATA[]]></region>
    	<latitude><![CDATA[]]></latitude>
    	<longitude><![CDATA[]]></longitude>
    	<pictures>
    	   <picture>
    		<picture_url><![CDATA[http://www.votredomaine.com/image.jpg]]></picture_url>
    		<picture_title><![CDATA[salon]]></picture_title>
    	   </picture>
    	</pictures>
    	<date><![CDATA[31/10/2005]]></date>
    </ad>
    <ad>
    	<id><![CDATA[332A53BC2]]></id>
    	<url><![CDATA[http://www.votredomaine.com/ad/332A53BC2]]></url>
    	<title><![CDATA[Appartement à vendre a Casablanca]]></title>
    	<type><![CDATA[For sale]]></type>
    	<content><![CDATA[Appartements et duplex à vendre en plein cœur de casablanca,
    dans une résidence de haut standing sécurisée, avec de très belles finitions.]]></content>
    	<price><![CDATA[sur demande]]></price>
    	<address><![CDATA[]]></address>
    	<city><![CDATA[Casablanca]]></city>
    	<postcode><![CDATA[20270]]></postcode>
    	<region><![CDATA[]]></region>
    	<pictures>
    	   <picture>
    		<picture_url><![CDATA[http://www.votredomaine.com/image.jpg]]></picture_url>
    		<picture_title><![CDATA[salle à manger]]></picture_title>
    	   </picture>
    	</pictures>
    	<date><![CDATA[31/10/2005]]></date>
    </ad>
    </trovit>

    Spécificités techniques

    Pour plus d’informations, cliquez ici: voir les spécificités techniques.

Privacy policy · Legal Notice · Terms and conditions · Cookie policy