Takaisin kaikkiin oppaisiin

Synkronoinnin testaaja ja Google Sheets -tiedoston rakenne

Synkronoinnin testaaja tarkistaa, onko Google Sheets -tuotetiedostolla oikea rakenne, ja näyttää, miten B2BLIX käsittelisi pienen määrän tuotteita. Se luo testituloksen XML-muodossa julkaisematta hintoja suoraan markkinapaikkaan.

Mihin synkronoinnin testaajaa käytetään

Synkronoinnin testaaja on valmistelutyökalu myyjille, jotka haluavat tarkistaa tuotetiedostonsa ennen säännöllisen synkronoinnin määrittämistä.

Voit luoda pienen Google Sheets -tiedoston, joka sisältää todellisia tai edustavia tuotteita, lähettää sen URL-osoitteen ja suorittaa BuyBox-laskennan kerran. B2BLIX lukee lähetetyt tuotetiedot, käyttää saatavilla olevia löydettyjä markkinapaikkatietoja ja määrittämiäsi BuyBox-sääntöjä sekä valmistelee XML-tiedoston lasketuilla tuloksilla.

Tämä sivu on erityisen hyödyllinen, kun haluat:

  • Varmistaa sarakkeiden oikeat nimet ja tiedoston rakenteen.
  • Ymmärtää, mitä kukin tuettu tuotetieto tarkoittaa.
  • Testata yleisiä ja markkinapaikkakohtaisia hintoja.
  • Tarkistaa vähimmäis- ja enimmäishintarajat.
  • Testata poissulkemissääntöjä tai poikkeuksellisia tuotetilanteita.
  • Tarkistaa XML-tuloksen ennen säännöllisen synkronoinnin määrittämistä.

Synkronoinnin testaajaa käytetään yleensä ennen lopullisen tuotetietolähteen lisäämistä kohdassa Synkronointiasetukset. Kun säännöllinen synkronointi on määritetty ja toimii, testaajaa tulee käyttää vain erityistä varovaisuutta noudattaen.

Tärkeää: Testin suorittaminen ei lähetä hintoja suoraan palveluihin Pigu, 220.lv, Kaup24.ee tai HobbyHall.fi. Testi voi kuitenkin päivittää luodun julkisen XML-tiedoston samassa kiinteässä URL-osoitteessa. Älä suorita testiä, jos kyseinen XML-URL-osoite on yhdistetty toimivaan markkinapaikkaan tai muuhun järjestelmään, sillä yhdistetty järjestelmä saattaa vastaanottaa väliaikaiset testitiedot.

Synkronoinnin testaajan sivu, jossa näkyvät Google Sheets -URL-kenttä, Discount Mode -valitsin, esimerkkitaulukon painike ja tuettujen määritteiden taulukko
Synkronoinnin testaajan käyttöliittymä näyttää, mihin Google Sheets -URL-osoite syötetään, miten Discount Mode otetaan käyttöön, mistä esimerkkiasiakirja avataan ja mitä tuotemääritteitä tuetaan.

Mitä tällä sivulla voi tehdä

  • Avata odotetun rakenteen sisältävän Google Sheets -viitetaulukon.
  • Syöttää oman Google Sheets -tuotetiedostosi URL-osoitteen.
  • Valita, miten alkuperäiset ja lasketut hinnat näytetään XML-tulosteessa.
  • Tarkistaa hyväksytyt kenttien nimet ja vaihtoehtoiset sarakenimet.
  • Suorittaa kertaluonteisen synkronointitestin.
  • Luoda XML-tiedoston, joka sisältää käsitellyt tuotteet ja lasketut hinnat.
  • Tarkistaa luotu tulos synkronoinnin raportointiprosessissa.

Testi suorittaa todellisen laskentamenettelyn, mutta laskettu tai viety hinta ei ole automaattisesti toimiva markkinapaikkahinta. Hinta muuttuu toimivaksi vasta, jos ulkoinen integraatio käyttää luotua tulostetta ja markkinapaikka hyväksyy ja ottaa sen käyttöön.

Tärkeimmät kentät ja säätimet

