Produktfeed - dokumentation

Hvad er et produktfeed?

Et produktfeed er den liste med produkter og priser, som PriceRunner bruger til at vise dine varer korrekt i vores prissammenligninger.

I produktfeedet samler du alle vigtige oplysninger om dine produkter ét sted. Det er eksempelvis produktnavn, pris, lagerstatus og link til varen i din webshop. De oplysningert gør det nemt for os at hente og opdatere dine produkter – og det sker helt automatisk.

For at sikre fair og gennemsigtige sammenligninger er der nogle grundlæggende krav:

✅ Priser skal være pr. stk.
✅ Priser skal være inklusive moms
❌ Mængderabatter og pakkeløsninger accepteres ikke
✅ Oplysningerne i feedet skal svare til det, kunden møder i din webshop

Når de krav er opfyldt, har du fuld kontrol over, hvordan dine produkter vises på PriceRunner.

Sådan fungerer et produktfeed i praksis

Når du opretter et produktfeed, laver du et samlet produktkatalog for din butik. Det stiller du til rådighed for os via et link, som vores system henter data – helt automatisk og flere gange dagligt.

Vi behandler oplysningerne på få sekunder, så dine produkter hurtigt bliver synlige og altid vises med opdaterede priser.

De fleste e-handelsplatforme tilbyder i dag funktioner til at oprette produktfeeds. I mange tilfælde er det en del af standardløsningen og kræver kun begrænset opsætning.

Hvorfor anbefaler vi et produktfeed?

Et produktfeed er den mest stabile og fremtidssikrede løsning.

Alternativt kan vi indsamle produktoplysninger direkte fra dit website. Det kræver dog mere tid og flere ressourcer, og ændringer på dit website kan medføre, at produkter forsvinder midlertidigt fra sammenligningerne.

Derfor anbefaler vi altid et produktfeed, hvis det er muligt.

Aktualitet og kvalitet af dine oplysninger

Vi opdaterer butikkernes produktfeeds flere gange dagligt for at sikre korrekte oplysninger. Det er dog vigtigt, at dit produktfeed også løbende vedligeholdes, så priser, lagerstatus og produktinformation altid er opdateret.

Jo bedre kvalitet dine data har, desto bedre fungerer dine produkter i vores sammenligninger.

Og nu til den mere langhårede (tekniske) del

Nedenfor kan du læse mere om feed-URL, adgang og tekniske krav. Har du spørgsmål undervejs? Vi hjælper dig naturligvis med at finde den løsning, der passer bedst til din webshop. Kontakt os her – vi er her for det samme.

Feed URL

Dit produktfeed skal være tilgængeligt via en HTTPS-adresse eller en FTP-server, så vi kan tilgå og bruge filen med dine oplysninger i forhold til vores sammenligninger. Hvis du har adgangsbegrænsninger på IP-niveau, skal du sørge for, at PriceRunners IP'er kan få adgang.

Liste over IP'er

63.32.183.131
52.51.164.75
108.129.33.253
46.51.177.207
3.212.28.164
52.71.114.62
54.161.108.102

❌ Undlad at bruge dato- og tidsstempler eller anden information, der kan ændre URL'en til dit produktfeed – det kan risikere, at dine produkter forsvinder.

Headers

Vi anbefaler, at du tilføjer en last-modified HTTP response-header i forbindelse med dit produktfeed. "Last-modified" fortæller os, hvornår dit produktfeed senest blev ændret med angivelse af dato og tidspunkt.

Når du har den information med i dit feed til os, kan vi bedre optimere vores prisopdateringer og vise den seneste opdaterede udgave af dit produktkatalog med dine produkter og tilgængelighed. Med "last-modified" i dit feed, vil vi oftere kunne tjekke for opdateringer i dit produktfeed.

Encoding

Dit produktfeed bør laves med en af disse indkodninger:
UTF-8, UTF-16, ISO-8859-1, Windows-1252.

Formater

Produktfeeds kan oprettes i de fleste formater. Vi håndterer de mest almindelige som TEXT/CSV, XML og JSON.

