Create an Auction Package Deal

PubMatic Auction Package deals are real-time planning tools that allows you to create auction packages at scale: 

  • Ingest data, target preferred publishers, and create PMP deals.
  • Refine deals with PubMatic targeting criteria across multiple publishers.
  • Forecast the reach and impressions of your PMP campaign in real-time during deal creation.

Create an Auction Package deal

Follow these instructions to create an Auction Package deal in the Media Buyer Console. 

In the Media Buyer Console, select Deals > Deals > Create Auction Package Deal.

Deal Information

Deal Information fields are described in the following table.

Deal information settings



Deal Name

PubMatic suggests this naming convention: Buyer-DSP-InventoryDescription-StartDate(MMDDYY)

For example: GroupM-TTD-HighViewability-070418

Transaction Dates

There are two options:

  • Select a Start Date and End Date

  • Select a Start Date and Ongoing. The deal will run until you pause it.


Select up to 10 buyers and then click Done.

Always on

Always On is a flag for internal use only. Multi-publisher ongoing deals originated by PubMatic, DSPs, or agencies are usually always-on deals. This flag allows PubMatic to apply a default auction fee for publishers under Auction Fee pricing model.


Targeting settings are described in the following tables.

Inventory targeting


There are three options for selecting publishers for your deal:

Publishers included in Auction Package deals must meet the following criteria in the PubMatic system:

Option 1: Maximum Reach (recommended)

This option will get the greatest number of impressions, based on historical data, for your deal. As the deal continues to run, the system will update the publishers to only include the optimized publishers with the highest reach. A list of publishers that match the selected targeting and buyer criteria will appear in a summary at the bottom of the deal details only after a newly-created deal is saved. 

  1. Select Maximize Reach.

  2. Enable Auto-update if you want PubMatic to automatically add new optimized publishers when you've deleted publishers.

  3. Blocklist publishers one of two ways:
    - Click Upload > Download Publishers List. Edit the file and then click Select File to upload. 
    - Click Select and select publishers from the drop-down list. 

Option 2: Upload

  1. Click Upload.
  2. Click Download Publishers List to download a CSV file of the available publishers and Pub IDs. 
  3. Remove the publishers you don't want to include and then save your changes.
  4. Click Select File to upload the CSV file.

Option 3: Select

  1. Click Select.
  2. Select the publishers you want to include.

  3. Click Done.


If you delete a publisher, Auto-update automatically adds a new optimized publisher to fill that spot.

To block publishers from auto-updating, Select from the menu list, or click Download Publishers List and Upload your the list with a maximum of 50 publishers.

Ad Formats

Banner and Native: Targets banner and native creatives. Native can't be selected separately from banner, but if only Native creatives are added, then only Native inventory will be targeted.

Video: Targets video creatives.

When Banner and Native and Video are both selected, detailed video targeting is unavailable. This is because further detailed video targeting settings would negatively limit banner and native inventory. For additional video targeting, either deselect Banner and Native or create separate deals for both ad formats.


Select the platform(s) you want to target. For example, desktop, mobile web, CTV, etc.

When Desktop is selected, Mobile targeting is unavailable. This is because mobile targeting limits desktop inventory. If you want to choose mobile targeting, either deselect desktop or create a separate deal.

Ad Sizes

Select Any or Select. You can choose up to 1,000 ad sizes per deal. To learn more, see How ad sizes are reported.

Mobile targeting

OM SDK Support

Enable this to target mobile apps that support IAB Open Measurement SDK.


Enable this to target by latitude and/or longitude.

Device Id Type

Target all device types or select specific ones from the list.

Mobile OS

Target all mobile operating systems or select specific ones from the list.


Target all browsers or select specific ones from the list.

Video targeting

