Amazon Publisher Services Transparent Ad Marketplace (APS TAM) Integration for Web Publishers

This article explains how OLV publishers can pass IRIS-enabled values to SSPs they have integrated with APS TAM

Web Publisher Custom Values

APS supports passing custom key values per slot from web publishers. These custom values are not currently supported for mobile app publishers. If you are interested in working with a publisher using these custom values, please loop in your APS account manager before you move forward.

These publisher specified values are forwarded in the BidRequest.imp.ext.kv array. A publisher can send any string as a key and may have multiple values for the same key. This method will pass the key-values on each bid request as they come to APS from the client-side, and are forwarded to all buyers.

Your publisher should reference their resource pages for more details on using the slotParams object to pass these custom values.

Sample key value set by publisher:

apstag.fetchBids({
    slots: [
        {
            slotID: 'div-gpt-ad-1590616883999-0', //Required
            slotName: '/116082170/testpage', //Optional
            sizes: [[300, 250]], //Required
            slotParams: {
                "key": ["value1", "value2"]
            }
        }
    ]
});

Sample key value passed in bid request:

{
    "imp": [
        {
            "id":"987654321",
            "banner":{
                "w":728,
                "h":90
            },
            "ext":{
                "kv":{
                    "key": ["value1","value2"]
                }
            }
        }
    ]
}