Intent IQ

Features

Description

By using this Intent IQ adapter, you will be able to obtain comprehensive analytics and metrics regarding the performance of the Intent IQ Unified ID module. This includes how the module impacts your revenue, CPMs, and fill rates related to bidders and domains.

Intent IQ Universal ID Registration

No registration for this module is required.

Intent IQ Universal ID Configuration

IMPORTANT: only effective when Intent IQ Universal ID module be installed and configured. (How-To)

No additional configuration for this module is required. We will use the configuration provided for Intent IQ Universal IQ module.

Example Configuration

pbjs.enableAnalytics({
    provider: 'iiqAnalytics'
});

Manual Report Trigger with reportExternalWin

The reportExternalWin function allows for manual reporting, meaning that reports will not be sent automatically but only when triggered manually.

To enable this manual reporting functionality, you must set the manualWinReportEnabled parameter in Intent IQ Unified ID module configuration is true. Once enabled, reports can be manually triggered using the reportExternalWin function.

pbjs.setConfig({
    userSync: {
        userIds: [{
            name: "intentIqId",
            params: {
                partner: 123456,     // valid partner id
                browserBlackList: "chrome",
                manualWinReportEnabled: true
            }
        }]
    }
});

You can find more information and configuration examples in the Intent IQ Universal ID module

Calling the reportExternalWin Function

To call the reportExternalWin function, you need to pass the partner_id parameter as shown in the example below:

window.intentIqAnalyticsAdapter_[partner_id].reportExternalWin(reportData)

Example use with Partner ID = 123455

window.intentIqAnalyticsAdapter_123455.reportExternalWin(reportData)

Function Parameters

The reportExternalWin function takes an object containing auction win data. Below is an example of the object:

var reportData = {
biddingPlatformId: 1, // Platform ID. The value 1 corresponds to PreBid.
partnerAuctionId: '[YOUR_AUCTION_ID_IF_EXISTS]', // Auction ID, if available.
bidderCode: 'xxxxxxxx', // Bidder code.
prebidAuctionId: '3d4xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8e', // PreBid auction ID.
cpm: 1.5, // Cost per thousand impressions (CPM).
currency: 'USD', // Currency for the CPM value.
originalCpm: 1.5, // Original CPM value.
originalCurrency: 'USD', // Original currency.
status: 'rendered', // Auction status, e.g., 'rendered'.
placementId: 'div-1' // ID of the ad placement.
}

To report the auction win, call the function as follows:

window.intentIqAnalyticsAdapter_[partner_id].reportExternalWin(reportData)