Promotions

What is a Promotion?

Promotions are techniques designed to help a business make its customers aware of its products. It enables you to promote specific products to persuade customers and encourage product consumption.

Promotions API

The Promotions API allows you to track the following:

  • Current and upcoming promotions (up to three months) applicable to the retailer’s product portfolio.

  • Promotions that are retailer specific or are open to the platform.

  • Promotions belonging to a specific marketing campaign.

Based on the aforementioned details from the Promotions API you can re-position your products in the shop to stand out in the search results.

Through the Seller dashboard you can configure different criteria for your retailer specific promotions such as defining the type of the promotion or limiting the promotion to a certain time frame.

Promotions and campaigns

bol.com offers you the following promotional strategies:

  • Retailer promotions – Promotions created by retailers that are applicable to their product portfolio. It offers them an opportunity to evaluate their product pricing in order to qualify for the promotion visibility.

  • Promotional campaigns – Promotions that are a part of a specific bol campaign. Campaigns allow customers to score good deals for the duration of the promotion.

Retailer promotions must be created or removed in the Seller Dashboard. The Promotions API allows you to automate the tracking of (your) bol promotional campaigns.

To identify the category of your promotion, refer to the field retailerSpecificPromotion.

For more information on participating in promotional campaigns, refer to Promotions in bol campaigns (Dutch).

For more information on setting up your own promotions, refer to Set up your own campaigns (Dutch).

How to use the Promotions API

This section describes how the Promotions API functions and what to expect while working with the API.

Endpoints

The Promotions API offers the following endpoints:

Get a list of promotions

Provides a list of all the current and future promotions (up to 3 months) that apply to a retailer ID and the selected promotion type. Additionally, it allows you to view the response in a paginated format thereby delivering structured feedback.

For more information on the endpoint, see Get a list of promotions Redoc.

Get a promotion by promotion id

Provides detailed information for a promotion by its promotion ID, allowing you to review and adjust their pricing in order to qualify for the promotion.

For more information on the endpoint, see Get a promotion by promotion id Redoc.

Get a list of products

Provides detailed information of products eligible for a specific promotion in a paginated format.

For more information on the endpoint, see Get a list of products Redoc.

Relevance score and Maximum price

Relevance score - Specifies the relevance of the product for a promotion. This score ranges between 1-100 and is determined based on the following:

  • Number of times an article has been viewed.

  • Number of times an article has been saved in the wish list.

  • Number of times an article has been sold.

  • Review scores of an article.

  • Return percentage of an article.

The higher the score, the more relevant is the product for the promotion.

Relevance score of a product can differ per country for a retailer.

Maximum price – Specifies the upper limit of pricing that your product must meet to qualify for the promotion. The visibility of the products during the promotion largely depends on relative pricing. Hence, it is recommended to refer the maximum price limit and set your pricing equal to or below the maximum price to enable your products to be highlighted with a promotional label.

Supported promotions types

The table below describes the currently supported promotions types for the Promotions API.

Supported Types Description Example on bol

Awareness

Applicable when a product is not discounted, but already has a low price in comparison to other products in its classification category.

Awareness

Price off

Applicable when a discount is active on a product.

Price off