• Uvoz je pogodan za kompanije sa velikim brojem ponuda — proizvoda, nekretnina ili usluga. Na svom sajtu objavljujete fajl sa celim katalogom, a naš sajt ga preuzima otprilike jednom na sat i na osnovu njega pravi, ažurira i skida vaše oglase sa prikaza. Nema potrebe da ručno dodajete i menjate svaki oglas. Povezivanje i preuzimanja su besplatna.

    Takav fajl naziva se fid. Njegov format je YML: XML fajl koji mnoge internet-prodavnice i CMS sistemi umeju da izvezu.

    Fid će praviti programer ili AI agent? Prosledite mu uputstvo za AI agenta i programera (na ruskom jeziku). U njemu su svi zahtevi za fajl, pitanja koja izvršilac treba da vam postavi i kontrolna lista za proveru. AI agentu (na primer, ChatGPT, Claude ili Cursor) dovoljno je da priložite taj fajl uz zadatak. Ako nema ko da napravi fid, pišite nam preko obrasca za kontakt.

    Sadržaj

    Kako povezati uvoz

    1. Pripremite fid prema zahtevima iz ovog članka i postavite ga na stalnu adresu, na primer https://vas-sajt.rs/export/catalog.xml. Adresa mora da se otvara u pregledaču bez lozinke.
    2. Sačuvajte vezu. Prijavite se na sajt i otvorite odeljak „Uvoz oglasa“ u ličnom kabinetu. Unesite adresu fida i kliknite na „Sačuvaj vezu“.
    3. Potvrdite sajt. U bloku „Potvrda sajta“ pojaviće se fajl sa imenom oblika partner-verification-….txt. Preuzmite ga dugmetom „Preuzmi datoteku“ i postavite u koren sajta čija je adresa navedena u elementu shop/url fida. Fajl mora da se otvara na adresi https://vas-sajt.rs/partner-verification-….txt. Tako proveravamo da fid objavljuje vlasnik sajta.
    4. Proverite fid. Kliknite na „Proveri fid“. Obično se nakon nekoliko minuta u bloku „Poslednja provera fida“ pojavi izveštaj. Provera ništa ne objavljuje: traži greške u fajlu, proverava fajl za potvrdu i učitava spisak vaših kategorija. Ispravite greške i ponovo proverite fid — ponovna provera je dostupna nakon 2 minuta.
    5. Izaberite odeljke i teritoriju. U bloku „Kategorije i teritorija“ za svaku kategoriju iz fida izaberite odeljak našeg sajta ili „Ne uvoziti“. Navedite zemlju, region i grad: oni će važiti za sve oglase. Kliknite na „Sačuvaj podešavanja“.
    6. Izaberite kontakte. U bloku „Kontakti u oglasima“ označite šta prikazivati u oglasima: ime, imejl, telefon, Telegram i dodatne kontakte. Sami podaci uzimaju se iz profila i menjaju se u odeljku „Moji lični podaci“. Označite saglasnost za širenje i kliknite na „Sačuvaj kontakte“.
    7. Prihvatite uslove. U bloku „Uslovi uvoza oglasa“ pročitajte uslove i kliknite na „Prihvatam uslove uvoza oglasa“.
    8. Pošaljite prijavu. U bloku „Prijava za automatski uvoz“ kliknite na „Pošalji prijavu“. Ako nešto nije spremno, kabinet će pokazati šta tačno. Nakon što administrator odobri prijavu, prvo preuzimanje će se obaviti u roku od sat vremena, a zatim će sajt fid preuzimati sam.

    Zahtevi za fajl

    • Fajl uvek sadrži ceo aktuelni katalog, a ne samo izmene. Ponuda koje nema u novoj verziji fajla skida se sa prikaza.
    • Format je YML (XML) u kodiranju UTF-8 ili Windows-1251. ZIP ili GZ arhiva umesto XML-a nije prihvatljiva.
    • Adresa počinje sa http:// ili https://, koristi standardni port, nema korisničko ime i lozinku i dostupna je sa interneta.
    • Sajt fid preuzima programom, a ne pregledačem. Zaštita od botova — kapča, provera pregledača ili blokiranje po IP adresi — ne sme da zatvara fid, fajl za potvrdu i fotografije. Zahtevi stižu sa zaglavljem User-Agent koje sadrži PartnerImport — možete ga dodati u izuzetke zaštite.
    • Server isporučuje ceo fajl najduže za 60 sekundi. Veličina je do 50 MB.
    • Dozvoljeno je do 1000 ponuda, uključujući one povučene iz prodaje. Ako vam je potrebno više, pišite nam. Fajl preko ograničenja ne prihvata se u celosti.
    • Dozvoljeno je do 150 kategorija, uključujući roditeljske i prazne.

    Primer fida:

    <?xml version="1.0" encoding="UTF-8"?>
