Byg dine egne feeds

Hvad er custom feeds?

Custom feeds giver dig mulighed for at bygge dine egne datafiler med produktinformation i CSV-, XML- eller JSON-format. Du bestemmer selv hvilke felter der skal med, hvordan de navngives, og hvilke produkter der inkluderes. Det er ideelt til integration med eksterne systemer, prissammenligningssider, affiliate-netværk eller andre tjenester der kræver produktdata i et bestemt format.

Du finder funktionen under Produkter → Produktfeeds i admin.

Opret et nyt feed

1. Gå til Produkter → Produktfeeds.
2. Klik Opret nyt feed.
3. Giv dit feed et navn og vælg format: XML, JSON eller CSV. Formatet kan ikke ændres efter oprettelse.
4. Klik Opret feed. Du sendes til redigeringssiden.

Redigér dit feed

På redigeringssiden kan du konfigurere alle aspekter af dit feed:

Generelt

• Navn — internt navn til at identificere feedet.
• Slug — den del af URL'en der bruges til at tilgå feedet (genereres automatisk fra navnet).
• Online/offline — om feedet er offentligt tilgængeligt.
• Udvid varianter — hvis aktiveret, får hver produktvariant sin egen række i feedet.

Vælg produkter (datakilde)

Du kan vælge hvilke produkter der skal med i feedet:

• Alle produkter — alle produkter i din webshop.
• Kategorier — kun produkter fra udvalgte kategorier.
• Landingssider — kun produkter på udvalgte landingssider.
• Produktlabels — kun produkter med bestemte labels.

Filtre

Du kan yderligere filtrere produkterne:

• Kan købes: udelader produkter der er udsolgt. Produkter der må sælges videre ved lagerstatus 0, bliver i feedet.
• Kun med billede: udelader produkter uden billeder.
• Kun med pris > 0: udelader produkter uden pris.

Produktfelter

Vælg hvilke felter der skal med i dit feed. Du kan omdøbe felterne så de passer til modtagerens krav. Træk i rækkerne for at ændre rækkefølgen.

Tilgængelige felter inkluderer:

• Produkt-ID, varenummer (SKU), GTIN, MPN — produktidentifikation.
• Navn, beskrivelse (HTML og ren tekst) — produkttekster.
• Pris (før rabat), aktuel pris, tilbudspris — prisoplysninger. Salgspriser leveres altid inklusive moms, hvilket også står i feltnavnet.
• Produkt-URL, billed-URL, alle billed-URL'er — links og billeder.
• Brand, leverandør, kategorier — klassificering.
• Lagerstatus, lagerantal, vægt — lager og fragt.
• Relaterede og lignende produkt-ID'er og SKU'er — produktrelationer.
• Kostpris (uden moms) — din indkøbspris. Ligger under Interne felter i feltvælgeren, fordi den er fortrolig. Læs afsnittet om kostpriser længere nede, inden du bruger den.
• Produktegenskaber — dine egne profil-egenskaber, fx sæson, farve, materiale eller køn. De står i feltvælgeren med de navne, du selv har givet dem.
• Ekstrafelter — de ekstrafelter, du har udfyldt på dine produkter. Shoporama foreslår automatisk de felter, der findes på dine varer, og du kan altid skrive et feltnavn selv, hvis et felt mangler i listen.

Hvis du aktiverer Udvid varianter, får du desuden adgang til variant-specifikke felter som variant-SKU, variant-GTIN, variant-pris og variant-lagerantal.

Globale felter (kun XML og JSON)

For XML- og JSON-feeds kan du tilføje globale felter der vises på rodniveau:

• Shop-URL, shopnavn, valuta, sprog — webshop-information.
• Genereringstidspunkt, antal produkter — feed-metadata.
• Brugerdefineret værdi — fritekst du selv angiver.

Formatindstillinger

