Handleiding Productfeed

Met de productfeed kun je eenvoudig de actuele catalogus van bol.com ophalen en op je website plaatsen. In de productfeed vind je csv – of xml bestanden met daarin alle producten per productgroep. Voor 18 productgroepen bieden we een feed aan.

Baby Mother & Child product-feed_baby-mother-child.csv.gz
product-feed_baby-mother-child.xml.gz
Beauty & Care product-feed_beauty-care.csv.gz
product-feed_beauty-care.xml.gz
Computer & Games product-feed_computer-games.csv.gz
product-feed_computer-games.xml.gz
Cooking Dining & Houseware product-feed_cooking-dining-houseware.csv.gz
product-feed_cooking-dining-houseware.xml.gz
Digital Reading product-feed_digital-reading.csv.gz
product-feed_digital-reading.xml.gz
Domestic Appliances product-feed_domestic-appliances.csv.gz
product-feed_domestic-appliances.xml.gz
Educational Books & Supplies product-feed_educational-books-supplies.csv.gz
product-feed_educational-books-supplies.xml.gz
Entertainment product-feed_entertainment.csv.gz
product-feed_entertainment.xml.gz
General Books product-feed_general-books.csv.gz
product-feed_general-books.xml.gz
Health & Intimacy product-feed_health-intimacy.csv.gz
product-feed_health-intimacy.xml.gz
Home Furnishing product-feed_home-furnishing.csv.gz
product-feed_home-furnishing.xml.gz
Home Improvement & Gardening product-feed_home-improvement-gardening.csv.gz
product-feed_home-improvement-gardening.xml.gz
Jewellery Watches & Accessories product-feed_jewellery-watches-accessories.csv.gz
product-feed_jewellery-watches-accessories.xml.gz
Mobile & Tablets product-feed_mobile-tablets.csv.gz
product-feed_mobile-tablets.xml.gz
Pet product-feed_pet.csv.gz
product-feed_pet.xml.gz
Sound & Vision product-feed_sound-vision.csv.gz
product-feed_sound-vision.xml.gz
Sport & Leisure product-feed_sport-leisure.csv.gz
product-feed_sport-leisure.xml.gz
Toys product-feed_toys.csv.gz
product-feed_toys.xml.gz

Deze productgroepen bevatten voor ieder product het beste aanbod op het moment dat de feed wordt samengesteld. Dat kan het aanbod van bol.com of van een zakelijk verkoper (bol.com Verkopen) zijn. In kolom OfferNL.sellerType en OfferBE.sellerType op iedere productregel zie je aan de hand van een B (bol.com) of P (Plaza) wie het product aanbiedt.

Het gebruiken van een productfeed heeft als voordeel dat de informatie up-to-date is, dat niet leverbare producten automatisch uit de feeds worden verwijderd en dat de informatie sneller en gemakkelijker te verwerken is voor jou als partner. De feeds worden iedere 2 uur geüpdatet.

Voor realtime of meer geavanceerde functionaliteiten kunt u ook gebruik maken van onze Open API.

De productfeed gebruiken

De implementatie van de feeds op je eigen website vergt wat programmeerwerk. Wees je hiervan bewust voor je toegang aanvraagt voor de feed. Mocht je niet goed kunnen programmeren dan verwijzen we je graag naar onze tekst- en productlinks als promotiemiddel.

De productfeed is op de volgende manieren in te laden op je website:

  • Door middel van een import in eigen database. Scripting kennis is hiervoor vereist.
  • Door middel van plugins en standaard-scripts voor CMS pakketten, zoals WordPress.
  • Door middel van tools voor het ophalen van productfeeds.

Het bestand van de product tekstfeed bestaat uit regels met informatie. Iedere regel vertegenwoordigd een ander product. De producten binnen een bepaalde categorie hebben dezelfde opmaak en specificaties. De informatie over de verschillende regels vind je op de eerste regel, hier vind je de kolomnamen.