Placement Type

  • In-Stream: played before (pre-roll), during (mid-roll), or after (post-roll) the streaming video content that the consumer has requested.

  • In-Article: loads and plays dynamically between paragraphs of editorial content; existing as a standalone branded message.

  • In-Banner: exists within a web banner that leverages the banner space to deliver a video experience as opposed to another static or rich media format.

  • In-Feed: found in content, social, or product feeds.

  • Interstitial/Slider/Floating: covers the entire or a portion of the screen area, but is always on the screen while displayed, i.e., it cannot be scrolled out of view.

  • Rewarded video : Offers users a reward in exchange for viewing an ad or performing an activity, such as receiving an extra life in a video game or gaining access to a news article. Rewarded ads are full-screen and non-skippable. They display when a user moves from one screen to another, pauses a video game, etc.

Playback Method: Describes the conditions in which the video/audio plays.

  • Auto-play sound off

  • Auto-play sound on

  • Click-to-play

  • Mouse-over

Skippable: Yes, No, Any

Skip Delay:  Enter number of seconds

Skip Delay Override:  Enter number of seconds

Player Size: All, Small, Medium, Large 

Video Ad Formats

Linear: indicates the video ad which runs before, between, or after the video content is viewed by the publisher.

Non-Linear: indicates the video ad which runs parallel to the video content so the publisher still has the option of viewing the content.

Ad Position

Pre-roll: video ad that appears before the video content displays.

In-roll: video ad that appears in the middle of the video content.

Post-roll: video ad that appears after the video content completes.

Playback Method

Select the video/audio playback methods. For example, auto-play on page load with sound off, click-to-play, and mouse-over.

VPAID Compliance

VPAID (Video Player-Ad Interface Definition) is an IAB standard that allows a video ad and a video player to communicate with each other. VPAID defines a uniform run-time environment so that a compliant player can accept any compliant advertisement from any other party.


Skippable video ads allow viewers to skip an ad after a set amount of time. Select Enabled, Disabled, or No Preference.

Skip Delay: Enter number of seconds

Skip Delay Override: Enter number of seconds

Minimum Player Size

Select Small, Medium, or Large.

Geography targeting


Select Include if you want your ads to show only in specific geographical regions. Select Exclude to prevent your ads from showing in specific regions.

Then select from the list of geographies.

IAB Category targeting

IAB Categories

Select categories from the list


Select Include if you want to target ads from specific IAB categories. Select Exclude to prevent ads that from specific IAB categories.

Audience targeting


Audience targeting can include a buyer's first-party audiences, publisher's first-party audiences, and PubMatic audiences. To find a specific provider, use the Search box or select from the Provider list.

PubMatic data is global. We recommend you add Geo-targeting if you want to target users of a specific country.


Select Include if you want to target specific audiences.

Select Exclude to prevent ads from showing to specific audiences. Only first-party audiences without a price ($0) can be excluded.

Click include (or exclude) to add an audience to the deal.

Imp Avail.

Click show data to see how many impressions are available for an Audience. This number includes the targeting selected for publisher, ad format, platform, and geography.

Override Audience CPM Deal

The deal-level data CPM feature allows data providers to override the default price for an audience in a given deal.   

  • The data CPM set for a deal will apply to all audiences included for a deal.  

  • The price can only be overridden for audience directly owned by the account.

  • Deal CPMs can be edited while a deal is inflight, and it will take immediately effect.

To enable the Override Audience CPM Deal:

  1. Add the audiences you want to be included in a deal. 

  2. Toggle the Override CPM for Deal button to Yes.  

  3. Input new CPM to be used for all audience in deal.    

The deal summary will also reflect that the audience price has been overridden for each deal.

Viewability targeting


Viewability targeting allows you to create deals that target only impressions that meet a minimum level of predicted viewability. For example, if you want to target impressions that are at least 80% likely to be viewable, select 80% or greater from the list. Included Viewability appears in the Summary panel on the right. 

Viewability thresholds are predicted based on historical data provided by our viewability partners, Moat and Pixelate. We're integrated with Moat to measure video ads and Pixelate to measure banner ads in both web and app environments. It's important to remember that viewability thresholds are not a guarantee of viewability.

Banner ads are fully supported in both web and app environments; video ads are supported in web environment and certain apps. For a video ads in-app environment, you should target the deal to the apps supported for viewability.  

Keep in mind that deals with a higher viewability threshold will result in fewer matches. To increase your match rate, try lowering the viewability threshold. You can adjust this setting at any time.