• XML: Rodelement-navn (standard: products), element-navn (standard: product), XML-namespaces (fx til Google Shopping-format med g:-præfiks), og CDATA til HTML-felter.
• CSV: Separator (; eller ,) og om headerrækken skal inkluderes.
• JSON: Bruger automatisk pæn formatering med unicode-support.

Feed-URL og adgang

Når dit feed er online, er det tilgængeligt via en offentlig adresse:

https://dinshop.dk/feed/dit-feed.xml
https://dinshop.dk/feed/dit-feed.json
https://dinshop.dk/feed/dit-feed.csv

I feltet Feed URL til højre på siden står der, hvem der kan hente feedet. Klik Skift for at vælge mellem tre muligheder:

• Åben for alle — alle der kender adressen, kan hente feedet. Fint til almindelige produktdata.
• Hemmelig URL — Shoporama lægger en lang, tilfældig nøgle ind i adressen, så den ikke kan gættes. Uden den korrekte adresse svares der 404. Det er den nemmeste løsning, og den virker i alle feedværktøjer.
• Brugernavn og adgangskode — feedet kræver login, præcis som en beskyttet side. Det er den sikreste løsning, og den understøttes af blandt andre Channable, Google Merchant Center og Meta.

Med en hemmelig URL ser adressen sådan ud:

https://dinshop.dk/feed/dit-feed-k7f3p9x2q4.xml

Vælger du adgangskode, genererer Shoporama den for dig, og du kan se og kopiere den samme sted. Du indtaster så feedets adresse, brugernavnet og adgangskoden i dit feedværktøj.

Byg og forhåndsvis

Brug knappen Byg feed nu for at generere feedet. Du kan også klikke Preview for at se resultatet med live data.

Feeds der er sat online genopbygges automatisk hver time, så dine produktdata altid er opdateret.

Sådan holdes feedet opdateret

Feed-URL'en henter ikke data i det øjeblik nogen åbner den. Den leverer den fil der blev skrevet, sidste gang feedet blev bygget. Derfor svarer et feed lynhurtigt, også når det indeholder titusindvis af produkter. Til gengæld er en ændring først synlig udadtil, når feedet er bygget igen.

Feedet bygges på to måder:

• Automatisk en gang i timen. Kørslen bygger alle feeds der står som Online. Den kører ikke nødvendigvis på det hele klokkeslæt, så regn med op til en times forsinkelse.
• Manuelt, når du selv beder om det. Se afsnittet nedenfor.

To ting er værd at holde fast i:

• At gemme er ikke det samme som at bygge. Når du gemmer nye felter, filtre, eller datakilder, gemmes opsætningen med det samme, men filen bag feed-URL'en er stadig den gamle, indtil feedet bygges igen.
• Den automatiske kørsel gælder kun shops der er sat live. Er din shop stadig en demo, bliver dine feeds ikke bygget automatisk. Du kan sagtens bygge dem manuelt og teste dem i mellemtiden.

Byg feedet manuelt

Du behøver ikke vente på den næste automatiske kørsel. Du kan bygge feedet to steder fra:

• På redigeringssiden ligger boksen Byg feed i højre side. Klik Byg feed nu, så bygges feedet med det samme.
• På oversigten sætter du flueben ud for et eller flere feeds og klikker Genopbyg valgte. Feedene bygges ét ad gangen, og knappen tæller op undervejs, fx 3/8.

Gem altid dine ændringer først. Begge knapper bygger ud fra den gemte opsætning, ikke ud fra det du netop har skrevet i formularen.

Byg manuelt når du:

• Lige har ændret felter, filtre, eller datakilder og vil se resultatet i den rigtige fil.
• Har opdateret priser eller lager på mange produkter og ikke vil vente en time.
• Skal sende feed-URL'en til en samarbejdspartner for første gang.

Kvitteringen på skærmen er ikke i sig selv bevis for at feedet blev bygget. Kig i stedet på tidspunktet under Sidst bygget. Er det ikke hoppet frem til lige nu, blev feedet ikke bygget, og så er årsagen næsten altid en af dem i fejlsøgningsafsnittet nedenfor.

