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.

Did this answer your question?