Vos annonces sur Trovit France

Flux Voiture

Si vous possédez un site web de plus de 50 petites annonces de voitures à vendre actives, indexez-les sur Trovit Voitures! 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 Voitures (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)

Attention, nous acceptons exclusivement les flux contenant des annonces de voitures. Nous n’indexons pas les vélos, motos, scooters, bateaux, pièces détachées, etc… en tous cas pas pour l’instant!

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

Les champs obligatoires sont l’ensemble des tags XML qui correspondent à la quantité minimum d’information nécessaire pour que notre système puisse indexer vos annonces sur Trovit.

  • 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).
  • content: description du véhicule (au minimum 30 caractères). Rappelez-vous que plus la description du véhicule 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 (nombre entier)

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.

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

Cet exemple indique le prix d’un véhicule en dollars, en France. Trovit convertira donc ce prix à un prix en euros. Il ne faut pas inclure le symbole de la monnaie à côté du prix. Consultez les specificités techniques pour plus d’informations.

    • car_type: type de carrosserie du véhicule: berline, break, coupé, fourgonnette, 4×4, etc
    • dealer: concessionnaire où se trouve le véhicule.
    • city_area: quartier de la ville ou se trouve le véhicule. (Paris 1er arrondissement , Paris )
    • city: nom de la ville où se trouve le véhicule. (Paris , Ile de France )
    • region: département où se trouve le véhicule. (Morbihan , Bretagne ). NB: Pour Paris, le département est Paris (et non Ile de France).
    • postcode: code postal
    • vin_database: Numéro identifiant de la voiture. Identifiant unique.

 

  • make: marque de la voiture.
  • model: modèle de la voiture.
  • color: couleur de la voiture.
  • year: année de construction de la voiture.
  • mileage: kilométrage de la voiture. Si l’unité de mesure n’est pas spécifiée, l’unité prise en compte par défaut sera les kilomètres. Il est possible de préciser l’unité de mesure grâce à l’attribut “unit”:
    <mileage unit="kilometers"><![CDATA[...]]></mileage>

    Les valeurs de “unit” disponibles sont: “kilometers” ou “miles”.

  • doors: nombre de portes
  • seats: nombre de places
  • warranty: information sur la garantie du véhicule
  • engine_size: taille du moteur, en c.c. Si l’unité de mesure n’est pas spécifiée, l’unité prise en compte par défaut sera les centimètres cubes. Il est possible de préciser l’unité de mesure grâce à l’attribut “unit”:
    <engine_size unit="cc"><![CDATA[...]]></engine_size>

    Les valeurs de “unit” disponibles sont: “cc” ou “liters”.

  • cylinders: nombre de cylindres (nombre entier, sans unité)
  • fuel: type de carburant (i.e. essence, diesel, etc)
  • transmission: type de transmission (“manual” ou “automatic”)
  • gears: nombre de vitesses
  • power: puissance de la voiture. Si l’unité de mesure n’est pas spécifiée, l’unité prise en compte par défaut sera les CV. Il est possible de préciser l’unité de mesure grâce à l’attribut “unit”:
    <power unit="cv"><![CDATA[...]]></power>

    Les valeurs de ‘unit’ disponibles sont: “kw”, “cv”, “ch”, “km”, “hp”, “ps”, “pk”, “cp”.

  • fuel_consumption: Consommation de carburant de la voiture. Si l’unité de mesure n’est pas spécifiée, sera pris par défaut les l/100km. Il est également possible de spécifier l’unité de mesure avec l’attribut ‘unit’:
    <fuel_consumption unit="km/l"><![CDATA[...]]></fuel_consumption>

    Les valeurs de ‘unit’ disponibles sont: “l/100km”, “km/l”, “mpg”, “gal/mi”.

  • co2_emissions: Émissions de CO2 de la voiture. Si l’unité de mesure n’est pas spécifiée, sera pris par défaut les g/km. Il est également possible de spécifier l’unité de mesure avec l’attribut ‘unit’:
    <co2_emissions unit="g/mi"><![CDATA[...]]></co2_emissions>

    Les valeurs de ‘unit’ disponibles sont: “g/km”, “g/mi”.

  • eco_score: Information textuelle sur l’ECO-score de la voiture.
    • pictures: Le champ “pictures” (photos) englobe les différentes images du véhicule.
      Le tag qui définit une photo en particulier est <picture>:

      • picture: Ce tag regroupe les champs qui précise 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 son: “true” ou “false”.

        Les champs à définir à l’intérieur de l’élément <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 clics 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 flux 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

Le champ suivant doit être renseigné 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.

    • is_new: 0 s’il s’agit d’un véhicule d’occasion, 1 s’il s’agit d’un véhicule 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>

    <content><![CDATA[...]]></content>

    <price><![CDATA[...]]></price>

    <make><![CDATA[...]]></make>
    <model><![CDATA[...]]></model>
    <color><![CDATA[...]]></color>

    <year><![CDATA[...]]></year>

    <city><![CDATA[...]]></city>
    <city_area><![CDATA[...]]></city_area>
    <postcode><![CDATA[...]]></postcode>

    <region><![CDATA[...]]></region>
    <mileage><![CDATA[...]]></mileage>
    <doors><![CDATA[...]]></doors>
    <fuel><![CDATA[...]]></fuel>
    <transmission><![CDATA[...]]></transmission>
    <engine_size><![CDATA[...]]></engine_size>
    <power><![CDATA[...]]></power>
    <seats><![CDATA[...]]></seats>
    <gears><![CDATA[...]]></gears>

    <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>

</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[RENAULT ESPACE 4 à vendre]]></title>
	<content><![CDATA[RENAULT, Espace 4, Vert fonce, 193000 Km, 5, Essence, Manuelle, 
nombreuses pieces vendu avec... assume car je suis au chomage le vehicule etai a vendre
plus chere etant donne les quelques travaux... restant a faire je l ai baisse mais 
toujours negociable]]></content>
	<price><![CDATA[20000]]></price>
	<make><![CDATA[RENAULT]]></make>
	<model><![CDATA[ESPACE 4]]></model>
	<color><![CDATA[Vert fonce]]></color>
	<year><![CDATA[2005]]></year>
	<city><![CDATA[Le Perreux]]></city>
	<city_area><![CDATA[44 av de Bry]]></city_area>
	<postcode><![CDATA[94170]]></postcode>
	<region><![CDATA[]]></region>
	<mileage><![CDATA[193000]]></mileage>
	<doors><![CDATA[5]]></doors>
	<fuel><![CDATA[Essence]]></fuel>
	<transmission><![CDATA[manual]]></transmission>
	<engine_size><![CDATA[]]></engine_size>
	<power><![CDATA[10]]></power>
	<seats><![CDATA[5]]></seats>
	<gears><![CDATA[5]]></gears>
	<pictures>
		<picture>
			<picture_url><![CDATA[http://www.votredomaine
.com/image1.jpg]]></picture_url>
			<picture_title><![CDATA[face]]></picture_title>
		</picture>
		<picture>
			<picture_url><![CDATA[http://www.votredomaine
.com/image2.jpg]]></picture_url>
			<picture_title><![CDATA[arriere]]></picture_title>
		</picture>
	</pictures>
	<date><![CDATA[30/09/2006]]></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