Sākums
Tavacena salīdzina cenas, lasot tava veikala preču datus no publiska feed. Tu pievieno feed adresi vienu reizi, mēs to regulāri lejupielādējam, validējam un kartējam tavas kategorijas uz Tavacena taksonomiju. Pēc apstiprināšanas tavas cenas parādās katalogā līdzās konkurentiem un automātiski atjaunojas pēc tava izvēlētā grafika.
Produktu feed
Feed ir strukturēts tava preču klāsta saraksts, ko Tavacena periodiski lasa. Mēs atbalstām šādus formātus:
- XML (ieteicams) — pilns lauku atbalsts un ticamākā validācija.
- CSV — viena rinda uz preci ar galveni; lauku nosaukumi atbilst zemāk norādītajiem.
- Google Merchant (RSS 2.0) — esošo Google Shopping feed var pievienot bez pārveidošanas.
Atjaunošanas grafiks
Feed lejupielādes biežumu izvēlies veikala importa konfigurācijā:
reizi stundā— straujam sortimentam un biežām cenu izmaiņām.ik 4h— līdzsvarots noklusējums lielākajai daļai veikalu.reizi dienā— stabilam klāstam ar retām izmaiņām.manuāli— feed tiek lasīts tikai pēc tava pieprasījuma.
Feed adresei jābūt publiski sasniedzamai pa https bez autorizācijas vai IP ierobežojumiem. Pievieno to sadaļā veikala importa konfigurācija un palaid pirmo validāciju.
Obligātie lauki
Katrai precei feed jāsatur zemāk norādītie obligātie lauki. Neobligātie lauki uzlabo atbilstību un attēlojumu katalogā, taču nav nepieciešami publicēšanai.
| Lauks | Tips | Obligāts | Apraksts |
|---|---|---|---|
offer_id | string | jā | unikāls preces ID tavā veikalā |
title | string | jā | preces nosaukums |
price | decimal | jā | cena ar PVN, piem. 729.00 |
currency | string | jā | EUR |
url | url | jā | saite uz preci tavā veikalā |
image_url | url | jā | galvenā attēla saite |
availability | enum | jā | in_stock / low_stock / out_of_stock |
category | string | jā | tava kategorija kartēšanai |
delivery_cost | decimal | nē | piegādes maksa, piem. 3.99 |
gtin | string | nē | EAN/UPC svītrkods |
brand | string | nē | ražotājs |
Feed piemērs
Minimāls derīgs XML feed ar diviem piedāvājumiem un visiem obligātajiem laukiem:
Kategoriju kartēšana
Tava feed category vērtība ir tava veikala iekšējā kategorija. Lai preces parādītos pareizajās salīdzinājuma sadaļās, katra tava kategorija tiek piesaistīta vienai Tavacena taksonomijas kategorijai.
Pirmajā importā mēs piedāvājam automātisku atbilstību pēc nosaukuma un satura. Atbilstības tu vari pārskatīt un manuāli labot veikala importa konfigurācijā — manuālā izvēle vienmēr aizstāj automātisko.
Preces ar nekartētu kategoriju paliek paslēptas no kataloga, līdz to kategorija ir piesaistīta. Tās netiek dzēstas un parādās uzreiz pēc kartēšanas saglabāšanas.
API atslēgas
Papildus feed Tavacena piedāvā REST API tiešai piekļuvei tava veikala piedāvājumiem. API atslēgu izveido sadaļā Iestatījumi → API; glabā to drošā vietā un nekad neiekļauj klienta pusē.
Bāzes adrese un autorizācija notiek ar Bearer galveni:
Pieprasījumu limits ir 600 pieprasījumi / min uz vienu atslēgu. Pārsniedzot to, API atbild ar kodu 429 un galveni Retry-After.
Webhooki
Webhooki paziņo tavai sistēmai par importa notikumiem reāllaikā, lai tev nebūtu jāveic regulāra aptauja. Galamērķa adresi norādi sadaļā Iestatījumi → API. Pieejamie notikumi:
import.completed— imports pabeigts veiksmīgi.import.failed— imports neizdevās (piem., feed nesasniedzams).offer.rejected— atsevišķs piedāvājums noraidīts validācijā.
Piemērs · import.completed
Kļūdu kodi
Feed apstrāde un API atbild ar standarta HTTP statusa kodiem. Biežākie kodi un to nozīme:
| Kods | Nozīme |
|---|---|
| 200 | ok · feed apstrādāts |
| 304 | nav izmaiņu |
| 422 | validācijas kļūda · trūkst obligāta lauka |
| 429 | pārāk daudz pieprasījumu |
| 502 | feed nesasniedzams · bad gateway |
| 504 | feed taimauts |