❌ Undgå Excel-format eller andre ikke-tekstbaserede løsninger.
✅ Komprimer produktfeedet med gzip/zip for hurtigere behandling.

CSV

Hvis du laver et produktfeed som en CSV-fil, skal data struktureres i rækker og kolonner:

Hver række er et produkt
Hver kolonne er felter med produktoplysninger

Hvert felt eller hver kolonne skal holdes separat fra hinanden med en bestemt separator. Vi anbefaler brugen af tab (\t), lodret streg (|), semikolon (;) og komma (,).

Brug såkaldte "field qualifiers" i starten og i slutningen af hvert felt. Det kan du gøre med apostroffer ( ‘ ‘ ) og citationstegn ( “ ” ). Vær opmærksom på, at tegnet ikke samtidig kan bruges inden for feltet.

Eksempler på produktfeed

Specifikation for produktdata og rækkefølge

Her er en liste med anbefalede produktdata og attributter, som du bør inkludere i dit produktfeed for at sikre optimal visning. Rækkefølgen er ikke vigtig, så længe de er forståelige for vores systemer.

✅ Når du tilføjer EAN/GTIN (varens unikke stregkode) til dine produkter, kan vi automatisk matche dine produkter til en prissammenligning.
❌ Felter i feedet må på intet tidspunkt indeholde kode eller tags såsom HTML eller javascript.

Produktegenskaber

Grundlæggende attributter (Minimumskrav)

SKU/id
Navn
Pris
GTIN/EAN
Leveringsomkostninger
Lagerstatus
Leveringstid
Brand
Manufacturer SKU / MPN
URL
Billedlink
Kategori – breadcrumbs
Produktbeskrivelse
Condition

Detaljerede attributter

Tilbudspris
Perioden for tilbuddet
Color
Size
SizeSystem
AdultContent
AgeGroup
Bundled
EnergyEfficiencyClass
Gender
GroupId
Material
Multipack
Pattern

Grundlæggende attributter

SKU/id

Brug SKU (varenumre) som ID på dine produkter, hvor det er muligt. Et SKU er unikt, og hver vare i feedet skal derfor angives med sit eget unikke SKU – ellers kan det resultere i, at produktet kasseres og ikke vises i søgeresultaterne.

✅ Godt SKU: ABC123
❌ Dårligt SKU: 1

Navn

Enhver variant eller model af et produkt bør tydeligt angives i dit produktfeed. PriceRunners søgemaskine og filtre gør brug af oplysningerne i dette felt. Sørg for at bruge de keywords, som du gerne vil findes på.

✅ Apple iPhone 12, 256GB, grey
❌ iPhone 12

Dit produktnavn vil blive brugt til at matche dit produkt med vores produkter og brugerens specifikke søgning. Tilføj de vigtige detaljer, der definerer dit produkt.

✅ Unikt navn for hvert produkt
❌ Identiske navne
Ikke-alfabetiske tegn

TIP: Skriv de vigtigste detaljer først. Besøgende ser typisk de første 70 tegn (eller færre) af din titel afhængigt af skærmstørrelsen.

Brug keywords. Keywords kan hjælpe vores systemer med at matche dit produkt til brugerens søgning og på den måde gøre det tydeligt for brugeren, hvad du sælger. Dine keywords kan indeholde produktoplysninger som:

✅ Produktnavn
✅ Brand
✅ Specifikke oplysninger om produktet
❌ Oplysninger om rabatter, udsalg, lagerstatus eller leveringstid i produktnavnet. Det kan du angive et andet sted i feedet.

Pris

Prisen i dit produktfeed skal altid være den samme pris, som kunden betaler i din webshop.

Det betyder, at:

Prisen skal være inklusive moms
Prisen skal være pr. stk. (enhedspris)
Mængderabatter og pakkepriser accepteres ikke
Valutaen bør angives i prisfeltet
Brug enten komma (,) eller punktum (.) som decimalseparator

Eksempler på korrekt og forkert prisangivelse:

✅ 250,00 DKK
❌ 250,00 eksklusive moms
❌ 3 stk. for 600 kr.

Kort sagt: Den pris, du sender i dit produktfeed, skal stemme 100 % overens med den pris, kunden ser i kurven ved bestilling.

Medlemskabspriser

Medlemskabspriser kan vises på PriceRunner, hvis medlemskabet er gratis og ikke medfører nogen form for løbende omkostning for kunden.

Det betyder, at:

Prisen skal være inklusive moms
Prisen skal være den faktiske medlemspris
Valutaen bør angives i prisfeltet
Brug enten komma (,) eller punktum (.) som decimalseparator

Vi viser kun medlemskabspriser, når medlemskabet er gratis og uden månedlig meromkostning.

Eksempler på medlemskaber, der accepteres:

✅ Gratis kundeklub
✅ Tilmelding til nyhedsbrev
✅ Gratis brugerprofil

Eksempler på medlemskaber, der ikke accepteres:

❌ Betalt abonnement
❌ Medlemskab med månedligt gebyr
❌ Medlemskab med skjulte eller obligatoriske tillægsomkostninger

Kort sagt:
KUN hvis kunden kan få prisen uden på nogen måde at betale for medlemskabet, kan prisen vises på PriceRunner.

GTIN/EAN

GTIN er varens unikke stregkodenummer, også kaldet EAN. Vi bruger varens EAN-nummer til automatisk at matche dine produkter, så vi kan lave en prissammenligning med de øvrige forhandlere, men også for at gøre det let at søge direkte på et EAN nummer som fritekst eller ved at bruge telefonen som stregkodescanner i søgefeltet på PriceRunner.

✅ 002129914757

Leveringsomkostninger

Her angiver du den totale fragtpris for den enkelte vare. Prisen skal inkludere alle leverings-/bestillingsomkostninger for forbrugeren. Det er for eksempel miljøtillæg, fragttillæg, ekspeditionstillæg, emballagegebyr og så videre.

✅ 39 DKK

Lagerstatus

På PriceRunner ønsker vi kun at vise produkter, der enten kan købes eller bestilles. Det giver ofte en dårlig oplevelse for brugeren, hvis produktet ikke kan købes eller bestilles, og derfor bør varen slet ikke indgå i dit produktfeed.

Online lagerstatus er afgørende

Din lagerstatus i produktfeedet skal altid afspejle den lagerstatus, der gælder ved bestilling online.
Vi skelner ikke mellem lokalt lager og fjernlager.

Har du fysiske butikker? Intet problem. Du kan sagtens vise butikspriser, for varer der kan afhentes fysisk i butikken. Du skal bare markere varen som collect_in_store feedet.

Særlige lagerstatusser

Forudbestilling af nye produkter kan angives som preorder
Bestillingsvarer, som ikke er på lager lige nu, men kan bestilles, kan angives som backorder

Sådan angiver du lagerstatus

Du kan angive lagerstatus på flere måder, fx:

in stock eller out of stock
Ja eller Nej
Nøjagtigt antal på lager (eksempelvis 23)
preorder eller backorder

Eksempler på god lagerstatus:

✅ Ja
✅ InStock
✅ OutOfStock
✅ Backorder
✅ Preorder
✅ 23

Eksempler på dårlig lagerstatus:

❌ Få
❌ N/A

Leveringstid

Den leveringstid, du lover din kunde, fra kundens ordretidspunkt angivet i antal dage. Det er vigtigt, at leveringstiden i dit produktfeed svarer til det, du skriver på dit website.

✅ 2-5 dage
❌ Varierer

Brand

Brand står for producenten af varen, og er ofte også kendt som produktets varemærke. Oplysningen bliver brugt i de filtre, som vores besøgende kan bruge i kategorierne for at se produkter af bestemte mærker.

✅ Adidas

Manufacturer SKU/MPN

Manufacturer SKU, også kaldet MPN, er producentens eget varenummer. Vi bruger det til at matche produkter korrekt i vores prissammenligninger.

Sådan bruger du SKU / MPN korrekt