<yml_catalog>
  <shop>
    <url>http://partner.example/</url>
    <categories>
      <category id="10">Nosiljke i torbe</category>
    </categories>
    <offers>
      <offer id="SKU-0042" available="true">
        <name>Nosiljka za mačku</name>
        <url>http://partner.example/products/SKU-0042</url>
        <price>1500</price>
        <currencyId>RUB</currencyId>
        <categoryId>10</categoryId>
        <picture>http://partner.example/images/SKU-0042-main.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-side.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-detail.jpg</picture>
        <description>Nova nosiljka. Veličina 48 × 32 × 30 cm. Lično preuzimanje.</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

    Preuzimanje: ovaj primer, primer sa svim podržanim poljima.

    Koje podatke sajt uzima iz fajla

    shop/url — obavezan
    Adresa vašeg sajta. U njen koren postavlja se fajl za potvrdu, a veze ka stranicama ponuda moraju da vode na taj isti sajt.
    category — obavezan
    Vaše kategorije. Atribut id je ceo pozitivan broj, jedinstven u fajlu; parentId je id roditeljske kategorije. U kabinetu se svakoj kategoriji dodeljuje odeljak našeg sajta.
    offer, atribut id — obavezan
    Stalni identifikator ponude, do 80 znakova. Po njemu sajt prepoznaje ponudu pri narednim preuzimanjima.
    offer, atribut available — nije obavezan
    true — prikazivati, false — skinuti sa prikaza. Bez atributa ponuda se smatra dostupnom.
    name — obavezan
    Naslov oglasa. Umesto njega možete navesti type="vendor.model" u ponudi i elemente typePrefix, vendor i model.
    categoryId — obavezan
    id kategorije ponude.
    description — obavezan
    Tekst oglasa. HTML je dozvoljen: sajt uklanja oznake i čuva pasuse.
    price — nije obavezan
    Cena. Bez cene oglas se objavljuje sa cenom po dogovoru.
    currencyId — nije obavezan
    Valuta cene. Bez nje koriste se rublje.
    url — nije obavezan
    Stranica ponude na vašem sajtu. U oglasu se prikazuje kao red „Veb-sajt“.
    picture — nije obavezan
    Fotografije, do 5. Prva je glavna.

    Ostale YML elemente — karakteristike, popuste, dostavu i druge — sajt preskače i navodi u izveštaju kao upozorenje. To nije greška. Svi uvezeni oglasi dobijaju tip „Ponuda“, a odeljak, teritoriju i kontakte određuju podešavanja kabineta, a ne fajl.

    Naslov i opis

    Naslov i opis proveravaju se po istim pravilima kao oglasi dodati ručno. Ponuda koja krši pravilo preskače se, a razlog je vidljiv u izveštaju. Tekstovi se ne ispravljaju i ne skraćuju automatski.

    • Naslov — do 150 znakova, opis — do 5000 znakova. Opis je obavezan.
    • Bez veza, imejl adresa i brojeva telefona: kontakte će sajt sam dodati u oglas. Niz od 11 cifara koji počinje sa 7 ili 8 smatra se telefonom, čak i ako je šifra proizvoda.
    • Bez reči od 30 ili više znakova bez razmaka: duge šifre proizvoda i spojene reči razdvojite razmacima.
    • U naslovu nema naziva grada izabranog za oglase u kabinetu.
    • Bez psovki i zabranjenih tema: alkohol, duvan, oružje, lekovi na recept, kockanje, krediti i zajmovi i drugo.

    Dugme „Proveri fid“ ne proverava ova pravila — to proveravaju preuzimanja nakon odobrenja prijave. Prazan opis i nedostajući categoryId ono pronalazi: takve ponude se u izveštaju prikazuju sa greškom. Da ne biste o kršenjima pravila za tekstove saznali iz prvog izveštaja, unapred proverite tekstove: u uputstvu za AI agenta i programera (na ruskom jeziku) pravila su detaljno opisana.

    Cena, valuta i fotografije

    • Cena je broj sa tačkom: 1500 ili 1499.90, bez razmaka, zareza i znaka valute. Iznos se zaokružuje na ceo broj: 1499.50 postaje 1500. Ako cena nedostaje, prazna je ili jednaka 0, u oglasu će pisati „po dogovoru“.
    • Valuta — RUB (ili RUR), USD, EUR, AMD, KZT, GEL, BYN, UAH, AZN, KGS, RSD. Cena se ne preračunava po kursu.
    • Fotografije — JPEG, PNG ili WebP, do 15 MB svaka. Sajt uzima prvih 5 veza iz picture.
    • Sajt pamti fotografiju po vezi. Da biste zamenili fotografiju, promenite vezu — na primer, ime fajla. Novi fajl na staroj vezi sajt neće primetiti.
    • Ako se fotografija ne preuzme, oglas se ipak objavljuje, a sajt će pokušati ponovo otprilike za jedan dan.

    Kako ažurirati i povući ponude

    • Ako su se promenili cena, tekst ili fotografije, zadržite prethodni id. Sajt će ažurirati isti oglas, a njegova adresa i datum objavljivanja biće sačuvani.
    • Ne menjajte id postojećih ponuda i ne dodeljujte id povučenog proizvoda drugom proizvodu. Novi id znači novi oglas, a stari će biti povučen. Velika i mala slova su važna: SKU-42 i sku-42 su različite ponude.
    • Da biste povukli ponudu, navedite available="false" ili je uklonite iz fajla. Oglas će se sakriti i čuvati 180 dana: ako se ponuda vrati sa istim id, vratiće se i prethodni oglas. Nakon 180 dana oglas se briše.
    • Izbor „Ne uvoziti“ za kategoriju u kabinetu skriva sve njene oglase odmah nakon čuvanja podešavanja.
    • Prazan spisak ponuda <offers/> skida sve oglase sa prikaza. Ako elementa offers u fajlu uopšte nema, fajl se smatra oštećenim i oglasi se ne menjaju.
    • Oglas koji je administrator sajta obrisao ne pravi se ponovo sa istim id.

    Greške i izveštaji

    Izveštaj provere vidi se u bloku „Poslednja provera fida“, a izveštaj redovnog preuzimanja — u bloku „Poslednje preuzimanje“. Poruke mogu biti tri vrste.

    • Greška fajla — fajl nije prihvaćen i oglasi se ne menjaju. Na primer: oštećen XML, nedostaje shop/url, prekoračeno je ograničenje ili sajt nije potvrđen.
    • Greška ponude — preskače se samo ta ponuda: novi oglas se ne pravi, a postojeći zadržava prethodne podatke. Ostale ponude se obrađuju, a rezultat preuzimanja je „Delimično“.
    • Upozorenje — ne utiče na objavljivanje. Na primer: suvišni elementi u fajlu, nedostaje atribut available ili se fotografija nije preuzela.

    Ako ne možete da ispravite grešku, prosledite tekst izveštaja svom programeru ili AI agentu zajedno sa uputstvom — u njemu je za svaku poruku navedeno šta treba ispraviti.

    Ako se fajl prestane preuzimati

    Dok fajl nije prihvaćen — server je nedostupan, u fajlu je greška ili je nestao fajl za potvrdu — oglasi ostaju u poslednjoj prihvaćenoj verziji. Ako se to nastavi:

    • nakon 24 sata dobićete imejl sa razlogom;
    • nakon 7 dana svi oglasi veze sakriće se, a preuzimanja će postati ređa — jednom dnevno;
    • nakon 180 dana uvoz će prestati, a oglasi će biti obrisani.

    Čim fajl ponovo bude prihvaćen, oglasi se vraćaju na sajt.

    Upravljanje oglasima

    • Uvezene oglase nije moguće uređivati i brisati na sajtu: umesto „Uredi“ kod njih stoji „Upravlja fid“. Podatke menjajte u fidu.
    • U spisku vaših oglasa dostupni su „Pauzirati prikazivanje“ i „Zatvoriti oglas“ (prenošenje u arhivu). Povratak ponude u fid ne poništava ove radnje.
    • U odeljku „Uvoz oglasa“ možete pauzirati uvoz, sakriti sve oglase, promeniti adresu fida ili prekinuti uvoz uz brisanje svih oglasa.

    Uslovi rada uvoza nalaze se u dokumentu Uslovi uvoza oglasa. Pitanja postavljajte preko obrasca za kontakt.