XML upute za trgovce

01 /

Od vaše trgovine do naših kupaca

Tri koraka do uređenog izvora podataka.

01

Pripremite podatke

Izvezite proizvode u XML ili nam dostavite postojeći feed za provjeru mapiranja.

02

Provjerite svoj feed

Unesite URL u checker i pregledajte pogreške i preporuke za poboljšanja.

03

Pošaljite za uključivanje

Dostavite provjereni URL našem timu koji usklađuje uvoz i objavu.

02 /

Pravi podaci za svaki proizvod

Za novi XML koristite nazive polja u nastavku. Svaka prodajna varijanta ima svoj zapis i vlastiti, stabilni SKU.

PoljeŠto poslati

skuOsnovno

Vaš jedinstveni i trajni ID ponude. Ne mijenjajte ga pri promjeni cijene ili zalihe.

PrimjerSHIRT-001-M

product_nameOsnovno

Jasan naziv proizvoda s markom, modelom i važnom varijantom.

PrimjerAcme majica Essential, crna, M

product_categoryOsnovno

Cijela putanja kategorije u vašoj trgovini.

PrimjerOdjeća > Majice

product_brandOsnovno

Stvarna marka ili proizvođač. Ako marke nema, dogovorite se s našim timom; nemojte je izmišljati.

PrimjerAcme

product_urlOsnovno

Poveznica na proizvod ili odabranu varijantu bez UTM parametara. Zadržite parametre potrebne za odabir varijante.

Primjerhttps://example.com/essential?size=M

product_priceOsnovno

Redovna cijena s PDV-om u valuti tržišta. Decimalna točka, bez oznake valute i razdjelnika tisućica.

Primjer29.90

product_image_urls / product_image_urlOsnovno

Izravne poveznice do slika. Svaki URL u vlastitom elementu; za provjeru preporučujemo najmanje 500 × 500 px.

Primjerhttps://example.com/images/essential.jpg

product_mpnPreporučeno

Izvorna oznaka modela proizvođača, kada postoji.

PrimjerESSENTIAL-01

product_eanPreporučeno

Stvarni EAN/GTIN konkretne varijante. Sačuvajte početne nule; ne stvarajte zamjenske kodove.

PrimjerEAN/GTIN

product_descriptionPreporučeno

Opis i specifikacije u UTF-8, bez reklamnih poruka, poveznica, skripti i CSS stilova.

PrimjerPamučna majica s okruglim izrezom.

product_stockPreporučeno

Broj komada na zalihi, uključujući 0. Ako ne znate točan broj, koristite product_availability.

Primjer12

product_availabilityPreporučeno

Dostupnost kada ne šaljete količinu. Ako šaljete oba polja, ne smiju biti proturječna.

Primjerin stock / available for order / out of stock

attributesPreporučeno

Provjerena svojstva proizvoda kao parovi key/value, s mjernim jedinicama gdje su potrebne.

PrimjerColor: Black · Size: M

group_idPo potrebi

Stalna oznaka povezanih varijanti unutar trgovine. Pravila grupiranja prvo dogovorite s našim timom.

PrimjerESSENTIAL-BLACK

product_price_discountPo potrebi

Stvarna akcijska cijena s PDV-om. Kada nema akcije, izostavite polje ili ga ostavite praznim.

Primjer24.90

product_delivery_pricePo potrebi

Cijena dostave u valuti tržišta. 0 znači besplatnu dostavu; prazno polje ne znači besplatnu dostavu.

Primjer3.90

product_conditionPo potrebi

Stanje proizvoda: 1 = nov, 2 = obnovljen, 3 = rabljen.

Primjer1

product_isbnPo potrebi

Za knjige pošaljite stvarni ISBN. Za ostale proizvode ga izostavite.

Primjer9780306406157

product_warrantyPo potrebi

Trajanje jamstva s jasno navedenom jedinicom.

Primjer24 mjeseca

product_remarkPo potrebi

Kratka i aktualna napomena o ponudi.

PrimjerBesplatna dostava iznad 100 BAM.

Osnovna polja su minimum za tehničku provjeru. Ispunite podatke za svaki proizvod; rezultat checkera još ne znači potvrđen uvoz ili objavu.

03 /

Primjer koji možete upotrijebiti

Počnite s osnovnim zapisom ili dodajte podatke za bogatije predstavljanje. Primjeri su izmišljeni; zamijenite URL-ove i vrijednosti vlastitima.

products.xml

Osnovni XML

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <sku>SHIRT-001-M</sku>
    <product_name>Acme majica Essential, crna, M</product_name>
    <product_category>Odjeća &gt; Majice</product_category>
    <product_brand>Acme</product_brand>
    <product_url>https://example.com/essential?size=M</product_url>
    <product_price>29.90</product_price>
    <product_image_urls>
      <product_image_url>https://example.com/images/essential.jpg</product_image_url>
    </product_image_urls>
  </product>
