Integrationer og API
Produktfeeds til Google og Meta
Feed-adresser pr. butik til Google Merchant Center og Meta Catalog, indstillingerne, vare-id ved flytning, og hvordan feedet caches.
Hver butik har et produktfeed, som Google Merchant Center og Meta Catalog henter.
Hvor: Storefronts › [butik] › Feeds.
| Modtager | Adresse |
|---|---|
| Google Merchant Center | https://<butikkens adresse>/api/feeds/google.xml |
| Meta Catalog (Facebook / Instagram) | https://<butikkens adresse>/api/feeds/meta.xml |
Meta-adressen giver samme indhold som Google-adressen. Copy kopierer en adresse, og Open åbner feedet.
Indhold
Feedet har én række pr. variant. Rækken har titel med mærket først, beskrivelse, link til produktsiden med rækkens variant valgt (?variant=), billeder, pris og udsalgspris, lagerstatus, varenummer, vægt og kategori.
- Beskrivelsen er produktets beskrivelse. Et produkt uden beskrivelse sender Short description, og et produkt uden begge sender titlen.
- Kun synlige, aktive produkter i en live-butik kommer med. En tjeneste kommer ikke med: Google Shopping og Meta tager varer. Heller ikke et produkt med Sold only as an add-on slået til, se Tilvalg.
- Lagerstatussen er butikkens:
in stock, når butikken sælger varianten,out of stock, når den ikke gør det. En variant med lagertilstanden Out of stock erout of stockuanset beholdning. I tilstanden Automatic tæller lageret over lagergrænsen. In stock (manual) og Preorder erin stock. Et produkt uden varianter erin stock. Se Lager. - Linket åbner rækkens variant, også når den er udsolgt. Siden viser så variantens pris og "Out of stock" ("Slut i lager" i en butik på svensk), og knappen kan ikke trykkes på.
- Priserne er i butikkens standardvaluta. Tilføj
?currency=EURfor en anden aktiveret valuta. - Hvert link har også
?currency=med feedets valuta, for eksempel?variant=…¤cy=EUR. Produktsiden åbnes i den valuta, også når Merchant Center henter den uden cookies. Adresselinjen viser derefter adressen uden?currency=, og valutaen gælder på næste side. - Det gælder også feedet i standardvalutaen, så Google ser samme pris som i feedet. Hvordan butikken ellers vælger valuta, står i Basisvaluta og flere valutaer.
- Produktsidens kanoniske adresse har hverken
?variant=eller?currency=. - Fragt står ikke i feedet. Angiv fragten i Merchant Centers kontoindstillinger.
Feedet angiver en prisnedsættelse på samme måde som butikken. Det sender aldrig førprisen.
| Varen i butikken | g:price | g:sale_price |
|---|---|---|
| Vises som nedsat | Den laveste pris i de 30 dage før nedsættelsen | Prisen i butikken |
| Vises ikke som nedsat | Prisen i butikken | Sendes ikke |
Butikken viser ikke varen som nedsat, når prishistorikken ikke dækker de 30 dage. Det gør den heller ikke, når prisen var lige så lav i dem. Se Laveste pris før en prisnedsættelse.
Indstillinger
| Indstilling | Hvad den gør | Standard |
|---|---|---|
| Brand for products without a vendor (g:brand) | Mærket for et produkt uden leverandør. Tomt: rækken sendes uden g:brand og med identifier_exists=no. Butikkens navn bruges aldrig. | Tomt |
| Default Google product category | Googles kategoristi, for eksempel "Sporting Goods > Indoor Games > Table Tennis". Meta godkender de samme værdier. | Tomt |
| Google category per top-level category | En egen Google-kategori til en topkategori, for eksempel tøj. | Tomt |
| Low-stock threshold | Et lager fra 1 op til tallet giver rækken custom_label_0 = low_stock. | 3 |
| Item id (g:id) | Hvad vare-id'et i feedet består af. Se næste afsnit. | BunStack ids |
| Id prefix (optional) | Tekst foran id'et, for eksempel gla_ eller woocommerce_gpf_. | Tomt |
Under feltet tæller siden feedets rækker: med leverandøren som mærke, med mærket i feltet og uden mærke. Skriv kun et mærke i feltet, hvis det er producenten af alle produkter uden leverandør. En række med mærke og SKU sender SKU'en som g:mpn og identifier_exists=yes.
Leverandøren sætter du på produktet under Organize › Vendor, eller på mange produkter på én gang med kolonnen vendor i CSV-importen.
Vare-id ved flytning
| Valg | Id i feedet |
|---|---|
| BunStack ids | Variantens id, eller produktets id for et produkt uden varianter. |
| Imported product id | Produktets source_id, id'et fra den butik, det blev importeret fra, for et produkt med én variant. Du sætter det med kolonnen source_id i CSV-importen. Varianter i et produkt med flere får deres SKU. |
| SKU | Hver variants SKU. |
En række, der mangler det valgte id, får BunStack-id'et. Har to rækker samme id, får den anden BunStack-id'et, fordi g:id skal være unikt.
GA4-hændelsernes item_id følger det samme valg og præfiks, se Sporing og Google Tag Manager.
Advarsel: Merchant Center og Meta gemmer en vares historik under dens id. Et nyt id gør varen ny der. Sammenlign nogle rækker i det gamle feed med feedet her, før du skifter adresse i Merchant Center. Vælg det id og præfiks, der giver de samme værdier.
Cache og fejl
- Feedet caches i 1 time.
- Ved fejl svarer feedet med HTTP 502, aldrig med en tom fil. Google beholder så den seneste hentning.