Forhåndsvis feedet

Der er to forskellige forhåndsvisninger på redigeringssiden, og de svarer på hver sit spørgsmål.

Struktur-preview: ser opbygningen rigtig ud?

Under felt-tabellen ligger boksen Struktur-preview. Den viser skelettet af dit feed med dine egne tag-navne og nøgler, og med ... i stedet for rigtige produktdata. Den opdaterer sig selv mens du tilføjer, omdøber, eller flytter felter, og du behøver ikke gemme først.

Brug den til at holde opbygningen op mod den kravspecifikation du har fået fra modtageren: hedder felterne præcis det de skal, ligger de i den rigtige rækkefølge, og bliver felter med flere værdier, som billeder og kategorier, pakket ind som modtageren forventer?

Preview: er indholdet rigtigt?

Knappen Preview i boksen Byg feed åbner feedet i en ny fane med rigtige produktdata fra din shop. Det er den hurtigste måde at se om priserne er de rigtige, om billedadresserne virker, og om beskrivelserne ser fornuftige ud. Der er fire ting at vide om preview:

• Preview bygges på stedet og gemmes ikke. Det ændrer hverken filen bag feed-URL'en eller tidspunktet under Sidst bygget.
• Preview kræver at du er logget ind i admin. Linket virker derfor ikke for en partner eller et bureau. Send dem feed-URL'en i stedet.
• Preview bygger hele feedet i ét hug. Har du et stort katalog, kan fanen være længe om at svare. Den automatiske kørsel arbejder i mindre portioner og har ikke det problem.
• Preview viser altid den gemte opsætning og de aktuelle produktdata. Filen bag feed-URL'en følger først med, når feedet er bygget.

Små kosmetiske forskelle mellem preview og den byggede fil er normale. Rækkefølgen af produkter kan være en anden, og JSON-feeds er mere luftigt formateret i preview end i filen. Indholdet pr. produkt er det samme.

Se hvornår feedet sidst blev bygget

Svaret står under Sidst bygget, og det finder du to steder:

• På oversigten under Produkter → Produktfeeds har hvert feed en kolonne Sidst bygget med dato og klokkeslæt. Står der en bindestreg, er feedet aldrig blevet bygget.
• På redigeringssiden står det samme tidspunkt i boksen Byg feed. Er feedet aldrig bygget, står der i stedet Feedet er ikke bygget endnu.

Tidspunktet sættes først når feedet er bygget færdigt og filen er skrevet. Står et feed som online, og er tidspunktet mere end et par timer gammelt, er der noget galt.

Fejlsøgning: feedet opdaterer ikke

Start altid det samme sted: åbn feedet, notér tidspunktet under Sidst bygget, klik Byg feed nu, og se om tidspunktet flytter sig. Så ved du med det samme om feedet overhovedet bliver bygget, eller om det er indholdet der er galt.

Sidst bygget rykker sig ikke

Så nåede feedet aldrig at blive skrevet færdigt. De almindelige årsager er:

• Feedet har ingen felter. Et feed uden mindst ét felt bliver ikke bygget. Tilføj felterne, gem, og prøv igen.
• Ingen produkter matcher. Har du valgt en kategori, en landingsside, eller en produktlabel uden produkter i, er der ikke noget at bygge.
• Du har ikke gemt. Knappen bygger på den gemte opsætning. Klik Gem først, og byg så.

Hjælper det ikke, så skriv til support@shoporama.dk med navnet på feedet og din shops adresse.

Feedet svarer "Feed is being generated. Please try again later."

Svarer feed-URL'en sådan her, er feedet aldrig blevet bygget færdigt, og der findes derfor ingen fil at levere:

Feed is being generated. Please try again later.

Modtageren får en midlertidig fejl (HTTP 503) som de fleste feed-læsere selv prøver igen på lidt senere. Løsningen er at bygge feedet manuelt og derefter åbne URL'en igen.

