AVI Platform
On-Stream

Direct Integration

Web Environment

Qortex On-Stream can be configured  to utilize a custom supply stream while still providing the unique On-Stream ad opportunities. For this type of integration, a link will need to be established between the Qortex overlay and the header bidding stack. In this example we are using prebid.js and GPT ad slots, which we assume you have already set these technologies up in your ad stack. Our code is also deployed through prebid, so the integration should be very similar to other partners.

Phase 1 - Qortex Code Implementation

Visit the Customize and Download Prebid.js Page. Select “Qortex” under the “Select Bidder Adapters” section and “Qortex RTD Module” under the “Vendor-Specific Modules” section, and then download.Add the Qortex prebid adapter and the Qortex RTD Module to your prebid.js code. Note: The Qortex prebid adapter requires a zone ID and host name, which you will receive from your Account Manager.Add your groupID and videoContainer, and configure the RTD specific code into your prebid configuration. Group ID: Contact your account manager to obtain a group-id.videoContainer: This is the ID or name that contains your video player.

  • Visit the Customize and Download Prebid.js Page. Select “Qortex” under the “Select Bidder Adapters” section and “Qortex RTD Module” under the “Vendor-Specific Modules” section, and then download.

  • Add the Qortex prebid adapter and the Qortex RTD Module to your prebid.js code.

    1. Note: The Qortex prebid adapter requires a zone ID and host name, which you will receive from your Account Manager.
  • Add your groupID and videoContainer, and configure the RTD specific code into your prebid configuration.
  • Group ID: Contact your account manager to obtain a group-id.
  • videoContainer: This is the ID or name that contains your video player.
pbjs.setConfig({
    realTimeData: {
        auctionDelay: 1000,
        dataProviders: [{
            name: 'qortex',
            waitForIt: true,
            params: {
                groupId: '[GROUP-ID]',
                tagConfig: { 
                    videoContainer: '[MY-VIDEO-CONTAINER]'
                }
            }
        }]
    }
});

Phase 2 - GAM Ad Unit Creation and Line Item Targeting

GAM Ad Unit Creation:In your GAM account, select “Inventory” → “Ad Units” from the left hand navigation. Click the “New ad unit” button on the top left of the Ad Units main page and enter the follow:  

  • For “code”, enter cx-on-stream.  
  • Select the following supported sizes under the “Sizes” section:
300x250
468x60
300x600
728x90
320x50
336x280
970x90
160x600
234x60

Click the Save button when completed.  Click the “Tags” tab and select “Google Publisher Tag” and hit continue twice so you are at “Tag Results”.  Make note of the ad unit path, this is the value within the “googletag.defineSlot” section of the generated code.  It should have the format:

/<your-gam-account-id>/cx-on-stream
 (ie “/1234567890/cx-on-stream”)

Phase 3 - Connect Your Prebid Bidders to Fill Into On-Stream

Provide Qortex with the bidders and corresponding parameters and IDs  that you wish to fill into the Qortex adSlot. This should follow the standard prebid “bids” object defined here. Below is an example of what this could look like.

Don’t copy and paste this as it should be your own unique bidder information.
/<your-gam-account-id>/cx-on-stream
 (ie “/1234567890/cx-on-stream”)
© 2024 Qortex