Kenttä tai säädin Mitä se tarkoittaa Milloin sitä käytetään
Google Sheets URL Sen Google Sheets -asiakirjan osoite, joka sisältää testattavat tuotteet. Liitä URL-osoite sen jälkeen, kun olet valmistellut taulukon tuetuilla sarakenimillä. Varmista, että B2BLIX voi käyttää asiakirjaa annetun URL-osoitteen kautta.
Discount Mode Määrittää, miten lähetetty ja laskettu hinta esitetään XML-tulosteessa. Ota käyttöön, kun haluat XML:n säilyttävän lähetetyn hinnan alkuperäisenä hintana ja näyttävän lasketun hinnan alennettuna hintana.
Open example: Google Sheets Avaa odotetun rakenteen sisältävän viitetaulukon. Käytä ennen oman asiakirjan luomista tai tarkistaessasi sarakkeiden oikeinkirjoitusta ja järjestystä.
Attribute table Luettelee hyväksytyn pääkentän nimen, tuetut vaihtoehdot ja lyhyen kuvauksen. Käytä sitä nimetessäsi Google Sheets -asiakirjan sarakkeita.
Run test Lukee lähetetyn taulukon, käsittelee sen tuotteet, soveltaa käytettävissä olevia BuyBox-asetuksia ja luo testituloksen. Käytä tarkistettuasi lähde-URL-osoitteen, tuotetunnisteet, hinnat, rajat ja alueelliset arvot.

Google Sheets -asiakirjan valmistelu

Käytä jokaista tuotetta varten yhtä riviä. Ensimmäisellä rivillä tulee olla tuettujen määritteiden nimet.

Testaaja hyväksyy sivulla näytetyt päämääritteiden nimet sekä joidenkin kenttien vaihtoehtoiset nimet. Käytä kirjoitusasua täsmälleen siinä muodossa kuin se on esitetty. Älä lisää välilyöntejä tai muuta alaviivoja ja yhdysmerkkejä, ellei juuri kyseistä vaihtoehtoa ole lueteltu.

Sivulla ei merkitä kaikkia mahdollisia sarakkeita pakollisiksi. Käytännössä EAN tai GTIN on tärkein tuotteen yhdistämiseen käytettävä arvo. Lisää muut kentät, joita tarvitset testaamasi tilanteen mukaan.

Tuotetunnisteen tulee viitata tuotteeseen, joka on myyjän markkinapaikkalistauksissa ja jonka B2BLIX on löytänyt. Tuntematon tai virheellinen EAN voi estää tuotteen yhdistämisen saatavilla oleviin markkinapaikkatietoihin.

Markkinapaikkojen päätetunnisteet

Useat kenttäryhmät tukevat sekä yleistä arvoa että tietylle markkinapaikalle tarkoitettua arvoa. Markkinapaikka ilmaistaan sarakkeen nimen lopussa olevalla päätetunnisteella.

Päätetunniste Markkinapaikka Esimerkkikenttä
_lv 220.lv Latviassa price_lv
_lt Pigu.lt Liettuassa price_lt
_ee Kaup24.ee Virossa price_ee
_fi HobbyHall.fi Suomessa price_fi

Yleisten ja markkinapaikkakohtaisten arvojen toiminta

Kenttä ilman markkinapaikan päätetunnistetta toimii kaikkien tuettujen markkinapaikkojen yleisenä arvona. Markkinapaikkakohtainen kenttä ohittaa yleisen arvon vain omalla markkinapaikallaan.

Oletetaan esimerkiksi, että tuotteen rivillä ovat seuraavat arvot:

Sarake Arvo
price 100
price_lv 90

Lähetetyt voimassa olevat hinnat ovat:

  • Latvia: 90, koska price_lv ohittaa yleisen arvon.
  • Liettua: 100, kentästä price.
  • Viro: 100, kentästä price.
  • Suomi: 100, kentästä price.

Sama periaate koskee seuraavia:

  • Nouto- tai toimitustunnit.
  • Hinnat ennen alennusta.
  • Hinnat alennuksen jälkeen.
  • Sallitut vähimmäishinnat.
  • Sallitut enimmäishinnat.

Sinun ei tarvitse toistaa samaa arvoa kaikkien neljän markkinapaikan sarakkeissa. Syötä yleinen arvo ja lisää vain toisistaan poikkeavat alueelliset poikkeukset.

Tuotteen tunnistetietokentät

Määrite Hyväksytty vaihtoehto Merkitys ja käyttö
ean gtin

Tärkein tuotetunniste, jolla lähetetty rivi yhdistetään markkinapaikan tuotteeseen.