Feed-URL'en giver 404

• Feedet står som Offline. Sæt det online, og byg det.
• Filendelsen passer ikke til formatet. Et XML-feed skal hentes som .xml, et JSON-feed som .json, og et CSV-feed som .csv.
• Slug'en er stavet forkert, eller den er blevet ændret siden du sendte adressen af sted. Kopiér adressen fra boksen Feed URL på redigeringssiden.
• Feedet er beskyttet med en feed-nøgle, og nøglen mangler i adressen. Uden den korrekte nøgle svarer feedet 404, også selvom det er online.

Produkter mangler i feedet

• Produktet er ikke online, eller det ligger i papirkurven. Kun produkter der er online, kommer med i et feed.
• Et filter sorterer det fra. Slå midlertidigt Kan købes, Kun med billede, og Kun med pris > 0 fra, byg igen, og se om produktet dukker op.
• Kategorien er valgt, men produktet ligger kun i en underkategori. Et produkt tæller kun med i de kategorier det er placeret direkte i, så vælg også underkategorierne i datakilden.
• Datakilden er en landingsside, og produktet er ikke med på den. Tjek listen på selve landingssiden.
• Du forventer en linje pr. variant. Slå Udvid varianter til, gem, og byg igen.

Prisen eller lagertallet er forældet

Feedet indeholder de tal der var gældende, da filen sidst blev bygget. Efter en prisopdatering, en kampagnestart, eller en varemodtagelse skal feedet bygges igen, før modtageren kan se ændringen. Haster det, så byg manuelt i stedet for at vente på den næste automatiske kørsel.

Preview ser rigtigt ud, men feedet gør ikke

Det er det klassiske tegn på at feedet ikke er bygget siden din ændring. Preview bygger på stedet, mens feed-URL'en leverer den senest byggede fil. Klik Byg feed nu, og tjek at tidspunktet under Sidst bygget flytter sig.

Feedet opdateres sjældnere end en gang i timen

Meget store feeds kan tage lang tid at bygge. Er en kørsel stadig i gang, når den næste skulle starte, springes den næste over, og feedene bliver først bygget i timen efter. Bliver det et fast mønster, kan du skære feedet til: fjern felter modtageren ikke bruger, sæt et filter på, eller byg flere mindre feeds i stedet for ét stort, fx opdelt på produktlabels.

Kostpriser i feedet

Du kan lægge din kostpris i feedet, fx hvis dit feedværktøj skal regne dækningsbidrag ud og byde derefter. Kostprisen er den, du har indtastet under Lager, Kostpriser, og den er uden moms. Salgspriserne i feedet er derimod inklusive moms, så husk at regne det med, hvis du sammenligner de to tal.

Har du ikke udfyldt en kostpris på en vare, står kolonnen tom. Den bliver ikke til et nul, så du kan se forskel på "gratis" og "ved ikke".

Tips

• Brug Preview-funktionen til at teste dit feed inden du deler URL'en.
• Slå adgangskode til, hvis feedet indeholder kostpriser eller andet fortroligt.
• XML med namespaces gør det nemt at lave Google Shopping-kompatible feeds.
• Med variant-udvidelse kan du lave feeds hvor hver variant har sin egen linje — nyttigt for prissammenligningssider.

Ofte stillede spørgsmål

Kan jeg beskytte mit feed med brugernavn og adgangskode?

Ja. Klik Skift ved Adgang i Feed URL-feltet og vælg Brugernavn og adgangskode. Shoporama laver adgangskoden for dig. Det kræver, at din webshop kører på https. De fleste feedværktøjer, blandt andre Channable, Google Merchant Center og Meta, har felter til brugernavn og adgangskode, når du opretter feedet hos dem.

Må jeg lægge mine indkøbspriser i et feed?

Ja, men beskyt feedet først. Vælger du kostpris i et åbent feed, advarer Shoporama dig med det samme. Har du allerede delt en åben feed-adresse, så slå adgangskode til og send den nye adresse til modtageren.

