OpenCart XML srautų generatorius Google Shopping ir Meta

Google Shopping paieškai reikia prekių srauto URL, kurį Merchant Center atsisiunčia pagal tvarkaraštį, ir septynių privalomų atributų kiekvienai prekei. Tai Google prekių duomenų specifikacijoje nurodyti atributai: id, title (pavadinimas), description (aprašymas), link (prekės puslapis), image_link (pagrindinė nuotrauka), availability (prieinamumas) ir price (kaina).

Universal XML Feed Generator sukūrėme dirbdami su OpenCart projektais, kartu su savo DPD siuntų sekimo, tiekėjų importo ir prekių vaizdo įrašų moduliais, o prieš įkeldami į Marketplace išbandėme jį veikiančioje OpenCart 3 parduotuvėje.

Prie jų prisideda prekės identifikatoriai: GTIN – kiekvienai prekei, kuriai gamintojas jį suteikė, prekės ženklas (brand) – daugumai naujų prekių, o MPN – kai GTIN nėra. Aprašymas gali būti iki 5000 simbolių.

Google Merchant Center šablonas OpenCart katalogą paverčia tokios struktūros srautu: sukuria RSS 2.0 failą su Google g: vardų erdve, pavadinimus apriboja iki Google leidžiamų 150 simbolių, EAN eksportuoja kaip GTIN tik tada, kai jo ilgis ir kontrolinis skaitmuo teisingi, o kai MPN laukas tuščias, naudoja prekės modelį. Todėl modelio lauke laikykite gamintojo prekės kodą, o ne vidinį parduotuvės kodą.

Jungtinės Karalystės parduotuvės sraute kainos turi būti nurodytos svarais (GBP), sutapti su kaina prekės puslapyje ir krepšelyje bei būti su PVM: Google kainos specifikacijoje Jungtinė Karalystė įrašyta tarp šalių, kuriose kaina pateikiama su PVM, o JAV ir Kanadoje – be mokesčių.

Teisingas srautas negarantuoja, kad kiekviena prekė bus patvirtinta ar parodyta: Merchant Center vis tiek tikrina kiekvieną prekę pagal savo taisykles. Tokius pačius struktūrizuotus prekių duomenis – identifikatorius, kainas ir prieinamumą – skaito ir DI apsipirkimo asistentai, kai lygina prekes.

OpenCart XML srautų generatorius sukuria srautus Google Merchant Center, Meta (Facebook) katalogams, edrone ir kainų portalams, taip pat CSV, Google Sitemap ir savos struktūros XML. Kainų portalai – Lietuvos kainos.lt ir kaina24.lt; kiekvienas srautas kuriamas iš šablono ir turi savo URL bei prieigos raktą. Srautų galite turėti tiek, kiek reikia. Pritaikius šabloną, užpildoma struktūra, laukai ir formato nustatymai, o jau nustatyti filtrai išlieka.

Meta platformai skirtas Facebook katalogo šablonas sukuria OpenCart Facebook katalogo srautą, kurį į Meta Commerce Manager įtraukiate kaip pagal tvarkaraštį atnaujinamą duomenų srautą. Kadangi Google ir Meta srautai turi atskirus URL, juos galima skirtingai filtruoti ir taikyti skirtingas kainas.

Būtent Custom šablonas modulį daro universalų. Jei portalas ar partneris prašo struktūros, kurios sąraše nėra, šakninį elementą, prekės elementą, prekės ID atributą ir kiekvienos žymos pavadinimą nustatote patys, nerašydami PHP kodo. Taip sukuriamas kainų palyginimo srautas portalui, kuriam atskiro šablono nėra.

Ar modulis sukuria ir XML svetainės žemėlapį? Taip. Google Sitemap šablonas veikia kaip OpenCart XML svetainės žemėlapio generatorius: į jį patenka pagrindinis puslapis, prekės, kategorijos, gamintojai ir informaciniai puslapiai. Prioritetą ir keitimo dažnumą galima nustatyti kiekvienam puslapio tipui, taip pat įtraukti nuotraukų žymas. Faile robots.txt uždrausti URL, pasikartojantys URL ir, jei pasirinkta, tuščios kategorijos praleidžiami, o viršijus 50 000 URL arba apie 50 MB žemėlapis padalijamas į kelis failus su svetainės žemėlapio indeksu (sitemap index). Su nustatymu „File in store root“ modulis įrašo sitemap.xml į parduotuvės šakninį aplanką ir per pirmą generavimą pakeičia esamą failą, todėl gali perimti atskiro sitemap plėtinio darbą.

• Google Merchant Center (RSS 2.0 su g: vardų erdve)
• Meta / Facebook katalogas
• edrone (Google Merchant Center standarto struktūra)
• kainų palyginimo portalai kainos.lt ir kaina24.lt
• OpenCart prekių eksportas į CSV su pasirenkamu skyrikliu ir neprivalomu UTF-8 BOM, kad failas teisingai atsidarytų Excel programoje
• Google Sitemap (sitemap.xml)
• Savos struktūros XML

