Advertiser feeds provide product details for dynamic ads. The minimum of information needed for each product is
Unique product ID
Product URL (as shown in the browser when visiting the product)
But we recommend to also include
Image URL
Name
Description
Price
to be able to create a good looking creative.
In cases where the same product can be reached via different urls the suggested approach is to add that product to the feed as two separate products keeping common data equal between the two products and just replaces the product url and the unique id.
BidTheatre DSP currently support feeds in the following formats: CSV, XML and JSON.
Setup the feed
The feed is setup via Assets -> Advertiser Feeds.
Feed field | Description |
Ignore Parameters (comma-separated list) | If the site include parameters that don't is included in the product URL in the feed, they can be excluded here. |
Encoding | Use UTF8 if unsure. |
Col Delimiter | Only used for CSV-feeds and should indicate what character that is used to separate each product field in the feed. |
Skip first row | In the case of CSV-feeds, the first row often is a header and not a product, use this to indicate if the first row should be skipped |
Text qualifiers | Set this if quotes are used inside the field value |
Image width and height should match the intended size in the ads created for the campaign, in the case these fields are left empty a default size of 128px x 128px will be used.
The preferred interval for syncing the feed is every day.
Advertiser feed parameter mappings
To accurately map the values from the feed to the parameters the platform uses internally a mapping needs to been done and this mapping differs a bit depending on the format the feed uses.
Bidtheatre column type | Description |
prod_id | The unique product ID |
prod_url | The product URL used for matching products |
img_largest | The image URL that should be used in the ad |
Mappings for CSV-feeds
When the feed is created just click the columns-link to start the mapping. In CSV-feeds all product data is located on one row separated by some delimiter. Enter the column number on the left hand side and what kind of information the column contains on the right hand side.
Mappings for XML-, RSS- or JSON -feeds
Click the params-link and start by entering a product property from the feed as Name and then what that property should be match to in the Column Type-column. Repeat this for all product properties available in the feed.
Advertiser feed filters
Filtered targeting based on a particular value on some product property is supported. Create a filter by clicking the Edit filters-link and give the filter a name. Once that is done click the Edit settings-link, choose what column type you want to filter on and what value you want that column type to be.
Checklist
Verify that the advertiser feed correctly covers the product inventory that you want to used in your ads
Verify that the advertiser feed is synced, and that products are available in the json-file. A link to the json-file is located in the GUI.
Verify that special characters such as åäö are seen correctly in the json-file.
Verify that images are seen in the images.json file located at http://cdn.bidtheatre.com/feeds/images.json
Verify that images are properly downloaded to the server. Based on the directory and imageId fields in images.json mentioned above the product image should appear at a url following this pattern: http://cdn.bidtheatre.com/feedimages/[directory]/[imageId].jpg. One real world example of this would be http://cdn.bidtheatre.com/feedimages/8597/134202.jpg. Note that it could take some time before all images have been downloaded to the server.