Handleiding

Handleiding Productfeed

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

  • Baby
    product-feed_baby-v2.csv.gz
    product-feed_baby-v2.xml.gz
  • Computer
    product-feed_computer-v2.csv.gz
    product-feed_computer-v2.xml.gz
  • Daily Care
    product-feed_daily-care-v2.csv.gz
    product-feed_daily-care-v2.xml.gz
  • Digital Reading
    product-feed_digital-reading-v2.csv.gz
    product-feed_digital-reading-v2.xml.gz
  • DIY
    product-feed_diy-v2.csv.gz
    product-feed_diy-v2.csv.gz
  • Dutch Books
    product-feed_dutch-books-v2.csv.gz
    product-feed_dutch-books-v2.xml.gz
  • Educational Books
    product-feed_educational-books-v2.csv.gz
    product-feed_educational-books-v2.xml.gz
  • Entertainment
    product-feed_entertainment-v2.csv.gz
    product-feed_entertainment-v2.xml.gz
  • Fashion Accessories
    product-feed_fashion-accessories-v2.csv.gz
    product-feed_fashion-accessories-v2.xml.gz
  • Fashion Footwear
    product-feed_fashion-footwear-v2.csv.gz
    product-feed_fashion-footwear-v2.xml.gz
  • Garden Lighting
    product-feed_garden-lighting-v2.csv.gz
    product-feed_garden-lighting-v2.xml.gz
  • Gift Cards
    product-feed_gift-cards-v2.csv.gz
    product-feed_gift-cards-v2.xml.gz
  • Health
    product-feed_health-v2.csv.gz
    product-feed_health-v2.xml.gz
  • Home Interior
    product-feed_home-interior-v2.csv.gz
    product-feed_home-interior-v2.xml.gz
  • International Books
    product-feed_international-books-v2.csv.gz
    product-feed_international-books-v2.xml.gz
  • Kitchen Household
    product-feed_kitchen-household-v2.csv.gz
    product-feed_kitchen-household-v2.xml.gz
  • MDA
    product-feed_mda-v2.csv.gz
    product-feed_mda-v2.csv.gz
  • Mobile
    product-feed_mobile-v2.csv.gz
    product-feed_mobile-v2.xml.gz
  • Outdoor-mobility
    product-feed_outdoor-mobility-v2.csv.gz
    product-feed_outdoor-mobility-v2.xml.gz
  • Perfumery
    product-feed_perfumery-v2.csv.gz
    product-feed_perfumery-v2.xml.gz
  • Pet
    product-feed_pet-v2.csv.gz
    product-feed_pet-v2.csv.gz
  • SDA
    product-feed_sda-v2.csv.gz
    product-feed_sda-v2.xml.gz
  • Sound Vision
    product-feed_sound-vision-v2.csv.gz
    product-feed_sound-vision-v2.xml.gz
  • Sports
    product-feed_sports-v2.csv.gz
    product-feed_sports-v2.xml.gz
  • Supermarket
    product-feed_supermarket-v2.csv.gz
    product-feed_supermarket-v2.xml.gz
  • Toys
    product-feed_toys-v2.csv.gz
    product-feed_toys-v2.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 of van een zakelijk verkoper (Zakelijk Verkopen) zijn. In de kolom OfferNL.sellerType en OfferBE.sellerType op iedere productregel zie je aan de hand van een B (bol) 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.

We draaien de feeds (per shop) elke twee uur, ~10 minuten na het hele uur. Gemiddeld duurt het een uur voordat de bestanden op de FTP beschikbaar zijn.

Het beste moment om de feeds te downloaden is een half uur na elk oneven uur (dus om 05:30, 07:30, 09:30...) zodat je altijd de meest recente info ter beschikking hebt. Om 02:10 slaan we een feedrun over.

Verwacht op FTP
01:10
05:10
07:10
09:10
11:10
13:10
15:10
17:10
19:10
21:10
23:10

Voor realtime of meer geavanceerde functionaliteiten kun je 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 Affiliate programma) 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 te krijgen, kun je deze handleiding volgen.

Zodra je toegang hebt, dan kun je de productfeeds ophalen met je log-in gegevens op een van deze manieren.

Met de productfeed kun je producten inladen in je website. Deze feed wordt om de paar uur gegenereerd en bevat up-to-date informatie over alle producten van bol in elke categorie.

De productfeed koppelen aan het Affiliate programma

De URL’s die in de productfeeds staan, zijn reguliere productlinks naar de website van bol. Dit zijn dus nog geen partnerlinks! Om de productfeed te koppelen aan het Affiliate programma, 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:
https://partner.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:
https://www.bol.com/nl/p/de-cirkel/9200000020683226/ (https://www.bol.com/nl/p/de-cirkel/9200000020683226/)

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

https://partner.bol.com/click/click?p=1&t=url&s=144&url=https://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. Plak de tracking URL die je hebt gemaakt in je webbrowser.
  2. Druk op enter
  3. Kijk naar de referrer in de URL. De referrer zou er als volgt uit moeten zien:
    https://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.
  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.