Jeg kan ikke finde et af mine ekstrafelter i listen. Hvad gør jeg?

Listen med ekstrafelter er et forslag baseret på dine nyeste varer, så et felt der kun findes på ældre varer, kan mangle. Du kan altid skrive feltnavnet selv i feltvælgeren, så virker det alligevel.

Hvorfor er min kolonne med en produktegenskab tom for nogle varer?

Produktegenskaber hører til den profil, varen bruger. Har en vare en anden profil, hvor egenskaben ikke findes, står kolonnen tom for netop den vare. Det er ikke en fejl i feedet.

Jeg har rettet i feedet og gemt, men filen min partner henter er uforandret. Hvad gør jeg?

Du mangler at bygge feedet. Når du gemmer, opdaterer du kun opsætningen. Åbn feedet, klik Byg feed nu, og tjek at tidspunktet under Sidst bygget hopper frem til nu. Derefter leverer feed-URL'en den nye version. Gør du ingenting, kommer ændringen med ved den næste automatiske kørsel inden for en time.

Hvor tit opdaterer feedet sig selv?

En gang i timen. Det gælder alle feeds der står som Online i en shop der er sat live. Er din shop stadig en demo, eller står feedet som Offline, sker der ingenting automatisk, og du skal selv klikke Byg feed nu.

Kan jeg få feedet til at bygge oftere end en gang i timen?

Ikke som en indstilling du selv kan sætte. Til gengæld kan du bygge manuelt så tit du vil, og det tager typisk få sekunder for et almindeligt katalog. Har du et forretningsbehov for hyppigere automatisk opdatering, så skriv til support@shoporama.dk, så kigger vi på det.

Kan jeg sende preview-linket til mit bureau?

Nej. Preview kræver at man er logget ind i din admin, så en ekstern modtager får bare login-siden. Send i stedet feed-URL'en fra boksen Feed URL. Den er lavet til at blive delt, og den leverer præcis de samme data.

Vi har mange feeds. Skal jeg bygge dem enkeltvis efter en stor prisopdatering?

Nej. Gå til Produkter → Produktfeeds, sæt flueben ud for de feeds det gælder, og klik Genopbyg valgte. De bygges ét ad gangen, og kolonnen Sidst bygget opdaterer sig undervejs, så du kan se hvilke der er færdige. Har du flere shops, skal du gentage det i hver shop. Skal du ikke bruge feedene her og nu, kan du roligt lade den automatiske kørsel klare det inden for en time.

Feedet viser varer vi ikke har på lager. Hvordan får jeg dem ud?

Sæt filteret Kan købes på feedet, gem, og byg. Bemærk at varer der må sælges videre ved lagerstatus 0, stadig kommer med, fordi kunden faktisk kan købe dem. Husk også at lagertallene i feedet stammer fra det tidspunkt hvor filen sidst blev bygget, så der kan gå op til en time fra en vare bliver udsolgt, til det er slået igennem i feedet.

Hvad betyder svaret "Feed is being generated. Please try again later."?

At feedet aldrig er blevet bygget færdigt, så der ikke er nogen fil at levere endnu. Det sker typisk lige efter oprettelsen, eller hvis feedet ikke har nogen felter. Tilføj mindst ét felt, gem, klik Byg feed nu, og prøv URL'en igen.

Kan jeg se en log over hvad der gik galt, hvis et feed ikke bliver bygget?

Ikke i admin. Det du kan se, er tidspunktet under Sidst bygget, og det er også det vigtigste: står det stille, blev feedet ikke bygget. Gå fejlsøgningslisten ovenfor igennem, og skriv til support@shoporama.dk hvis du står fast, så kigger vi på det.

Har du brug for hjælp til at få et feed til at passe med en bestemt modtager? Skriv til support@shoporama.dk. Skal du bruge et færdigt Google Shopping-feed, kan du i stedet bruge det indbyggede, som er beskrevet i Opsæt Google Shopping Feed.