Back to Bidders

Native Agents

Features

Native Agents Bidder Adapter

The Native Agents bidder enables publishers to monetize their inventory through the Native Agents advertising platform using either Prebid.js or Prebid Server.

Registration

Before integrating the Native Agents bidder, your inventory must be configured within the Native Agents platform.

During onboarding, Native Agents creates:

• A Supply Source representing your website or mobile application.
• One or more Placements representing individual ad locations on your inventory.

Each Placement receives a unique placementId, which is used by the bidder to identify the inventory during bidding.

Depending on your account configuration, Native Agents may instead provide an endpointId.

Only one identifier is required when configuring the bidder.

For onboarding and production credentials, contact your Native Agents account representative.

Bid Parameters

Specify either placementId or endpointId.

Do not provide both.

*One of placementId or endpointId is required.

Banner Example

var adUnits = [{
    code: "banner-div",

    mediaTypes: {
        banner: {
            sizes: [
                [300,250],
                [300,600]
            ]
        }
    },

    bids: [{
        bidder: "ntvagents",

        params: {
            placementId: "100001"
        }
    }]
}];

Native Example

var adUnits = [{
    code: "native-div",

    mediaTypes: {
        native: {
            ortb: {
                assets: [
                    {
                        id: 1,
                        required: 1,
                        title: {
                            len: 100
                        }
                    },
                    {
                        id: 2,
                        required: 1,
                        img: {
                            type: 3,
                            w: 300,
                            h: 250
                        }
                    },
                    {
                        id: 3,
                        required: 1,
                        data: {
                            type: 1
                        }
                    }
                ]
            }
        }
    },

    bids: [{
        bidder: "ntvagents",

        params: {
            placementId: "100001"
        }
    }]
}];

Video Example

Both Instream and Outstream video contexts are supported.

var adUnits = [{
    code: "video-div-instream",

    mediaTypes: {
        video: {
            context: "instream",
            playerSize: [640,480],
            mimes: ["video/mp4"],
            protocols: [2,3,5,6],
            api: [2],
            minduration: 5,
            maxduration: 30,
            linearity: 1
        }
    },

    bids: [{
        bidder: "ntvagents",

        params: {
            placementId: "100001"
        }
    }]
}];

var adUnits = [{
    code: "video-div-outstream",

    mediaTypes: {
        video: {
            context: "outstream",
            playerSize: [640,480],
            mimes: ["video/mp4"],
            protocols: [2,3,5,6],
            api: [2],
            maxduration: 30,
            linearity: 1
        }
    },

    bids: [{
        bidder: "ntvagents",

        params: {
            placementId: "100001"
        }
    }]
}];

OpenRTB Support

The Native Agents bidder converts Prebid bid requests into OpenRTB bid requests before forwarding them to the Native Agents bidding platform.

The adapter supports OpenRTB requests for:

• Banner
• Native
• Video (Instream & Outstream)

using the corresponding OpenRTB object definitions.

Creative Rendering

The Native Agents bidder returns creatives compatible with standard Prebid rendering workflows.

Supported creative formats include:

Banner and Native creatives are rendered using Prebid’s standard rendering pipeline.

Video responses return VAST-compatible creatives suitable for both instream video players and supported outstream video players.

User Sync

Native Agents supports both iframe and image user synchronization.

pbjs.setConfig({
    userSync: {
        filterSettings: {
            iframe: {
                bidders: ["ntvagents"],
                filter: "include"
            },
            image: {
                bidders: ["ntvagents"],
                filter: "include"
            }
        }
    }
});

User synchronization is performed only when permitted by applicable privacy regulations.

Test Parameters

Native Agents provides test placements during onboarding.

Replace the example values below with the test identifiers supplied by your Native Agents account representative.

{
    bidder: "ntvagents",

    params: {
        placementId: "100001"
    }
}

Notes

• Configure either placementId or endpointId.
• Banner, Native, and Video (Instream & Outstream) are supported.
• Compatible with both Prebid.js and Prebid Server.
• Inventory must be configured within the Native Agents platform before bid requests can be made.
• Native Agents also supports Direct Tag and JavaScript tag integrations outside of Prebid. Refer to the Native Agents integration documentation for those integration methods.

"Send All Bids" Ad Server Keys

Back to Bidders