Domain and app targeting

Match Type

Broad Match: This is the most flexible match type because it matches all URLs/app bundles that contain the strings specified in deal targeting. Broad Match matches the URLs and app bundle IDs that contain a set of characters you specify for targeting. This set of characters is called a substring. Broad Match is ideal for targeting entire sites, apps or keywords that appear in page URLs/app bundle IDs.

Simple Match: This match type looks for the URLs, app bundle IDs or app IDs you specify in deal targeting. The traffic must be from the exact pages, apps specified but this match type ignores query parameters, hash or anchor tags, protocol and trailing slashes, and WWW in the URL because adding query or hash parameters doesn’t generally change the pages. It's ideal for targeting single pages.

Exact Match: This match type looks only for URLs, app bundle IDs, or app IDs that are exactly what you specify in deal targeting.

To learn more, see Domain and app targeting.


Select Include if you want to target specific domains/apps.

Select Exclude to prevent ads from showing to specific domains/apps.


Select Manual Input to list apps in the field. This field accepts a max of 100 items. To enter more, use the bulk upload feature.

  • For Android, enter an app bundle ID. For example,
  • For iOS, enter an app ID. For example, 915056765

Select Bulk Upload if you want to upload more than 100 items.

  1. Click Download Template.
  2. Add your list of domains/apps and save the file to your computer.
  3. Click Select File and choose the file you just saved.
  4. Click Validate. The PubMatic system performs a format validation check of all entries to ensure the formatting is compatible.

To learn more, see Domain and app targeting.

Inventory Summary

The Inventory Summary provides information about the deal's publishers in real-time. 

Inventory summary
Block publishersThis option only is available if you selected Maximum Reach for the publisher in Inventory targeting. The PubMatic system will automatically add a new publisher when you block a publisher.
Remove publishersThis option is only available if you uploaded or manually selected the publishers in Inventory targeting. The PubMatic system will automatically add a new publisher when you block a publisher.
Banner FloorThis column displays the default CPM banner floor price set by the publisher. Use this to help you determine your bidding strategy.   
Video Floor

This column displays the default CPM video floor price set by the publisher. Use this to help you determine your bidding strategy.

Default Priority

The default priority is set by the publisher.

Priority settings are based on channel type (lowest=P16, highest=P1), as follows:

  • PMP Guaranteed: P5 - P7 (default is P5)
  • PMP Preferred: P8 - P10 (default is P10)
  • PMP: P11 - P15 (default is P15)
  • OpenRTB/Auction Packages:  P16
  • Reserved for publisher Direct I/Os = P1-P4

Real-time impression availability

As targeting selections are made, Impression availability will update in real time.

The total number of impressions available is calculated using the historical impression number over the last 30 days for the following deal settings:

  • Publisher
  • Ad Format
  • Platform
  • Geography (country only)
  • Audience

The forecasting does not consider any other targeting criteria selected for the deal. For example, if you chose to exclude Audience targeting, then Audience is not considered either.

Max Total Available Impressions refers to the number of ad requests PubMatic has received from publishers in the last 30 days.

  • Data is not available at the DMA, Region or City level.

  • More than one audience audience may be selected, but the number of impressions available might be inflated due to duplicate impressions across audiences.

View deals

In the Media Buyer Console, select Deals > Deals from the main navigation.

Sorting order

Deals sort in descending order, with the most recently created or edited at the top.

Edit a deal

  1. Click the vertical ellipsis to the left of the deal you want to edit.
  2. Select Edit.
  3. Make the desired changes to the deal.
  4. Click Save Deal.

Deactivate or activate a deal

Auction Package deals with a status of Paused, In Progress or Failed, can be resumed. Auction Packages with a status of Live, Scheduled or In Progress can be paused. 


Publishers can activate or activate buyer-initiated Auction Packages, but cannot edit.
  1. Click the vertical ellipsis to the left of the deal you want to pause or resume.
  2. Select Resume or Pause

⇧ Top

Do you have feedback on this document? Let us know: email us.

Table of Contents