Dynamic HTML5 Creatives

Dynamic creatives are used for campaigns that make use of an advertiser feed to track individual products seen by users and then displays them back to the user in the creative.

Dynamic creatives are essentially a normal HTML5 creative with the required additional functionality of reading a JSON-object of seen products provided to the creative impression time and displaying them inside the creative. Think of it as a more advanced form of retargeting. 

The creatives should ideally be prepared to receive several products, and rotate between them. The number of products sent to the creative may vary, so the creative should be prepared to handle any number of products and still display correctly. Upon invocation the creative will receive information of the number of products that are to be displayed. 

Even if no products are provided to the creative, something that could occur during the creative audit phase, the banner must still click through to the advertiser's site.

The creative should either scale product images to fit, or be prepared to receive an agreed dimension on all images.

Product information

The seen advertiser products are provided to the creative in the form of a JSON-object. The individual field names are configurable but we recommend to use the defaults listed in the example below. 

{
   "products":[
      {
         "price":"$100",
         "desc":"Nice shirt",
         "name":"Shirt",
         "image":"https://creatives.bidtheatre.com/feedimages/1/2.jpg",
         "product_url":"https://adsby.bidhteatre.com/click?a=1&url=https%3A%2F%2Fwww.advertiser.com%2Fproduct1"
      },
      {
         "price":"$50",
         "desc":"Cool shorts",
         "name":"Shorts",
         "image":"https://creatives.bidtheatre.com/feedimages/2/3.jpg",
         "product_url":"https://adsby.bidhteatre.com/click?a=1&url=https%3A%2F%2Fwww.advertiser.com%2Fproduct2"
   ],
   "meta":{
      "product_cnt":2
   }
 }

The JSON listed above can be retrieved inside the creative by using our helper script in the following way

<script src="https://adsby.bidtheatre.com/js/asxhtml5.min.js"></script>

<script>
  var jsonProducts = asxhtml5.getDynamicProducts();
</script>

Example

For a small, yet complete, example on how the products can be retrieved see this file. 

Upload

These creatives are uploaded into ASX exactly the same way as HTML5 creatives with the following addition, once the creative is uploaded, you must assign an "ad target template". If the naming convention used is the same as in the JSON-example above (price, desc, name, image, product_url) you can use the available template called "Standard Dynamic Ad" and you're done. If you have used custom names you must create an own template mapping our fields to whatever the creative uses internally.