EAN:n tulee kuulua tuotteelle, joka on saatavilla myyjän Pigu Group -listauksissa ja B2BLIX:n tiedossa.
sku sku

Myyjän Stock Keeping Unit -tunniste.

Se voi toimia tuotteen lisäviitteenä tai vahvistusarvona. Se ei korvaa EAN:ia, kun tuotteiden yhdistäminen edellyttää EAN-pohjaista tunnistusta.

Varastokenttä

Määrite Hyväksytty vaihtoehto Merkitys ja käyttö
stock stock

Saatavilla oleva tuotemäärä.

Syötä se kokonaislukuna, kuten 0, 3 tai 25. Kun valittu XML- tai API-prosessi sisältää varastotiedot, B2BLIX käyttää lähetettyä määrää tulosteessa.

Arvo 0 tarkoittaa, ettei tuotteita ole tällä hetkellä saatavilla. Tarkista varastoarvot huolellisesti, kun testaat tulostetta, jonka toinen järjestelmä voi lukea.

Nouto- ja toimitustuntien kentät

Nämä kentät kuvaavat tuotteen toimitus- tai noutoaikaa tuetuilla markkinapaikoilla.

Määrite Hyväksytty vaihtoehto Koskee
collectionhours collection_hours Kaikkien markkinapaikkojen yleinen arvo, ellei sitä ohiteta.
collectionhours_lv collection_hours_lv Vain Latvia.
collectionhours_lt collection_hours_lt Vain Liettua.
collectionhours_ee collection_hours_ee Vain Viro.
collectionhours_fi collection_hours_fi Vain Suomi.

Käytä yleistä kenttää, kun toimitusaika on sama kaikilla markkinoilla. Lisää markkinapaikkakohtainen kenttä, kun jonkin maan toimitusaika poikkeaa muista.

Ennen alennusta olevien hintojen kentät

Näissä kentissä ilmoitetaan lähetetty tuotteen hinta ennen alennusten soveltamista. Yleistä arvoa käytetään kaikilla markkinapaikoilla, ellei aluekohtaista arvoa ole annettu.

Määrite Hyväksytyt vaihtoehdot Koskee
price price_before_discount, price-before-discount Kaikkien markkinapaikkojen yleinen hinta, ellei sitä ohiteta.
price_lv price_before_discount_lv, price-before-discount-lv Vain Latvia.
price_lt price_before_discount_lt, price-before-discount-lt Vain Liettua.
price_ee price_before_discount_ee, price-before-discount-ee Vain Viro.
price_fi price_before_discount_fi, price-before-discount-fi Vain Suomi.

Tämä lähetetty hinta on syötetieto. Se ei välttämättä ole lopullinen suositeltu hinta, koska B2BLIX voi soveltaa määritettyä hinnoittelustrategiaa ja turvarajoja testin aikana.

Alennuksen jälkeisten hintojen kentät

Nämä kentät edustavat tuotteelle lähetettyä alennettua hintaa. Ne määrittävät myös, miten hintatietoja tulkitaan Discount Mode -tilaa käytettäessä.

Määrite Hyväksytyt vaihtoehdot Koskee
price_after_discount price_after_discount, price-after-discount Yleinen alennettu hinta, ellei sitä ohiteta.
price_after_discount_lv price_after_discount_lv, price-after-discount-lv Vain Latvia.
price_after_discount_lt price_after_discount_lt, price-after-discount-lt Vain Liettua.
price_after_discount_ee price_after_discount_ee, price-after-discount-ee Vain Viro.
price_after_discount_fi price_after_discount_fi, price-after-discount-fi Vain Suomi.

Vähimmäishinnan kentät

Vähimmäishinta on tuotteen alin sallittu hinta. Se suojaa myyjää siltä, ettei laskettu hinta laske määritettyä rajaa alemmas.

Määrite Merkitys
min Kaikkien markkinapaikkojen yleinen vähimmäishinta, ellei sitä ohiteta.
min_lv Latvian alin sallittu hinta.
min_lt Liettuan alin sallittu hinta.
min_ee Viron alin sallittu hinta.
min_fi Suomen alin sallittu hinta.

Hintaturvallisuus: Tarkista jokainen vähimmäishinta ennen testin suorittamista. Tuotekohtaiset vähimmäisarvot ovat tärkeitä turvarajoja ja voivat vaikuttaa laskettuun tulokseen kullakin markkinapaikalla.

