Mapping macros against Pixalate Key Value parameters

During the integrating process, your Customer Success representative will provide a macro mapping form that needs to be filled out for each ad serving platform. The appropriate ad server macro must be provided then submitted to Pixalate for review. Once macros are finalized, Pixalate will generate and provide tags with the macros already inserted for each parameter.

Supported Macro Parameters for Publishers (No AdServer)

Supported Macro Parameters (All)

* IDs which are represented in the ad server. Ad server values must be provided in order to identify and optimize against data as represented in the ad server.

VAST 4.1 Standardized Macros

The following is a list of IAB VAT 4.1 standardized macros supported by Pixalate. 

Supply Chain Object in KV55

The value for the Supply Chain Object (SCO) in serialized form can be passed in "kv55". If kv55 is not already in the tag provided by Pixalate, please add it in as follows

kv55=[SupplyChainObject]

Format

• [SupplyChainObject] should be replaced by a serialized value

The serialization value is composed of two items; 

• • The SupplyChainObject properties
  • SupplyChainNode array

These two items are separated by a bang (“!”) character:

SupplyChainObject}!{SupplyChainNode array}

Properties

• There are two properties:
  • Version
  • Complete

These two values must be included and separated by ‘,’:

ver,complete

• If there are more than one node then each node is also separated by bang (‘!’) character.

asi,sid,hp,rid,name,domain,ext

Example of Multiple Hops with all the properties supplied

"schain" : {

    "ver": "1.0",

    "complete" : 1,

    "nodes" : [

        {

            "asi":"exchange1.com",

            "sid":"1234",

            "hp":1,

            "rid":"bid-request-1",

            "name":"publisher",

            "domain":"publisher.com"

        },

        {

            "asi":"exchange2.com",

            "sid":"abcd",

            "hp":1,

            "rid":"bid-request-2",

            "name":"intermediary",

            "domain":"intermediary.com"

        }

    ]

}

Serialized value:

1.0,1!exchange1.com,1234,1,bid-request-1,publisher,publisher.com!exchange2.com,abcd,1,bid-request2,intermediary,intermediary.com