Request and Response Overview

ad request/response protocol the pentaleap fluid relevancy engine is an adserver api is used to request and receive ads from connected demand sources ad unit ids are provided to you from your own publisher manager ui page context is passed by sharing information such as organic products, search queries and categories as relevant; you may also specify additional products and categories to be in scope for sponsorship multiple ad units can be called in a single request, and sponsored product and display/sponsored brand type units are also called in the same request format for full specification, please check out the api specifications with examples for sponsored products and display ads in the respective sections important please check out the adserver faq section to understand some common behaviours and rules of the ad response sample request structure the response includes both sponsored product and display ads { "user" { "id" "string", }, "adunits" \[ { "adunitid" "string", "searchquery" "string", "products" \[ { "gtin" "string", "ignorebid" false, "pinned" false, "ext" { "attr1" "val1", "attr2" "val2" } } ], "categories" { "current" "string", "additional" \[ "string" ] }, "additionalproducts" \[ { "gtin" "string" } ], "demandsources" { "spa" { "demand source 1" { "947081" { "bid" 2 3, "beaconurls" \[ "https //demand source 1 com/tracking/impression/947081" ], "clickurls" \[ "https //demand source 1 com/tracking/click/947081" ] } } } }, } } ] } the response returns sponsored and in some cases organic content to be rendered, plus additional information required for rendering and reporting sample response { "adunits" \[ { "adunitid" "string", "positions" \[ { "gtin" "string", "sponsored" false, "kind" "string", "ext" { "attr1" "val1", "attr2" "val2" } }, { "gtin" "string", "sponsored" true, "kind" "string", "beaconurls" \[ "string" ], "clickurls" \[ "string" ], "ext" { "attr1" "val1", "attr2" "val2" } }, { "sponsored" true, "kind" "string", "targeturl" "https //www example com", "banner" { "300x250" { "asseturl" "https //www example com/image 300x250 jpg", "beaconurls" \[ "https //www example com/tracking/impression/image 300x250" ], "clickurls" \[ "https //www example com/tracking/click/image 300x250" ] }, "728x90" { "asseturl" "https //www example com/image 728x90 jpg", "beaconurls" \[ "https //www example com/tracking/impression/image 728x90" ], "clickurls" \[ "https //www example com/tracking/click/image 728x90" ] } }, "ext" { "attr1" "val1", "attr2" "val2" } } ] } ] }