Enimmäishinnan kentät

Enimmäishinta on tuotteen korkein sallittu hinta. Se rajoittaa sitä, kuinka paljon laskettua hintaa voidaan korottaa.

Määrite Merkitys
max Kaikkien markkinapaikkojen yleinen enimmäishinta, ellei sitä ohiteta.
max_lv Latvian korkein sallittu hinta.
max_lt Liettuan korkein sallittu hinta.
max_ee Viron korkein sallittu hinta.
max_fi Suomen korkein sallittu hinta.

Tarkista, että vähimmäis- ja enimmäisarvot muodostavat järkevän sallitun vaihteluvälin. Testaaja käyttää näitä rajoja yhdessä määritettyjen BuyBox-sääntöjen kanssa valmistellessaan laskettuja hintoja.

Miten Discount Mode muuttaa XML-tulostetta

Discount Mode ei ota BuyBox-laskentaa käyttöön eikä poista sitä käytöstä. Se muuttaa tapaa, jolla alkuperäinen lähetetty hinta ja laskettu hinta sijoitetaan XML:n hintakenttiin.

Discount Mode Hinta ennen alennusta Hinta alennuksen jälkeen
Käytössä Lähdetiedostossa lähetetty alkuperäinen hinta. B2BLIX:n laskema hinta.
Ei käytössä B2BLIX:n laskema hinta. B2BLIX:n laskema hinta.

Ota Discount Mode käyttöön, kun vastaanottavan järjestelmän tulee nähdä sekä alkuperäinen hinta että alempi tai muulla tavalla muokattu laskettu hinta. Jätä se pois käytöstä, kun molempien XML-hintakenttien tulee sisältää laskettu arvo.

Mitä tapahtuu, kun napsautat Run test

Testaaja suorittaa kertaluonteisen synkronointiprosessin:

  1. B2BLIX avaa lähetetyn Google Sheets -asiakirjan.
  2. Tuoterivit ja tuetut kentät luetaan.
  3. Tuotteet yhdistetään saatavilla olevien tunnisteiden, ensisijaisesti EAN:n tai GTIN:n, avulla.
  4. Laskennassa käytetään saatavilla olevia löydettyjä markkinapaikkatietoja.
  5. Määritettyjä BuyBox-sääntöjä, poissulkemisia ja hintarajoja sovelletaan tarvittaessa.
  6. Käsitellyistä tuotetiedoista ja lasketuista hinnoista luodaan XML-tulos.
  7. Tulos voidaan tarkistaa synkronoinnin raportointiprosessissa.

Markkinapaikka päättää edelleen, mikä myyjä saa BuyBoxin. Testitulos näyttää B2BLIX:n laskelman; se ei takaa BuyBox-sijaintia, tilausta, liikevaihtoa tai voittoa.

Luodun XML:n tulkitseminen

XML ryhmittelee lähetetyt rivit yksittäisiksi tuotteiksi. Kukin tuote voi sisältää tunnisteen, SKU:n, varaston sekä erilliset hintakentät Latvialle, Liettualle, Virolle ja Suomelle.

Tulos voi esimerkiksi sisältää erilliset elementit seuraaville:

  • Tuotteen GTIN.
  • Myyjän SKU.
  • Lähetetty varastomäärä.
  • Hinta ennen alennusta kullakin markkinapaikalla.
  • Laskettu hinta alennuksen jälkeen kullakin markkinapaikalla.
Esimerkki luodusta XML:stä, jossa on kolme tuotetta, GTIN, SKU, varasto sekä markkinapaikkakohtaiset hinnat ennen alennusta ja alennuksen jälkeen
Esimerkki näyttää luodun XML-tuloksen rakenteen. Jokaisella tuotteella on oma tunnisteensa ja erilliset hintakentät Latvialle, Liettualle, Virolle ja Suomelle.

XML on tulostiedosto. Se tulee tarkistaa ennen kuin sen julkinen URL-osoite yhdistetään markkinapaikkaan tai muuhun tuotantojärjestelmään.