OpenCart Google Shopping srautą galima paruošti per šešis žingsnius – nuo modulio diegimo iki pirmo Merchant Center atsisiuntimo. Modulis diegiamas standartine OpenCart priemone Extension Installer ir nekeičia branduolio failų, o paketas neatlieka jokių OCMOD failų pakeitimų, todėl nėra ko derinti su kitomis jūsų modifikacijomis.

Jei parduotuvėje jau naudojamas OpenCart Google Sitemap srautas arba senesni kainos.lt, edrone ar kaina24 plėtiniai, diegimas kiekvienam iš jų sukuria atitinkamą išjungtą srautą, o senųjų plėtinių nekeičia, todėl prieš perjungdami galite palyginti rezultatą.

OpenCart Google Merchant Center srauto paruošimo žingsniai:

1. 01Įkelkite .ocmod.zip per Extensions > Installer ir atnaujinkite Extensions > Modifications.
2. 02Įdiekite „Universal XML Feed Generator“ skiltyje Extensions > Extensions > Modules – diegimas įjungia modulį ir sukuria atsitiktinį bendrą slaptąjį raktą.
3. 03Atidarykite naują administravimo meniu „XML feed generator“ ir pasirinkite „Add new feed“.
4. 04Pasirinkite Google Merchant Center šabloną, spauskite „Apply preset“, skirtuke Prices and data nustatykite kalbą, valiutą (Jungtinei Karalystei – GBP) ir PVM, tada išsaugokite – atsiras srauto URL su raktu.
5. 05Spauskite „Generate now“ srautų sąraše ir peržiūrėkite rezultatą.
6. 06Pridėkite srauto URL Google Merchant Center paskyroje kaip prekių duomenų šaltinį iš failo, pasirinkite, kaip dažnai Google turi jį atsisiųsti, o po pirmo atsisiuntimo ištaisykite nurodytas prekių problemas OpenCart arba srauto nustatymuose.

Kiekvieno srauto laukus, prekių filtrus ir kainas valdote atskirai šešiuose skirtukuose: „General“ (bendrieji), „Structure and fields“ (struktūra ir laukai), „Filters“ (filtrai), „Prices and data“ (kainos ir duomenys), „Sitemap“ (svetainės žemėlapis) ir „Output“ (išvestis). Laukų redaktoriuje laukus galima įjungti ar išjungti, keisti jų tvarką, pervadinti XML žymas ar CSV stulpelius, apgaubti reikšmes CDATA, praleisti tuščius laukus ir nustatyti fiksuotas reikšmes.

Filtruoti galima pagal kategorijas (su subkategorijomis), gamintojus, tik įjungtas prekes, tik prekes, kurių kiekis didesnis už nulį, minimalią ir maksimalią galutinę kainą, taip pat atmesti pasirinktus prekių ID ar modelius. Skirtuke Prices and data nustatoma kalba, valiuta, parduotuvė, PVM, akcijų kainos, procentinis kainos koeficientas, pristatymo kaina ir laikas, kiekio riba ir nuotraukų dydžiai. Valiuta ir PVM nustatomi kiekvienam srautui atskirai, todėl Jungtinei Karalystei skirtas Google Shopping srautas svarais su PVM ir kitos rinkos srautas gali naudoti tą patį katalogą.

Nuo 1.6 versijos modulis gali padaryti pavadinimus unikalius, nes tokie portalai kaip kainos.lt ir kaina24.lt vienodais pavadinimais pateiktus vienos parduotuvės pasiūlymus sujungia arba atmeta: pasikartojantis pavadinimas gauna modelio kodą skliaustuose arba MPN, SKU ar prekės ID. Pavadinimai neviršija šablono ribos (Google ir edrone – 150 simbolių, Facebook – 200, abiem portalams – 255), o keičiasi tik srautas: prekių pavadinimai parduotuvėje lieka tokie patys.

Srautas geras tiek, kiek geras už jo esantis katalogas: prekės, paliktos bendroje kategorijoje arba importuotos be prekės ženklų ir identifikatorių, į Google ir Meta patenka būtent tokios, todėl pirmiausia reikia tvarkingo kategorijų medžio ir išsamių tiekėjų duomenų.

Šios duomenų taisyklės galioja visiems formatams, nes būtent dėl tokių dalykų srautai dažniausiai atmetami:

• EAN/GTIN eksportuojamas tik tada, kai jį sudaro 8, 12, 13 arba 14 skaitmenų ir kontrolinis skaitmuo teisingas; 13 skaitmenų vidiniai parduotuvės kodai, prasidedantys 2, praleidžiami.
• Kiekis niekada nebūna neigiamas: prekė, kurios parduota daugiau nei buvo sandėlyje, eksportuojama su kiekiu 0.
• Pasirinktos sandėlio būsenos (pvz., „2-3 Days“) gali pažymėti neturimas prekes kaip prieinamas, o pristatymo dienos paimamos iš būsenos pavadinimo.

