Nederland - Auto’s feed – Thribee

Schrijf een XML bestand in UTF-8 en Trovit/Mitula formaat. De specificaties van het Trovit/Mitula formaat worden hieronder toegelicht.
Stuur ons de link van je XML feed (Bijvoorbeeld: http://www.jedomein.nl/wp_feed.xml) via ons contact e-mail.

Wij zullen je XML feed zo snel mogelijk in ons systeem opnemen en je advertenties op Trovit/Mitula tonen.

Jullie feed zal vanaf dit moment dagelijks worden afgelezen om de nieuwste advertenties toe te voegen, de laatste veranderingen toe te passen en de verlopen advertenties te verwijderen als deze niet meer in je feed staan.

Opgepast, we nemen enkel de feeds aan die auto’s bevatten. We indexeren geen fietsen, motoren, scooters, boten, auto-onderdelen, enz.

Neem gerust contact met ons op als je nog vragen hebt.

XML AUTO’S FEED SPECIFICATIES

Hieronder vind je de specificaties voor het aanmaken van een XML auto’s feed in Trovit/Mitula formaat. Voor meer informatie over XML verwijzen we je naar Wikipedia.

De XML feed dient geschreven en opgeslagen te worden in UTF-8 en heeft één ‘Trovit/Mitula’ tag en één of meer ‘ad’ (advertentie) elementen. Ieder van deze ‘ad’ elementen bevat de volgende velden:

VERPLICHTE VELDEN

id: id van de advertentie op je website, deze kan zowel numeriek, alfabetisch als alfanumeriek zijn. Belangrijk is dat de id uniek is omdat wij deze gebruiken om dubbele advertenties te voorkomen.
url: URL die linkt naar de advertentie op je website
title: titel van de advertentie (het moet geheel gerelateerd zijn aan de advertentie, en mag de naam of URL van jouw website niet bevatten).
content: beschrijving van de auto met minimaal 30 tekens. Hoe meer informatie je ons verschaft, hoe beter de kwaliteit van je advertentie. Wij tonen alleen de delen van de beschrijving die relevant zijn bij een zoekopdracht.

OPTIONELE VELDEN

Mochten jullie over de volgende velden beschikken op jullie website, dan raden wij je aan om deze toe te voegen aan de feed. Als jullie echter deze velden niet hebben, voeg ze dan vooral niet toe. Het algoritme van Trovit/Mitula rangschikt de advertentie op volgorde van kwaliteit. De meer velden de advertentie bevat de hoger de kwaliteit en de hoger de advertentie in de zoekresultaten zal komen!

mobile_url: URL van de advertentie op je website wanneer de gebruiker zijn smartphone gebruikt. (Handig wanneer je website toegankelijk is op dit type toestel).
price: prijs van de auto (geheel getal)

Staan je advertenties in een andere valuta? Trovit/Mitula zet de prijs automatisch om in euro’s; gebruik hiervoor de correcte ISO-4217 afkorting in één van de volgende formaten (het voorbeeld is in USD):

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

Je hoeft dus niet het symbool van de valuta naast de prijs aan te geven. Voor meer informatie zie technische specificaties.

city: stad
city_area: stadsdeel / wijk
postcode: postcode
vin_database: Uniek ID van de auto.
region: provincie
car_type: Tekstuele informatie over het soort auto, bijvoorbeeld: C-klasse, C200CDI Elegance combi
dealer: dealer die de auto verkoopt
neighborhood : buurt van de stad waar de auto zich bevindt
make: merk
model: model
color: kleur
year: bouwjaar
mileage: kilometerstand. Als de meeteenheid niet vermeld staat, zal het standaard in kilometers uitgedrukt zijn. Je kan de eenheid specifiëren dankzij de “unit”:
```
<mileage unit="kilometers"><![CDATA[...]]></mileage>
```
De aanvaarde meeteenheden zijn: “kilometers” en “miles”.
doors: aantal deuren
seats: aantal stoelen
warranty: tekstuele informatie die aangeeft of er nog garantie op de auto zit
engine_size: cilinder in cc. Als de meeteenheid niet vermeld staat, zal het standaard in kubieke centimeters uitgedrukt zijn. Je kan de eenheid specifiëren dankzij de “unit”:
```
<engine_size unit="cc"><![CDATA[...]]></engine_size>
```
De aanvaarde meeteenheden zijn: “cc” of “liters”.
cylinders: aantal cylinders in de auto
fuel: brandstof; benzine, diesel, LPG, elektrisch
transmission: transmissie; handgeschakeld of automaat
gears: aantal versnellingen
power: vermogen in pk; zonder komma’s en punten, “pk” wordt niet automatisch vermeld (optioneel). Gebruik hiervoor onderstaande standaard met één van de volgende vermogens: “pk”, “kw”, “cv”, “ch”, “km”, “hp”, “ps”, “cp”:
```
<power unit="pk"><![CDATA[...]]></power>
```
fuel_consumption: het brandstofverbruik van de auto. Als de meeteenheid niet vermeld staat, zal het standaard in l/100km uitgedrukt zijn. Je kan de eenheid specifiëren dankzij de “unit”:
```
<fuel_consumption unit="km/l"><![CDATA[...]]></fuel_consumption>
```
De beschikbare ‘unit’ waarden zijn: “l/100km”, “km/l”, “mpg”, “gal/mi”.
co2_emissions: CO2-uitstoot van de auto. Als de meeteenheid niet vermeld staat, zal het standaard in g/km uitgedrukt zijn. Je kan de eenheid specifiëren dankzij de “unit”:
```
<co2_emissions unit="g/mi"><![CDATA[...]]></co2_emissions>
```
De beschikbare ‘unit’ waarden zijn: “g/km”, “g/mi”.
eco_score: indicatie van de milieuvriendelijkheid van een voertuig.
date: publicatiedatum van de advertentie. Geldige formaten: DD/MM/JJJJ of DD/MM/JJJJ UU:MM:SS en JJJJ/MM/DD of JJJJ/MM/DD UU:MM:SS.
expiration_date: datum waarop de advertentie verloopt. Geldige formaten: DD/MM/JJJJ of DD/MM/JJJJ UU:MM:SS en JJJJ/MM/DD of JJJJ/MM/DD UU:MM:SS.
is_new: of de auto nieuw is; 0 voor occasion, 1 voor nieuw
pictures: het veld ‘pictures’ (foto’s) bevat alle foto’s van de auto.
De tag die de foto definieert is <picture>:
- picture: Deze tag bevat al de velden voor de URL en de titel van de foto (optioneel). Het is mogelijk aan te geven of de foto de hoofdfoto is met het veld ‘featured’.
```
 
        <picturefeatured="true"><![CDATA[...]]></picture>
```
  De beschikbare waarden van ‘featured’ zijn: “true” of “false”.
  
  De velden dat men in de tag <picture> moet aangeven zijn:
  - picture_url: URL van de foto.
  - picture_title: Titel van de foto.
```
 
<pictures> 
    <picture> 
        <picture_url><![CDATA[...]]></picture_url> 
        <picture_title><![CDATA[...]]>/picture_title> 
    </picture> 

    <picturefeatured="true"> 
        <picture_url><![CDATA[...]]></picture_url> 
        <picture_title><![CDATA[...]]>/picture_title> 
    </picture> 
        ... 
</pictures>
```
De foto die bij de advertentie wordt getoond is de eerste in de fotoreeks van de advertentie.
Kies daarom de meest relevante foto, aangezien dit veel invloed heeft op het verkeer dat de advertentie zal genereren.

Trovit/Mitula staat geen foto’s toe met een logo of de melding ‘Geen foto beschikbaar’.
Trovit/Mitula behoudt zich het recht voor om je advertenties te blokkeren.

Zodra de advertenties zijn opgenomen in ons systeem, is het niet meer mogelijk om de weergegeven foto te veranderen, zelfs niet in de eerstvolgende keer dat de feed wordt afgelezen.
Wees er daarom zeker van dat alle nieuwe advertenties de correcte foto’s bevatten. De afbeeldingen moeten minstens een grootte hebben van 186x186px met een maximum van 1 MB.

De XML auto’s feed in Trovit/Mitula formaat zou er als volgt uit moeten zien:

<?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 unit="pk"><![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>
    <is_new><![CDATA[...]]></is_new>
    <car_type><![CDATA[...]]></car_type>
    <warranty><![CDATA[...]]></warranty>
</ad>

<ad>
    ....

</ad>

<ad>
    ....
</ad>

...

</trovit>

Voorbeeld XML Auto’s Feed in Trovit/Mitula Formaat

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
	<id><![CDATA[7004578]]></id>
	<url><![CDATA[http://www.ikverkoopmijnauto.nl/ad/7004578]]></url>
	<title><![CDATA[VOLKSWAGEN GOLF GTI, 5 deurs Hatchback]]></title>
	<content><![CDATA[ABS, Airbags voor, Airconditioning, Centrale deurvergrendeling 
afstandbediend, Deelbare achterbank (ongelijke delen), Elektrisch bedienbare ramen, Metallic 
lak, Startonderbreker, Stuurbekrachtiging, In hoogte verstelbaar stuur, Zij airbags voor, 
Gordijn airbags voor, Gordijn airbags achter, Elektrisch verstelbare spiegels, Bumpers in 
carrosserie kleur ]]></content>
	<price><![CDATA[14950]]></price>
	<make><![CDATA[Volkswagen]]></make>
	<model><![CDATA[Golf]]></model>
	<color><![CDATA[Zwart]]></color>
	<year><![CDATA[2005]]></year>
	<city><![CDATA[Amsterdam]]></city>
	<city_area><![CDATA[Centrum]]></city_area>
	<postcode><![CDATA[1012 AE]]></postcode>
	<region><![CDATA[Noord-Holland]]></region>
	<mileage><![CDATA[70261]]></mileage>
	<doors><![CDATA[5]]></doors>
	<fuel><![CDATA[Benzine]]></fuel>
	<transmission><![CDATA[Handgeschakeld]]></region>
	<engine_size><![CDATA[1200]]></engine_size>
	<power unit="pk"><![CDATA[110]]></power>
	<seats><![CDATA[5]]></seats>
	<gears><![CDATA[5]]></gears>
	<pictures>
		<picture>
			<picture_url><![CDATA[http://www.ikverkoopmijnauto.nl/foto1.jpg]]
></picture_url>
			<picture_title><![CDATA[voorkant]]></picture_title>
		</picture>
		<picture>
			<picture_url><![CDATA[http://www.ikverkoopmijnauto.nl/foto2.jpg]]
></picture_url>
			<picture_title><![CDATA[achterkant]]></picture_title>
		</picture>
	</pictures>
	<date><![CDATA[14/09/2009]]></date>
	<is_new><![CDATA[0]]></is_new>
	<car_type><![CDATA[GTI Hatchback]]></car_type>
	<warranty><![CDATA[1 jaar garantie]]></warranty>
</ad> 
</trovit>

TECHNISCHE SPECIFICATIES

Voor meer imformatie klik hier zie technische specificaties.

Articles in this section

Nederland - Auto’s feed

XML AUTO’S FEED SPECIFICATIES

VERPLICHTE VELDEN

OPTIONELE VELDEN

Voorbeeld XML Auto’s Feed in Trovit/Mitula Formaat

TECHNISCHE SPECIFICATIES

Comments

Articles in this section

XML AUTO’S FEED SPECIFICATIES

VERPLICHTE VELDEN

OPTIONELE VELDEN

Voorbeeld XML Auto’s Feed in Trovit/Mitula Formaat

TECHNISCHE SPECIFICATIES

Related articles