How to connect the BlueWinston feed with easySales
Send your products to BlueWinston with an easySales feed: the Feed URL, Exclude categories, characteristic names that work, what goes into the file and feed rules.
What the BlueWinston feed does
BlueWinston builds online advertising campaigns from your product list. easySales builds that list for it — names, categories, prices, images, links and characteristics from your online shop — and keeps it at a fixed address, the Feed URL.
Three things to know before you begin:
- Create the feed on your online shop's tab, not on Virtual Shop. BlueWinston sends shoppers to each product's page in your shop, and only your online shop's products carry that link.
- Keep characteristic names plain. Each characteristic goes into the file as its own field, named after the characteristic. Step 3 explains which names work.
- Leave Tracking Code empty. easySales adds it to the end of every product link, which changes the links BlueWinston sends shoppers to.
Before you start
A BlueWinston account
Where you add the Feed URL as your product feed.
Your online shop connected to easySales
The feed takes its products, links and images from it.
Plain characteristic names
Letters without diacritics, digits and spaces — see Step 3.
Step 1 — Connect the feed
Go to Products → Online Shops → Feed and choose the tab of your online shop. Press Connect on the BlueWinston card. The Connection tab has these fields:
| Field | What goes in it |
|---|---|
| Tracking Code |
Leave it empty. When it is filled in, easySales adds &tracking= and your code to the end of every product link.
|
| Exclude categories | Optional. For each product, easySales sends the first of its categories that is not in this list. Exclude broad parent or general categories, such as Home or Promotions, so the more specific category is sent. |
Press Save.
Step 2 — Give BlueWinston your Feed URL
Back on the Feed page, the card shows the Feed URL and, once the file is ready, Last generated with its date and time. The first file is ready within the hour after you save.
When Last generated appears, copy the Feed URL and add it as your product feed in your BlueWinston account. easySales keeps the file at the same address and updates it as your products change.
Step 3 — Check your characteristic names
After the fixed fields, every characteristic of a product goes into the file as its own field, named after the characteristic: Colour becomes a Colour field with the product's value.
A field name can only hold certain characters, so use characteristic names that:
- contain only letters without diacritics, digits, spaces, hyphens, underscores and dots;
- do not start with a digit;
- have no commas,
%,&, quotation marks, or letters such asșandț.
What goes into the file
Each active product of the shop with stock is one product in the file, with:
| In the file | Taken from |
|---|---|
ID
|
The product's SKU |
NAME
|
The product's name |
URL
|
The product's page in your shop |
IMAGE
|
The product's first image |
SALE_PRICE
|
The sale price with VAT, in RON |
FULL_PRICE
|
The full price with VAT, in RON |
CATEGORY
|
The first category that is not excluded, or the value a rule sets |
BRAND
|
The product's brand |
| One field per characteristic | The characteristic's value, in a field named after the characteristic |
To leave products out, open the feed with Edit, then Feed rules → Create a new rule and use exclude product from feed. To change the price for BlueWinston, write the rule on sale price or tax rate.
When something does not look right
| Symptom | What to do |
|---|---|
| The Feed URL answers "Feed generation in progress..." | The first file is not ready yet. Wait until Last generated appears on the card. |
| Last generated stopped changing | A characteristic name has a character a field name cannot hold. Rename it as Step 3 describes. |
| Product links in BlueWinston do not open the product | Empty Tracking Code and save. |
| A product is missing from the feed | Check that it is active and has stock, and that no feed rule excludes it. |
| Products have no link in BlueWinston | The feed was created on the Virtual Shop tab. Delete it and connect it on your online shop's tab. |