Suositeltu turvallinen työprosessi

  1. Avaa esimerkin Google Sheets -asiakirja.
  2. Luo erillinen testitaulukko koko tuotantolähteen käyttämisen sijaan.
  3. Lisää pieni määrä tuotteita, joiden EAN:t tunnet.
  4. Varmista, että tuotteet ovat jo markkinapaikkalistauksissasi ja että B2BLIX on löytänyt ne.
  5. Lisää nykyinen hinta, varasto ja tarvittavat toimitustiedot.
  6. Lisää huolellisesti tarkistetut vähimmäis- ja enimmäishinnat.
  7. Käytä yleisiä arvoja kaikilla markkinoilla ja lisää alueelliset sarakkeet vain poikkeuksia varten.
  8. Valitse sopiva Discount Mode.
  9. Varmista, ettei julkinen XML-testin URL-osoite ole yhdistetty toimivaan kohteeseen.
  10. Suorita testi ja tarkista luotu XML.
  11. Vertaa tulostetta lähdearvoihin ja määritettyihin BuyBox-sääntöihin.
  12. Kun testi on onnistunut, määritä varsinainen lähde ja tuloste kohdassa Synkronointiasetukset.

Yleiset virheet

  • Testaajan suorittaminen, kun luotu XML on toimivan integraation käytössä. Väliaikaiset testituotteet ja -hinnat voivat korvata sisällön, jonka integraatio lukee.
  • Sellaisen EAN:n käyttäminen, jota ei ole listattu tai löydetty. B2BLIX ei välttämättä pysty yhdistämään riviä odotettuihin markkinapaikkatuotetietoihin.
  • Sarakkeen kirjoitusasun muuttaminen. Käytä päämääritteen nimeä tai jotakin luetelluista vaihtoehdoista täsmälleen sellaisena kuin se on ilmoitettu.
  • Yleisen arvon odottaminen alueellisen arvon ohittavan. Latvialla esimerkiksi price_lv on etusijalla price-kenttään nähden.
  • Varaston syöttäminen tekstinä tai desimaaliarvona. Varasto tulee ilmoittaa kokonaislukuna.
  • Tarkistamattomien vähimmäis- ja enimmäishintojen käyttäminen. Virheelliset rajat voivat tuottaa tuloksia, jotka eivät vastaa myyjän tavoittelemaa hinnoitteluväliä.
  • Discount Mode -tilan ymmärtäminen väärin. Se muuttaa alkuperäisten ja laskettujen hintojen esitystapaa XML:ssä; se ei julkaise alennusta itsestään.
  • Luodun XML:n olettaminen heti toimivaksi. Tulostetta ei julkaista markkinapaikkaan, ellei jokin muu määritetty järjestelmä lue ja ota sitä käyttöön.
  • Koko luettelon testaaminen heti. Aloita muutamasta edustavasta tuotteesta, jotta lähdetiedot ja lasketut tulokset on helpompi tarkistaa.

Esimerkkikäyttötapaus

Myyjä haluaa testata yhtä tuotetta, jota tarjotaan kaikilla neljällä markkinapaikalla. Normaali lähetetty hinta on 100, mutta Latvian hinnan tulee olla 90. Sallittu hintaväli on 80–120.

Sarake Esimerkkipuut Tarkoitus
ean 123456789 Yhdistää rivin B2BLIX:n tuntemaan tuotteeseen.
sku TEST-001 Antaa myyjän sisäisen tuotetunnisteen.
stock 5 Asettaa saatavilla olevan määrän testitulosteeseen.
price 100 Asettaa yleisen lähetetyn hinnan.
price_lv 90 Ohittaa yleisen hinnan Latviassa.
min 80 Asettaa yleisen alimman sallitun hinnan.
max 120 Asettaa yleisen korkeimman sallitun hinnan.

Testin aikana Latvia käyttää lähtökohtana lähetettyä aluekohtaista arvoa 90. Liettua, Viro ja Suomi käyttävät yleistä arvoa 100. Tämän jälkeen B2BLIX arvioi tuotteen määritettyjen BuyBox-sääntöjen avulla ja pitää kunkin lasketun tuloksen sovellettavien vähimmäis- ja enimmäisrajojen sisällä.

Myyjä voi tarkistaa tuloksena syntyvän XML:n, varmistaa, että Latvian ohitusarvoa käytettiin oikein, ja tarkistaa, että ehdotetut hinnat pysyvät tavoitellun vaihteluvälin sisällä ennen tuotetietolähteen siirtämistä säännölliseen synkronointiin.