Let op! Je moet zelf de tracking (voor het Partnerprogramma) toevoegen aan de informatie uit de productfeed. Ook ben je zelf verantwoordelijk voor het schrijven van een script of voor de import van de feed naar je eigen website. Ons supportteam kan je hier geen ondersteuning bij geven.

We bieden ook XML productfeeds aan. Voor de XSD en een implementatievoorbeeld kijk hier.

Hoe krijg ik toegang tot de productfeed?

De feeds zijn te bereiken via onze FTP-server. Om toegang hiervoor te krijgen, moet je je IP-adres waarvandaan je de FTP-server benaderd laten whitelisten. Dit kun je laten doen door dit formulier in te vullen. Voor een succesvolle whitelist hebben we je naam, website, siteID en email nodig.

De aanvraag neemt maximaal vijf dagen in beslag. Als je IP-adres is toegevoegd, ontvang je hierover een bericht van onze support-afdeling. Als je bent toegevoegd aan de whitelist krijg je ook de inloggegevens voor de productfeed.

De productfeed koppelen aan het Partnerprogramma

De URL’s die in de productfeeds staan, zijn reguliere productlinks naar de website van bol.com. Dit zijn dus nog geen partnerlinks! Om de productfeed te koppelen aan het Partnerprogramma, moet je de URL ombouwen naar een tracking URL. Zonder tracking URL is er geen mogelijkheid om te zien van wie de verkoop afkomstig is, de verkoop wordt dan niet correct toegewezen aan de juiste partner.

De tracking URL is als volgt opgebouwd:
http://partnerprogramma.bol.com/click/click?p=1&t=url&s=SiteId&url=ProductURL&f=TXL&subid=SubID&name=Naam

Het samenstellen van een Tracking URL gaat als volgt:

Gegevens voor voorbeeld:
Product dat we willen plaatsen op onze website:
De Cirkel – Dave Eggers (Boeken NL, paperback)

Gegevens van de partner:
SiteId is “144
Naam is “Homepagina”
SubID is “DeCirkel”
Aan de hand van de naam en het subID kun je in de rapportages terug zien vanaf welke link een verkoop komt.

Product URL van product:
http://www.bol.com/nl/p/de-cirkel/9200000020683226/

De bovenstaande gegevens plaats je in de tracking URL. Je krijgt dan het volgende eindresultaat:

http://partnerprogramma.bol.com/click/click?p=1&t=url&s=144&url=http://www.bol.com/nl/p/de-cirkel/9200000020683226/&f=TXL&subid=DeCirkel&name=Homepagina

Let op! Je bent zelf verantwoordelijk voor het correct invoeren van de tracking URL. Controleer altijd of je links werken. Het controleren van de links kan aan de hand van de referrer. Dit werkt als volgt:

  1. 1. Plak de tracking URL die je hebt gemaakt in je webbrowser.
  2. 2. Druk op enter
  3. 3. Kijk naar de referrer in de URL. De referrer zou er als volgt uit moeten zien:
    http://www.bol.com/nl/p/de-cirkel/9200000020683226/?Referrer=ADVNLPPcefaa000eef7120700dcaf8545000000144
    De laatste cijfers zijn jouw siteID. Als deze cijfers niet overeenkomen, heb je een verkeerd siteID in jouw tracking URL staan.
  1. 4. Controleer ook altijd of je de kliks terugziet in je rapportages. Zo weet je zeker dat alles werkt.

Kolomnamen

Het bestand dat je uit de productfeed haalt, is ingedeeld in regels. Iedere regel vertegenwoordigt een ander product. Elke feed is opgedeeld in kolommen (alle feeds hebben dezelfde structuur) met informatie per product. Deze informatie betreft bijvoorbeeld de titel, auteur, kleur, releasedatum en/of prijs. De kolommen, gescheiden door een |, zijn op de eerste regel te vinden. Mocht je niet helemaal weten wat deze betekenen, dan vind je hier de betekenis.

 

 


Vraag toegang tot productfeed aan  Bekijk de productfeedkolomnamen  Vragen? Stel ze aan ons supporteam 


 

volg developers.bol.com via TwitterMeld je aan voor de Partnerprogramma groep op Linkedin