✅ Kun det varenummer, som producenten har tildelt produktet
✅ Brug den korrekte MPN for hver produktvariant
❌ Indtast ikke et varenummer, du selv har oprettet – medmindre du selv er producenten.

Som udgangspunkt har forskellige varianter af samme produkt hver deres Manufacturer SKU / MPN. Det kunne eksempelvis være modeller i andre farver eller udstyrsvarianter.

Undtagelse: Ved tøj har forskellige størrelser ofte samme Manufacturer SKU / MPN.

Eksempler:

✅ 1170-0500
✅ 43STX/White

URL

Varens URL er linket direkte til produktet på dit website. URL'en til dit website kan også indeholde UTM-parametre, så du i Google Analytics eller andre analyseværktøjer kan se, hvorfra du får trafik til dit website.

Eksempel på produktlink:
✅ https://www.yourstore.com/product1.html

Billedlink

URL'en til produktets billede hos dig – brug en statisk URL.
Billedlinket i dit produktfeed bør ikke ændres, medmindre selve billedet udskiftes eller får en helt ny URL-struktur hos dig.

✅ Kvadratiske billeder mellem 700x700px og 2000x2000px foretrækkes
✅ Brug specifikke billeder pr. farvevariant
❌ CMYK formatet understøttes ikke
❌ Vandmærker i billeder
❌ Placeholder-billeder

Billederne vises pr. produkt og et produkt har flere forhandlere, derfor må du ikke bruge vandmærker.

Du skal også undlade at bruge billedlinks med tidsstempler, cacheværdier eller anden information, der kan ændres hver gang du genererer og opdaterer feed-data.

Når du ændrer et billedlink, betyder det, at vi skal downloade og genbehandle billedet på ny i vores system – og der kan godt på en del tid, før det opdateres på PriceRunner.

Eksempel på billedlink:
✅ https://www.yourstore.com/product1.jpg

Kategori

Brug den fulde brødkrummesti (breadcrumbs) fra produktet på dit website, når du angiver kategori i dit produktfeed.
Jo mere præcis kategorien er, desto bedre kan vi behandle og vise dine produkter i de rigtige sammenhænge.

Eksempel på korrekt kategoriopbygning:
✅ Sko > Sportssko > Løbesko

Hold dine kategorier adskilte

Undgå at blande forskellige produkttyper i samme kategori.

Tilbehør bør for eksempel altid have sin egen kategori og ikke placeres sammen med selve hovedproduktet.

Eksempel:
✅ Køkkenudstyr > Kaffemaskiner
✅ Køkkenudstyr > Kaffemaskiner > kaffetilbehør

Brug korrekt format

Brug tegnet ">" til at adskille niveauer i kategorien. Der skal være mellemrum både før og efter tegnet.

Eksempel:
✅ Tøj > Damer > Nederdele

Kønsspecifikke produkter

For kønsspecifikke produkter (eksempelvis tøj) er det vigtigt at opdele i:

✅ Damer
✅ Herrer
✅ Unisex
✅ Børn

Vores filtre baserer sig delvist på din kategoriangivelse, så med en korrekt opdeling opnår du bedre synlighed.

Eksempler:
✅ Tøj > Damer > Bukser
❌ Fashion & Tøj

Produktbeskrivelse

Jo mere relevant din beskrivelse er, jo bedre vil den fremstå for vores brugere. Vores søgemaskine og filtre bruger oplysningerne herfra. Derfor skal du sørge for at inkludere de vigtige keywords, som du gerne vil findes på – dog Maksimalt 30 ord.

✅ Rødt bord med fire ben og opbevaring nedenunder. Ideel til stue og soveværelse. Mål 100 x 50 cm.
❌ Virkelig flot, smart og praktisk!

Condition

Brug attributten Condition til at angive varens tilstand på købstidspunktet.
Værdien skal angives på engelsk.

New
Varen er fabriksny, uåbnet og leveres i original emballage. Der ydes fuld producentgaranti og standard returret.

Used Varen er brugt. Det kan eksempelvis være en udstillingsmodel, demo-vare eller en vare med beskadiget eller manglende emballage.