</products>

Prošireni XML

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <sku>SHIRT-001-M</sku>
    <product_name>Acme majica Essential, crna, M</product_name>
    <product_category>Odjeća &gt; Majice</product_category>
    <product_brand>Acme</product_brand>
    <product_url>https://example.com/essential?size=M</product_url>
    <product_price>29.90</product_price>
    <product_image_urls>
      <product_image_url>https://example.com/images/essential.jpg</product_image_url>
    </product_image_urls>
    <product_mpn>ESSENTIAL-01</product_mpn>
    <product_description>Pamučna majica s okruglim izrezom.</product_description>
    <product_stock>12</product_stock>
    <product_price_discount>24.90</product_price_discount>
    <product_delivery_price>3.90</product_delivery_price>
    <product_condition>1</product_condition>
    <attributes>
      <attribute>
        <key>Color</key>
        <value>Black</value>
      </attribute>
      <attribute>
        <key>Size</key>
        <value>M</value>
      </attribute>
    </attributes>
  </product>
</products>

Stalan SKU

Isti proizvod pri svakom izvozu treba zadržati isti identifikator.

Valjan XML

Znak & napišite kao &. Tekst možete zaštititi i s CDATA.

Jedna slika, jedan element

Više slika pošaljite kroz više elemenata product_image_url.

04 /

Povežite varijante na pravi način

Svaka varijanta ima svoj SKU, cijenu, zalihu i odgovarajuću poveznicu. group_id povezuje samo varijante za koje je grupiranje dogovoreno.

group_idESSENTIAL-BLACK

M

Veličina Msku: SHIRT-001-M

L

Veličina Lsku: SHIRT-001-L

Ilustracija dogovorene grupe: isti model i boja, dvije veličine.

Prije upotrebe uskladite pravila grupiranja. Isti group_id može utjecati na povezivanje s istim kataloškim proizvodom; različiti modeli ili kapaciteti ne pripadaju automatski istoj grupi.

Primjer prikazuje odnos identifikatora. Za stvarni uvoz dodajte sva osnovna polja za svaku varijantu.

05 /

Spremni za sljedeći korak?

Objavite feed na stalnom URL-u, provjerite rezultat i zatim uskladite uključivanje s našim timom.

Stalan i dostupan URL

Feed treba biti dostupan za automatsko preuzimanje. Checker upozorava na poteškoće s pristupom.

Aktualne cijene i zaliha

Osvježavajte feed najmanje dnevno i nakon važnih promjena. Učestalost našeg preuzimanja dogovaramo pri uključivanju.

Pregled konkretnih pogrešaka

Provjerite broj pregledanih proizvoda i primjere pogrešaka. Slike i stranice proizvoda provjeravaju se na uzorku.

Provjerite prije slanja

Feed checker pomaže pronaći polja koja nedostaju, poteškoće s formatom i slikama te prilike za poboljšanje.

Provjeri moj feed ↗

Tehnička provjera ne uključuje trgovinu i ne objavljuje proizvode.

Prijavi trgovinu za uključivanje

06 /

Još nekoliko korisnih odgovora

Već imam Google, Meta ili drugi feed. Trebam li novi?

Prvo provjerite postojeći feed. Checker prepoznaje više uobičajenih naziva polja i XML/CSV. Prepoznavanje ne jamči ispravno mapiranje za uvoz; to dogovaramo pri uključivanju.

Znači li »Ready« da je svaki proizvod ispravan?

Ne. Checker trenutačno dopušta manje nedostatke u obveznim poljima ako svako postiže najmanje 95 % pokrivenosti. Pregledajte i upozorenja i pogođene proizvode. Rezultat nije potvrda objave.

Što šaljem ako nemam EAN ili MPN?

Pošaljite samo stvarne identifikatore koji postoje za proizvod. Ne izmišljajte kodove i ne koristite isti kod za različite varijante. Nedostatke uskladite pri uključivanju.

Što kada proizvoda više nema na zalihi?

Ažurirajte količinu na 0 ili dostupnost na out of stock. Obradu proizvoda koji nestanu iz feeda dogovorite s našim timom; uklanjanje zapisa nije isto što i informacija o zalihi.

Zašto checker prihvaća cijenu s oznakom valute?

Radi kompatibilnosti checker prihvaća neke oznake valute. Za novi XML ipak koristite čisti broj, npr. 29.90, u odgovarajućoj valuti tržišta. Prihvaćen broj ne potvrđuje valutu.

Vaši proizvodi.Spremni za objavu.