Polska - Plik XML – Samochody – Thribee

Jeśli posiadasz stronę z ogłoszeniami, możesz je zawrzeć w Trovit, Mitula! Wystarczą 3 proste kroki:

Utwórz plik UTF-8 XML według poniższej specyfikacji.
Prześlij nam URL, gdzie znajduje się XML (na przykład: http://www.twojadomena.pl/wp_feed.xml) korzystając z naszego formularza kontaktu.

Od tego momentu będziemy regularnie sczytywać plik XML aby indeksować nowe ogłoszenia, modyfikować zmienione oraz usuwać ogłoszenia nieaktualne, których nie ma już w pliku.

Twoje ogłoszenia zostaną wprowadzone do wyników wyszukiwania Trovit, Mitula jak najszybciej możliwie!

W razie jakichkolwiek dalszych pytań skontaktuj się z nami!

FORMAT PLIKU XML

Poniżej znajduje się kilka wskazówek mających pomóc Tobie utworzyć plik XML, dzięki któremu zawrzesz swoje ogłoszenia w Trovit, Mitula. Gdybyś potrzebował więcej informacji na temat pliku XML zajrzyj do Wikipedii.

Plik powinien posiadać kodowanie UTF-8

Plik powinien zawierać wszystkie aktualne oferty.

Plik XML powinien zawierać jeden element główny <trovit>, który zawiera wiele elementów <ad></ad>. Z kolei każdy element <ad></ad> posiada pola zarówno obowiązkowe, jak i opcjonalne:

Skonsultuj również specyfikację techniczną pól.

POLA OBOWIĄZKOWE

Aby zawrzeć ogłoszenia w Trovit, Mitula należy wypełnić wszystkie pola obowiązkowe. Dostarczają one informację zapewniającą minimalną jakość każdego ogłoszenia.

id: id ogłoszenia na twojej stronie (numeryczne bądź alfanumeryczne, ale musi być unikalny aby uniknąć duplikatów)
url: URL ogłoszenia na twojej stronie
title: tytuł ogłoszenia (musi być całkowicie powiązany z ogłoszeniem, nie może zawierać ani nazwy ani URL Twojej strony)
content: opis samochodu (minimum 30 znaków) Pamiętaj, że im bogatszy opis, tym chętniej czytany!
date: data ogłoszenia, akceptowane formaty: DD/MM/RRRR, DD/MM/RRRR HH:MM:SS, RRRR/MM/DD lub RRRR/MM/DD HH:MM:SS

Skonsultuj również specyfikację techniczną pól.

POLA OPCJONALNE

Pola opcjonalne, jak sama nazwa wskazuje, nie są obowiązkowe. Jednak, jeśli pola te pojawiają się na Twojej stronie najlepiej umieścić je również w pliku. Algorytm Trovit, Mitula, ustalający kolejność pojawiania się ogłoszeń, bierze pod uwagę także ich jakość, stąd im bogatsze ogłoszenie tym lepsza jego pozycja w Trovit, Mitula!

mobile_url: URL ogłoszenia oglądane na mobilnej wersji strony
price: cena samochodu; tylko liczba całkowita, bez waluty ani przecinków, kropek i spacji. Jeśli cena podana jest w walucie innej niż PLN należy również użyć atrybut dla waluty. W ten sposób Trovit, Mitula będzie mógł zastosować przelicznik na PLN.
```
<price currency="USD"><![CDATA[...]]></price>
```
W ten sposób została określona cena samochodu w dolarach w Polsce. Trovit, Mitula przeliczy ją na cenę w PLN.
Jeśli chcesz więcej informacji zobacz specyfikację techniczną
city: miasto
region: województwo
postcode: kod pocztowy
city_area: dzielnica
make: marka samochodu
model: model samochodu
color: kolor samochodu
year: rok produkcji
mileage: przebieg (tylko liczba, bez jednostki)
fuel: rodzaj paliwa (tzn. benzyna, diesel, itp.)
transmission: skrzynia biegów (manualna/automatyczna)
engine_size: pojemność silnika w cm3 (tylko liczba, bez jednostki)
cylinders: liczba cylindrów (tylko liczba, bez jednostki) (opcjonalnie)

power: moc (tylko liczba, bez jednostki) ; wybierz jedno z poniższych:

<power unit="hp"><![CDATA[...]]></power>
<power unit="kw"><![CDATA[...]]></power>
<power unit="cv"><![CDATA[...]]></power>
<power unit="ch"><![CDATA[...]]></power>
<power unit="km"><![CDATA[...]]></power>
<power unit="ps"><![CDATA[...]]></power>
<power unit="pk"><![CDATA[...]]></power>
<power unit="cp"><![CDATA[...]]></power>

(hp = konie mechaniczne)

doors: liczba drzwi (liczba całkowita)
seats: liczba siedzeń
gears: liczba biegów
pictures: URL-y zdjęć danego ogłoszenia; dodatkowe instrukcje poniżej
expiration_date: data wygaśnięcia ogłoszenia w formacie DD/MM/RRRR
is_new: 0 jeśli jest to samochód używany, 1 jeśli jest to samochów nowy
car_type: rodzaj nadwozia: sedan, hatchback, 4×4, itp.
warranty: czy samochód ma gwarancję
fuel_consumption: średnie zużycie paliwa. Jednostka domyślna to l/100km. Jeśli chcesz zmienić jednostkę dodaj atrybut ‘unit’:
```
<fuel_consumption unit="km/l"><![CDATA[...]]></fuel_consumption>
```
Jednostki akceptowane: “l/100km”, “km/l”, “mpg”, “gal/mi”.
co2_emissions: emisje CO2. Jednostka domyślna to g/km. Jeśli chcesz zmienić jednostkę dodaj atrybut ‘unit’:
```
<co2_emissions unit="g/mi"><![CDATA[...]]></co2_emissions>
```
Jednostki akceptowane: “g/km”, “g/mi”.
eco_score: informacja o eco score samochodu (wolny tekst)
expiration_date: data wygaśnięcia ogłoszenia, akceptowane formaty: DD/MM/RRRR, DD/MM/RRRR HH:MM:SS, RRRR/MM/DD lub RRRR/MM/DD HH:MM:SS
pictures: W tym polu zawarte są zdjęcia nieruchomości. Pole to może zawierać jedno lub więcej elementów ‘picture’.
- picture: Pole to zawiera URL i tytuł zdjęcia (tytuł jest opcjonalny). Możesz określić, które zdjęcie ma być zdjęciem głównych korzystając z atrybutu ‘featured’ w sposób następujący:
```
 
        <picture featured="true"><![CDATA[...]]></picture>
```
  Należy wpisać jedną z dwóch wartości: “true” lub “false”
  
  Pole ‘picture’ zawiera następujące 2 elementy:
  - picture_url: URL zdjęcia na twojej stronie
  - picture_title: tytuł zdjęcia
```
 
<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>
```
  Pierwsze zdjęcie ogłoszenia będzie pokazywane w Trovit, Mitula.
  Wybierz zdjęcie, które wzbudzi największe zainteresowanie!
  
  Trovit, Mitula nie akceptuje zdjęć z logiem firmy z napisem “brak zdjęcia”. Jeśli zostanie wykryte takie zdjęcie Trovit, Mitula może nie zindeksować danego ogłoszenia.
  
  Zdjęcia powinny posiadać minimum 186×186 px oraz nie przekraczać 1MB.
  
  Po zindeksowaniu danego ogłoszenia jego zdjęcie nie może już zostać zmienione. Dlatego upewnij się, że ogłoszenia zawierają poprawne zdjęcia.

Plik XML powinien wyglądać następująco:

<?xml version="1.0" encoding="utf-8"?>
<trovit>

<ad>
    <id><![CDATA[...]]></id>
    <url><![CDATA[...]]></url>
    <mobile_url><![CDATA[...]]></mobile_url> 
    <title><![CDATA[...]]></title>

    <content><![CDATA[...]]></content>
    <date><![CDATA[...]]></date>
    <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>

    <is_new><![CDATA[...]]></is_new>
    <car_type><![CDATA[...]]></car_type>
    <warranty><![CDATA[...]]></warranty>

</ad>

<ad>
    ....

</ad>

<ad>
    ....
</ad>

...

</trovit>

Przykład pliku XML

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
	<id><![CDATA[7004578]]></id>
	<url><![CDATA[http://www.twojadomena.pl/7004578]]></url>
        <mobile_url><![CDATA[http://www.m.twojadomena.pl/7004578]]></mobile_url> 
	<title><![CDATA[2005 Audi A3]]></title>
	<content><![CDATA[ABS, ASR, ESP, Immobiliser, Kurtyny powietrzne, Poduszka powietrzna kierowcy, Poduszka powietrzna pasazera, Poduszki powietrzne boczne, Centralny zamek sterowany pilotem z kluczyka, Czujnik deszczu, Czujnik zmierzchu, Elektrycznie sterowane lusterka boczne, Elektrycznie sterowane szyby - przod, Elektrycznie sterowane szyby - tyl, Klimatyzacja automatyczna dwustrefowa, Komputer pokladowy, Obrotomierz, Regulacja kolumny kierowniczej, Regulacja wysokosci fotela kierowcy, Skorzana kierownica, Tempomat, Wspomaganie ukladu kierowniczego.]]></content>
        <date><![CDATA[20/09/2012 19:50:00]]></date>	
        <price><![CDATA[56900]]></price>
	<make><![CDATA[Audi]]></make>
	<model><![CDATA[A3]]></model>
	<color><![CDATA[Szary metalic]]></color>
	<year><![CDATA[2005]]></year>
	<city><![CDATA[Wrocław]]></city>
	<city_area><![CDATA[Środmieście]]></city_area>
	<postcode><![CDATA[02-584]]></postcode>
	<region><![CDATA[dolnośląskie]]></region>
	<mileage><![CDATA[123000]]></mileage>
	<doors><![CDATA[3]]></doors>
	<fuel><![CDATA[olej napędowy]]></fuel>
	<transmission><![CDATA[manualna]]></transmission>
	<engine_size><![CDATA[1900]]></engine_size>
	<power><![CDATA[115]]></power>
	<seats><![CDATA[5]]></seats>
	<gears><![CDATA[6]]></gears>
	<pictures>
		<picture>
			<picture_url><![CDATA[http://www.twojadomena.pl/zdjecie1.jpg]]></picture_url>
			<picture_title><![CDATA[przod]]></picture_title>
		</picture>
		<picture>
			<picture_url><![CDATA[http://www.twojadomena.pl/zdjecie2.jpg]]></picture_url>
			<picture_title><![CDATA[wnetrze]]></picture_title>
		</picture>
	</pictures>
	<is_new><![CDATA[0]]></is_new>
	<car_type><![CDATA[hatchback]]></car_type>
	<warranty><![CDATA[do marca 2010]]></warranty>
</ad> 
</trovit>

Articles in this section

Polska - Plik XML – Samochody

FORMAT PLIKU XML

POLA OBOWIĄZKOWE

POLA OPCJONALNE

Przykład pliku XML

Comments

Articles in this section

FORMAT PLIKU XML

POLA OBOWIĄZKOWE

POLA OPCJONALNE

Przykład pliku XML

Related articles