Expose native image-type asset dimensions on bid response object

[matthewlane]

Type of change

• Feature

Description of change

Currently if a native bidder returns an image-type asset (image or icon), the url for that asset is set to the image or icon property on the bid response native object:

// in a bidder adapter's interpretResponse function...
bid['native'] = {
  title: serverResponse['native'].title,
  image: serverResponse['native'].img.url,
  icon: serverResponse['native'].icon.url,
};
// ...

If a native bidder also provides a width and height associated with an image-type asset, the bidder can now set those dimensions on the native bid response object using an object instead of a string:

bid['native'] = {
  title: serverResponse['native'].title,
  image: {
    url: serverResponse['native'].img.url,
    height: serverResponse['native'].img.height,
    width: serverResponse['native'].img.width,
  },
  icon: serverResponse['native'].icon.url,
};

As the above example shows, setting native.image or native.icon to a url string will continue to work. The targeting key hb_native_image will be set with the value of image.url if image is an object, or the value of image if image is a string (and likewise for hb_native_icon / icon).