DOCUMENTATION
« Documentation home

Dynamic Ad Data Feeds

Introduction

When an ad is dynamically generated based on some viewer attribute (e.g., viewer looked at a product SKU and is being retargeted) or contextual cue (e.g., viewer is in a particular ZIP code), Canned Banners needs some list of content to select a message from. That list of content choices or ad messages is called a Data Feed.

A Data Feed might contain different data depending on the industry and use-case.

Use case Data feed description
E-commerce Product feed
Automotive Dealership inventory
Travel Flight or hotel availability & and pricing, origins/destinations, travel offers
Deals Current deals & offers
Real estate Property listings
Events Concerts, games, and festivals
Job recruiting Open positions
Franchises and chains Locations

Data Feed file format

The Canned Banners platform can import CSV, XML, or JSON files. CSVs can have any standard delimiter (comma and tab being the most common).

Data Feed uploads

You have two options for how to send your data feed to Canned Banners:

Option 1: FTP Upload

You can upload your Data Feed file(s) to Canned Banners via FTP. Uploads require the uploading IP address to be whitelisted, as well as a username/password that will be provided during campaign setup. Full documentation is available for Canned Banners clients.

Option 2: Hosting

You can host your data at a fixed location. The Canned Banners platform will download your data feed from this location at a regular interval (e.g., once per day). The location can be a public URL, a password-protected URL, or an FTP site. Read our post explaining how to host your Data Feed using Google Sheets.

Data Feed caching

Canned Banners will cache your Data Feed, and your ads will run off the cached Canned Banners version of your Data Feed, so for hosted Data Feeds, you don't need to worry about your Data Feed server supporting high traffic loads from your ads.

Data Feed import setup

Setting up your import and mapping the fields from your Data Feed to the Canned banners platform will be done by Canned Banners. All we need is the location of your data feed and we'll do the rest.

Data integrity

Every feed must have a Unique Identifier (Unique ID). In a product feed, this would commonly be a SKU. In a data feed of vehicle inventory, the Unique ID might be the VIN.

Sample XML data feed

Below is a sample XML data feed.

<?xml version="1.0" encoding="utf-8"?>
<products>
   <product>
      <id>101</id>
      <title><![CDATA[Small Widget]]></title>
      <description>
      <![CDATA[The Small Widget is the smallest.]]>
      </description>
      <price currency="USD">9.99</price>
      <image><![CDATA[http://cdn.widgets.com/101.jpg]]></image>
      <url><![CDATA[http://widgets.com/shop/small]]></url>
      <categories>
         <category>Widgets</category>
         <category>Small Things</category>
      <categories>
   </product>
   <product>
      <id>102</id>
      <title><![CDATA[Medium Widget]]></title>
      <description>
      <![CDATA[The Medium Widget is medium-sized.]]>
      </description>
      <price currency="USD">19.99</price>
      <image><![CDATA[http://cdn.widgets.com/102.jpg]]></image>
      <url><![CDATA[http://widgets.com/shop/medium]]></url>
      <categories>
         <category>Widgets</category>
         <category>Medium Things</category>
      <categories>
   </product>
   <product>
      <id>103</id>
      <title><![CDATA[Large Widget]]></title>
      <description>
      <![CDATA[The Large Widget is the largest.]]>
      </description>
      <price currency="USD">29.99</price>
      <image><![CDATA[http://cdn.widgets.com/103.jpg]]></image>
      <url><![CDATA[http://widgets.com/shop/large]]></url>
      <categories>
         <category>Widgets</category>
         <category>Large Things</category>
      <categories>
   </product>
</products>

Sample CSV data feed

Below is a sample CSV data feed. Note that actual CSVs are just text files, so the formatted table below is for purposes of illustration.

product_id title description currency price image url category1 category2
101 Small Widget The Small Widget is
the smallest.
USD 9.99 http://cdn.widgets.com/101.jpg http://widgets.com/shop/small Widgets Small Things
102 Medium Widget The Medium Widget is
medium-sized.
USD 19.99 http://cdn.widgets.com/102.jpg http://widgets.com/shop/medium Widgets Medium Things
103 Large Widget The Large Widget is
the largest.
USD 29.99 http://cdn.widgets.com/103.jpg http://widgets.com/shop/large Widgets Large Things

Additional resources

Below are a few additional resources and reference materials.

Contact us to learn more about the Canned Banners Dynamic Ads platform.

CONTACT US