Integraatiot ja API
Tuotesyötteet Googlelle ja Metalle
Kauppakohtaiset syöteosoitteet Google Merchant Centerille ja Meta Catalogille, asetukset, tuotetunnus siirron yhteydessä ja syötteen välimuisti.
Jokaisella kaupalla on tuotesyöte, jonka Google Merchant Center ja Meta Catalog hakevat.
Missä: Storefronts › [kauppa] › Feeds.
| Vastaanottaja | Osoite |
|---|---|
| Google Merchant Center | https://<kaupan osoite>/api/feeds/google.xml |
| Meta Catalog (Facebook / Instagram) | https://<kaupan osoite>/api/feeds/meta.xml |
Meta-osoite antaa saman sisällön kuin Google-osoite. Copy kopioi osoitteen, ja Open avaa syötteen.
Sisältö
Syötteessä on yksi rivi varianttia kohti. Rivillä on otsikko tuotemerkki ensin, kuvaus, linkki tuotesivulle rivin variantti valittuna (?variant=), kuvat, hinta ja alennushinta, varastotila, tuotenumero, paino ja kategoria.
- Kuvaus on tuotteen kuvaus. Tuote ilman kuvausta lähettää kentän Short description, ja tuote ilman kumpaakaan lähettää otsikon.
- Mukana ovat vain live-kaupan näkyvät, aktiiviset tuotteet. Palvelu ei ole mukana: Google Shopping ja Meta ovat tavaroita varten. Ei myöskään tuote, jolla Sold only as an add-on on päällä, katso Lisävalinnat.
- Varastotila on kaupan oma:
in stock, kun kauppa myy variantin,out of stock, kun se ei myy. Variantti, jonka myyntitila on Out of stock, onout of stocksaldosta riippumatta. Myyntitilassa Automatic lasketaan varastorajan ylittävä saldo. In stock (manual) ja Preorder ovatin stock. Tuote ilman variantteja onin stock. Katso Varasto. - Linkki avaa rivin variantin silloinkin, kun se on loppunut. Sivu näyttää silloin variantin hinnan ja "Out of stock" ("Slut i lager" ruotsinkielisessä kaupassa), eikä painiketta voi painaa.
- Hinnat ovat kaupan oletusvaluutassa. Lisää
?currency=EURtoiselle käytössä olevalle valuutalle. - Jokaisessa linkissä on myös
?currency=syötteen valuutalla, esimerkiksi?variant=…¤cy=EUR. Tuotesivu avautuu siinä valuutassa, myös kun Merchant Center hakee sen ilman evästeitä. Osoiterivillä näkyy sen jälkeen osoite ilman?currency=-parametria, ja valuutta pätee seuraavalla sivulla. - Sama koskee oletusvaluutan syötettä, joten Google näkee saman hinnan kuin syötteessä. Miten kauppa muuten valitsee valuutan: Perusvaluutta ja lisävaluutat.
- Tuotesivun kanonisessa osoitteessa ei ole
?variant=- eikä?currency=-parametria. - Rahti ei ole syötteessä. Määritä rahti Merchant Centerin tiliasetuksissa.
Syöte ilmoittaa hinnanalennuksen samalla tavalla kuin kauppa. Se ei koskaan lähetä vertailuhintaa.
| Tuote kaupassa | g:price | g:sale_price |
|---|---|---|
| Näytetään alennettuna | Alin hinta alennusta edeltäneiden 30 päivän ajalta | Hinta kaupassa |
| Ei näytetä alennettuna | Hinta kaupassa | Ei lähetetä |
Kauppa ei näytä tuotetta alennettuna, kun hintahistoria ei kata 30 päivää. Se ei näytä sitä alennettuna myöskään, kun hinta oli yhtä alhainen niiden aikana. Katso Alin hinta ennen hinnanalennusta.
Asetukset
| Asetus | Mitä se tekee | Oletus |
|---|---|---|
| Brand for products without a vendor (g:brand) | Tuotemerkki tuotteelle, jolla ei ole toimittajaa. Tyhjä: rivi lähetetään ilman g:brand-kenttää ja arvolla identifier_exists=no. Kaupan nimeä ei koskaan käytetä. | Tyhjä |
| Default Google product category | Googlen kategoriapolku, esimerkiksi "Sporting Goods > Indoor Games > Table Tennis". Meta hyväksyy samat arvot. | Tyhjä |
| Google category per top-level category | Oma Google-kategoria pääkategorialle, esimerkiksi vaatteille. | Tyhjä |
| Low-stock threshold | Varasto 1:stä lukuun asti antaa riville custom_label_0 = low_stock. | 3 |
| Item id (g:id) | Mistä syötteen tuotetunnus muodostuu. Katso seuraava osio. | BunStack ids |
| Id prefix (optional) | Teksti tunnuksen eteen, esimerkiksi gla_ tai woocommerce_gpf_. | Tyhjä |
Kentän alla sivu laskee syötteen rivit: toimittaja tuotemerkkinä, kentän tuotemerkki ja ilman tuotemerkkiä. Kirjoita kenttään tuotemerkki vain, jos se on kaikkien toimittajattomien tuotteiden valmistaja. Rivi, jolla on tuotemerkki ja SKU, lähettää SKU:n kenttänä g:mpn ja arvon identifier_exists=yes.
Toimittajan asetat tuotteelle kohdassa Organize › Vendor tai monelle tuotteelle kerralla CSV-tuonnin sarakkeella vendor.
Tuotetunnus siirron yhteydessä
| Valinta | Tunnus syötteessä |
|---|---|
| BunStack ids | Variantin tunnus, tai tuotteen tunnus tuotteelle, jolla ei ole variantteja. |
| Imported product id | Tuotteen source_id, sen tunnus kaupassa, josta se tuotiin, tuotteelle jolla on yksi variantti. Asetat sen CSV-tuonnin sarakkeella source_id. Usean variantin tuotteen variantit saavat SKU:nsa. |
| SKU | Jokaisen variantin SKU. |
Rivi, jolta valittu tunnus puuttuu, saa BunStack-tunnuksen. Jos kahdella rivillä on sama tunnus, jälkimmäinen saa BunStack-tunnuksen, koska g:id:n on oltava yksilöllinen.
GA4-tapahtumien item_id noudattaa samaa valintaa ja etuliitettä, katso Seuranta ja Google Tag Manager.
Varoitus: Merchant Center ja Meta tallentavat tuotteen historian sen tunnuksen alle. Uusi tunnus tekee tuotteesta siellä uuden. Vertaa muutamaa vanhan syötteen riviä tämän syötteen riveihin ennen kuin vaihdat osoitteen Merchant Centerissä. Valitse tunnus ja etuliite, jotka antavat samat arvot.
Välimuisti ja virheet
- Syöte on välimuistissa 1 tunnin.
- Virhetilanteessa syöte vastaa HTTP 502, ei koskaan tyhjällä tiedostolla. Google säilyttää silloin viimeisimmän haun.