Refurbished
Varen er ikke ny, men er blevet gennemgået og testet for at fungere som et nyt produkt. Defekte dele er udskiftet. Varen kan have mindre brugsspor og leveres med eller uden original emballage.

Detaljerede attributter

Når dit produkt findes i flere varianter, bør hver variant angives separat i dit produktfeed.

Det betyder, at hver variant skal have sine egne oplysninger som eksempelvis størrelse, EAN-kode og varenummer (SKU).

Eksempel: Sælger du en sko i 7 størrelser, skal skoen derfor indgå 7 gange i dit produktfeed – én gang pr. størrelse – med korrekt størrelse, unik EAN og unikt varenummer for hver variant.

Tilbudspris

Den nedsatte pris for varen inklusive moms. Valutaen bør angives i prisfeltet. Brug enten komma eller punktum som decimaltegn.

Er varen ikke på tilbud?
Du skal holde Sale_Price-feltet tomt, hvis varen ikke er på tilbud. En værdi i dette felt vil overskrive den oprindelige pris i pris-feltet.

Perioden for tilbuddet

Her oplyser du om varigheden af dit tilbud <sale_price_effective_date>. Når du angiver en start- og slutdato for dit tilbud (i kombination med en sale_price attribut), kan vi vise dine tilbudspriser og udsalgsperioder direkte i sammenligningerne.

Du kan angive en <sale_price_effective_date> værdi på flere måder, og du kan præcisere din udsalgsperiode med et specifikt klokkeslæt.

2024-11-24T13:00-0800/2024-11-29T15:30-0800 (typisk format)
2024-11-07T00:00:00+02:00/2024-12-07T23:59:59+01:00 (med et kolon i tidszonen)
2024-11-07T00:00:00Z/2024-12-07T23:59:59Z (UTC tidszone repræsenteret med et Z)
2024-11-24T13:00:00-0800/2024-11-29T15:30:00-0800 (med sekunder)
2024-11-24T13:00/2024-11-29T15:30 (Med klokkeslæt, men uden tidszone, standardindstilling til UTC)
2024-11-24/2024-11-29 (Uden klokkeslæt og tidszone, standardindstilling til 00:00/23:59 UTC)

Hvis ikke du angiver et tidspunkt og tidszone, så vil tilbudsprisen starte kl. 00:00 (midnat) på startdatoen og slutte kl 23:59 i tidszonen UTC.

Color

Brug attributten Color til at angive farven på dit produkt. For eksempel:

White
Grey/Thunder Grey

Size

Brug attributten size til at angive varens størrelse.

Den her værdi er synlig i en sammenligning, hvor du kan bruge filtre til at sortere på varens størrelse som er praktisk for eksempelvis tøj og sko, men også smykker/ringe med mere.

SizeSystem

Attributten SizeSystem angiver det land/størrelsessystem, der bruges for dine produkter. For eksempel UK eller EU.

AdultContent

Brug attributten til at angive, om dit produkt indeholder voksenindhold såsom nøgenhed og seksuelt indhold. Du kan angive det som (yes/no).

AgeGroup

Brug attributten til at angive den målgruppen, dit produkt henvender sig til.

Bundled

Brug attributten Bundled (angives på engelsk) til at markere med yes eller no, om produktet består af flere produkter samlet i én pakkeløsning ud fra ét hovedprodukt.

EnergyEfficiencyClass

Brug attributten til at angive energimærket på dit produkt.

Gender

Brug attributten til at angive det køn, som dit produkt henvender sig til. De understøttede værdier er unisex, male, female.

GroupId

Brug attributten til at angive et ID for en gruppe af produkter, som fås i forskellige udgaver (versioner).

Material

Brug attributten til at angive det stof eller de materialer, varen er sammensat af.

Multipack

Brug attributten til at angive antallet af identiske produkter, der sælges som en enhed. Det kan for eksempel angives som '6', hvis du sælger 6 flasker sammen.

Pattern

Brug attributten til at angive varens mønster eller grafisk tryk.