iBillboard is an ad server where you can easily manage campaigns either ordered directly by your advertisers or purchased via automated advertising markets. You will get complete reporting of the fill rate of your inventory, automatic watching of set goals, and invoicing data.
Segment definitions in iBillboard
According to the open documentation, iBillboard doesn't provide any API to inject segment definitions on the server side.
Passing segment membership data to iBillboard
The tag below uses persisted queries to obtain the set of segments the current user belongs to.
Then it makes a pixel request to iBillboard to let them know the segment membership status for a certain user - each segment ID separated by a dash ('-'). Each time this call is made to iBillboard, any existing segment membership is erased.
To avoid too frequent calls to iBillboard, the cookie ib_synced is set for a duration of 60 seconds.
cX.callQueue.push(['invoke', function () {
if (document.cookie.indexOf('ib_synced') === -1) {
cX.getUserSegmentIds({
'persistedQueryId': "your persistedQueryId",
'maxAge': 0,
callback: function (segments) {
if (segments && segments.length > 0) {
var ib_pixel = document.createElement("img");
ib_pixel.src = (location.protocol == 'https:' ? 'https:' : 'http:') + '//bbnaut.ibillboard.com/tag/cxense/value/' + segments.toString().replace(',', '-');
document.body.appendChild(ib_pixel);
document.cookie = ("ib_synced=1; max-Age=60; Path=/");
}
}
});
}
}])
Managing persisted queries in Piano Audience
PersistedQueryId is a unique identifier for a persisted query that is created by Piano's Project or Account manager.
Create a persisted query as described here. and copy the ID from the Overview table.
A noticeable feature of the iBillboard structure is that iBillboard segments do not have any names. For segment matching, unique segment IDs are used.