[Feature] Streamlined Buyer and Brand Id's

[Slind14]

Feature

From a publisher perspective it would be great to get access to the buyer and brand id's. A couple of major exchanges (AppNexus, Rubicon, Index..) are already exposing this data but do not follow a common syntax.

Current Situation:

AppNexus (1.x pbjs bid object)

Rubicon (1.x pbjs bid object)

Index (bid respond, not transmitted to pbjs bid object)

Proposal

Major/Minor Version
Optional streamlined/restful declaration for buyer, brand, landing page domain and additional dynamic information.
Breaking Version (2.0)
Network, Agency, Buyer, Brand and primaryCatId become mandatory.

Could look like:

meta: {
    networkId: 34,                          // Network/DSP Id
    networkName: 'Adform'                   // Network/DSP Name
    agencyId: 0,                            // Agency Id
    agencyName: 'direct',                   // Agency Name
    buyerId: 4994,                          // Buyer/Advertiser
    buyerName: 'Volvo',                     // Buyer/Advertiser Name
    brandId: 39342,                         // Brand/Product
    brandName: 'Volvo v40',                 // Brand/Product Name
    primaryCatId: 'IAB2',                   // Primary IAB Sub Category ID
    secondaryCatIds: ['IAB2-3'],            // Secondary IAB Sub Category IDs
    clickUrl: 'https://www.volvocars.com/nl/modellen/model/v40'   // landing page
}

Open to discussions

Are there any other variables/meta information which would/could be valuable for you?

[mkendall07]

Probably should rename domain to clickUrl since that's closer to the industry name.

[Slind14]

Probably should rename domain to clickUrl since that's closer to the industry name.

Does clickUrl always refer to the "landing page" or to the tracking pages in between as well?

[mkendall07]

It depends. Some SSPs will use 2 separate URLS and some combine them (daisy chains style).

[Slind14]

Updated split buyer into buyer and network. AppNexus reports both under buyer and most other exchanges report them separately. We want the lowest level of granularity and aggregate it on pub side if needed.

[Slind14]

Updated added IAB Category ID

[mkendall07]

@Slind14
I updated it a bit. Let me know what you think. I dropped creativeId and DealId because they already exist on bid and I don't think we need to make a breaking change just to move them.

[Slind14]

Looking good. I have added network name for convince. For clarity and order I think it could be of benefit to include the deal and creative id in the meta data, be it by keeping a duplicate in the parent object or depreciating the duplicate with the next breaking version.

[chefbenjamin]

This is a great addition. coming from the publisher side, what are the chances this info can be added into the bids and winning bids scripts ? ie http://prebid.org/dev-docs/troubleshooting-tips.html#see-all-bids-in-the-console and http://prebid.org/dev-docs/troubleshooting-tips.html#see-all-winning-bids-in-the-console The ability to see this would help a great deal in previewing bad creatives and blocking crappy buyers within each of the SSP.

[Slind14]

what are the chances this info can be added into the bids and winning bids scripts

A small addition to the script and you would be set. Though I highly recommend recording the data so you can track down and block bad ads more easily.

[kelvin-chappell]

It would be helpful to distinguish between advertiser and agency, where that information is available. So:

buyerId: 4994,                   // Advertiser/Agency
buyerName: 'name',               // Buyer Name

might become:

agencyId: 4993,
agencyName: 'agName',
advertiserId: 4994, 
advertiserName: 'adName',

Would that be feasible?

[Slind14]

@kelvin-chappell updated it to reflect the additional dimension and added a simple example

[mkendall07]

Small update to match what we did for the long form video competitive separation.

[bretg]

ok, please take a look at https://prebid.org/dev-docs/bidder-adaptor.html and search for meta. Not much but it's a start. Should IAB categories be strings prefixed with "IAB-" or just integers?

[Slind14]

Looks good. Thank you.

[bretg]

Also updated the server-side bidder adapter page -- http://lh.prebid.org:8080/prebid-server/developers/add-new-bidder.html#bid-response-metadata

[bretg]

@Slind14 - we'd like to propose closing out this issue:

1. The PBJS bidder documentation encourages adapters to define these values on the bidresponse https://docs.prebid.org/dev-docs/bidder-adaptor.html
2. Same with the PBS bidder docs - https://docs.prebid.org/prebid-server/developers/add-new-bidder-go.html
3. @gglas is going to open a separate issue to allow publishers to configure whether a certain piece of metadata is required for accepting bid responses.

Do you agree this can be closed, working the enforcement in a separate issue?

[Slind14]

Thank you, @bretg

Is there any chance that it can be made mandatory with the next breaking release?

[bretg]

@Slind14 - we're going to make it optional for publishers to configure whether they want to enforce certain fields for certain bidders. Prebid is not in a position to push the entire industry to supply metadata.

It's conceivable that such opt-in behavior could become default in the distant future.

[ChrisHuie]

closing and moving to #6453