Kiekvienas naujas srauto failas pirmiausia įrašomas į laikiną failą ir patikrinamas, o tik tada pakeičia viešąjį. Jei patikra nepavyksta, internete lieka ankstesnis geras failas, o priežastis įrašoma į žurnalą, todėl Google Merchant Center ar portalas ir toliau gauna paskutinį gerą srautą, o ne tuščią.

Kiekvienas srautas turi du išvesties režimus. Dinaminis URL pateikia talpykloje laikomą failą ir jį perkuria užklausos metu, kai failas tampa senesnis už nustatytą šviežumo laiką (TTL). Statinis failas serveryje perkuriamas per cron arba mygtuku „Generate now“. Abu režimai gali papildomai sukurti .gz kopiją.

Generavimą galima paleisti per cron su PHP CLI komandomis (yra ir bandomasis režimas, kuris neliečia viešojo failo) arba per generavimo URL, jei prieglobos serveryje nėra komandinės eilutės prieigos; tikslios komandos rodomos administravimo skydelyje. Srautų URL apsaugoti atskirais kiekvieno srauto raktais, o bendru slaptuoju raktu galima sugeneruoti visus srautus iš karto.

Vienu metu vykdomas tik vienas to paties srauto generavimas, o lygiagreti užklausa žurnale pažymima kaip užimta.

Prieš pakeisdamas viešąjį failą, naujas failas turi praeiti šias patikras:

• jame yra bent viena prekė;
• prekių skaičius, palyginti su paskutiniu sėkmingu generavimu, nesumažėjo daugiau nei leidžiama (numatyta 30 %);
• XML taisyklingas – tai tikrinama, jei serveryje yra PHP XMLReader plėtinys (rekomenduojamas); be jo failas vis tiek įrašomas atomiškai, bet netikrinamas.

Apie tai praneša kasdienė patikra po 7:00. Ji pažymi kiekvieną OpenCart prekių srautą, kurio generavimas nepavyko, kuris niekada nebuvo sugeneruotas arba nebuvo atnaujintas ilgiau nei 36 valandas, taip pat daugiau nei 20 % sumažėjusį prekių skaičių ir generavimus, kurie, atrodo, užstrigo, o prie kiekvienos problemos nurodo, ką daryti. Patikrą paleidžia pirmas po 7:00 OpenCart sugeneruotas parduotuvės puslapis. Ataskaitą el. paštu galima gauti kasdien arba tik tada, kai yra klaidų ar naujų įspėjimų, o rezultatai saugomi 90 dienų.

Veiklos žurnale (Activity log) fiksuojamas kiekvienas generavimas: šaltinis (cron, cron URL, mygtukas administravime ar viešas URL), būsena, prekių skaičius, trukmė, failo dydis ir pranešimas. Pranešime nurodomi ir pokyčiai, palyginti su ankstesniu failu: pridėtos ir pašalintos prekės, kainų ir likučių pokyčiai bei pirmieji 20 pašalintų prekių ID. Kiekvienam srautui saugoma paskutinių 2000 įrašų.

Merchant Center praneša tik apie problemas faile, kurį atsisiuntė, o kasdienė patikra ir veiklos žurnalas parduotuvės pusėje parodo, kai srautas sustoja ar staiga netenka prekių.

Universal XML Feed Generator OpenCart Marketplace svetainėje kainuoja 59 USD, į kainą įeina 12 mėnesių nemokamas palaikymas. Pridedama dokumentacija, administravimo sąsaja – anglų kalba.

Srautai eksportuoja vieną įrašą vienai prekei: atskiri įrašai prekių pasirinkimams ar variantams nekuriami, todėl prekė, parduodama keliais dydžiais ar spalvomis kaip pasirinkimai, Google ir Meta platformose rodoma kaip vienas įrašas. Be to, kiekviena platforma – Merchant Center, Commerce Manager ar portalas – gali reikalauti ir savų papildomų prekių duomenų.

Jei reikia savos srauto struktūros ar pagalbos nustatant Merchant Center arba norite, kad modulį įdiegtume ir sukonfigūruotume mes, tai atliksime už jus; į užklausas atsakome per 24 darbo valandas. Tokio darbo pavyzdys – OpenCart parduotuvė, kurią sukūrėme pagal Figma dizainą.

Techniniai reikalavimai:

• OpenCart 3.0.x (OpenCart Marketplace svetainėje nurodytas suderinamumas – 3.x.x.x).
• PHP 7.4 ar naujesnė versija su XMLWriter plėtiniu; XML tikrinimui rekomenduojamas XMLReader.
• Neprivaloma: ZipArchive (visų srautų atsisiuntimas vienu ZIP), zlib (.gz failai), cURL (kasdienė patikra ne LiteSpeed / PHP-FPM serveriuose) ir cron prieiga.