Twoje ogłoszenia w Trovit Polska

Plik XML – Samochody

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

  1. Utwórz plik UTF-8 XML według poniższej specyfikacji.
  2. 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 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. 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 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, 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!

  • 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 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 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.
      Wybierz zdjęcie, które wzbudzi największe zainteresowanie!

      Trovit nie akceptuje zdjęć z logiem firmy z napisem “brak zdjęcia”. Jeśli zostanie wykryte takie zdjęcie Trovit 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>
Privacy policy · Legal Notice · Terms and conditions · Cookie policy