PMP Troubleshooting Playbook

Document created by alynn.beyder on May 14, 2018Last modified by alynn.beyder on Aug 16, 2018
Version 18Show Document
  • View in full screen mode

Common Issues with PMPs

  1. Deal is not active/live (in both PubMatic's UI and the DSP platform)
  2. Insufficient volume on the Deal ID (e.g., selected inventory from the publisher or site)
  3. Error in the Deal ID (e.g., space or special character, sometimes lower case in the Deal ID is not identified)
  4. Mismatched targeting settings (e.g., geo, ad size/formats, whitelisting, budget, frequency capping, flight dates) between PubMatic and the buyer
  5. Low deal bid eCPM (e.g., bidding below the floor or losing out in the PMP auction)
  6. Lost bids due to blocklist/deal whitelisting in PubMatic UI
  7. DSP is not responding with the correct Deal ID
  8. Advertiser domain is categorized into blocked IAB category
  9. Incorrect buyer is mapped or incorrect buyer seat ID
  10. Low/no bid requests or response rate
  11. Incorrect whitelisting results in advertiser URL directing to unintended landing page (e.g., a Good Food & Wine Show advertiser is directing to a ticket sales landing page, such as TicketMaster)

Troubleshooting Deal IDs within the PubMatic Publisher UI

If your Deal ID is not working, please run through the below checklist to ensure that all settings are correct in the PubMatic Publisher UI:

 

Is the bid request from PubMatic going out to the DSP for the PMP deal? If no:

   Check if PubMatic is seeing impressions from the publisher on the tags where the deal is targeted

   Check if the campaign for the region/geo where the deal is targeted is mapped to the site linked with the deal

   Check with whomever sourced the deal (publisher, buyer or DSP) to make sure that the buyer seat ID was used correctly

   Check other settings in the Product and Deal listed below:

  • Sections
  • Ad Formats
  • Ad Sizes

Is the bid request from PubMatic going out to the DSP for the PMP deal but lower than expected? If yes:

   Check if the DSP is re-targeted where the bid request is sent for a cookie matched user only

   Check if the deal is geo targeted, as this can often mean too narrow targeting

   Check if all tags are mapped to the Product

Is there no bid response from the DSP?

   Check with the buyer to see if they are seeing the bid requests for the deal coming from PubMatic

  1. If yes, then the buyer needs to start sending the response for the deal
  2.               If no, then the buyer needs to check the targeting on their end and make changes in order to see the bid requests

If the win rate for bid responses is non existent or low, run the below checks:

   Check if any of these bid responses are being reported as blocked bids under any of the below mentioned filters:

  1.        Blocklist (landing page URL): make sure that the domains for which the bids are coming through can be removed from the blocklist
  2.        Auction: bids for the deal are losing in auction to other DSP bids. In this case, priority can be changed for deals to tweak the performance as per individual publisher requirement
  3.        Floor: check if the bid eCPM from the DSP for the deal is below the deal eCPM
    1. If yes, then reach out to the DSP and have them correct that
    2. If no, then check for any rule which is higher in priority and eCPM as compared to the deal
  4.        Creative: check why the creative was blocked and make changes as per the publisher requirement

    If nothing is reported in any of the above filters, run the below checks:

  1.       If the publisher has a multi-level auction, then the bids are losing in the publisher auction
  2.       Reach out to your PubMatic account manager for further troubleshooting

 

NOTE: If the total number of impressions on a PubMatic Site is fewer than 5,000 during the last 30 days, PubMatic will automatically deactivate all of the demands for this Site. The demands will be automatically reactivated if this Site reaches 5,000 total impressions for the past 30 days. If all Sites targeted in your deal do not have demands associated, your deal will not deliver.

 

Troubleshooting Deal IDs within the DSP

While every DSP is different, there are some common helpful approaches to troubleshooting Deal IDs. If your Deal ID is not working, please run through the below checklist to ensure that all settings are correct in your DSP:

 

Deal ID Creation: 

   Is the Deal ID correctly entered into the DSP and live? Double check all characters, letters and numbers to ensure that they match exactly to       the Deal ID originally received from PubMatic.

    Ensure the correct exchange is selected (e.g, PubMatic).

Line Item Settings: 

    If applicable to your DSP, ensure that your Deal ID is on a separate line item.

    Check your targeting needs from PubMatic to make sure that you are targeting the Deal ID under inventory and no mismatch targeting is       applied.

Frequency Cap Settings:

    Review your frequency cap - is it too restrictive?

Line Item Spend Settings: 

    If you're not responding enough to the Deal ID, ensure that your line item is set to "ahead" or "aggressive" where possible.

Competing Line Items: 

    Are there other line items that are taking budget from the Deal ID line item?

    Are the other line items on a more aggressive spend setting or delivery priority? 

Viewability Settings:

           Is the viewability setting impacting scale?

 

Set Up, Troubleshooting and Best Practices for DBM

If using DBM to run PMP Deals with PubMatic, please follow the below best practices and take note of top deal spend blockers to help troubleshoot deals.

 

 Provided by DoubleClick. Refer to Add an inventory source to Bid Manager - DoubleClick Bid Manager Help  for additional information.

 

DBM's Best Practices

  1. Target one deal per line item for a quick view of performance, easy troubleshooting, and more control over the bid, targeting and creatives
  2. Do not target deals and open exchange in the same line item
  3. Always bid higher than the floor price to avoid currency fluctuations 
  4. Always use fixed bidding on deals
  5. Use minimal targeting to prevent blocking spend
  6. Verify that the buyer is passing User IDs (if not, then you cannot use frequency capping or audience lists within DBM)
  7. Check that creatives are approved for the correct SSP (PubMatic)

 

Top Deal Spend Blockers

  1. Blocks on creative categories, tech vendors, data and cookie settings 
  2. Outbidding 
  3. Narrow targeting
  4. Creative requirements (SSL, VPAID) that are not supported/accepted by the publisher
  5. Inventory mismatch
  6. Lack of inventory from publisher
  7. Creative approvals 
  8. Incorrect landing page mapping
  9. Setup errors

 

Set Up PubMatic Deal in DBM

  1. In the inventory tab, click on the My Inventory section then click on the New button at the top of the page and select New non-guaranteed inventory.
  2. Enter the details in the New Inventory Source box (Name, Floor Price and Dates in the UI are purely for information and do not have any impact of the deal):
    • Use a naming convention that describes the deal
    • Select PubMatic as the exchange
    • Enter the Deal ID
    • Enter the Floor Price
    • Type of deal (Preferred or Private auction)
    • Add the partner/advertiser in the Inventory access field
 
 3. Once your deal is created, you can set up your campaign. Under Inventory Source in Targeting, you will see three tabs: Public Inventory, Private Deals and Automatic Deals. Select the Private Deals tab and search for the deal you just created and select it.
 4. Set up the rest of your line items as normal

 

PubMatic's PMP Troubleshooting Recommendations

If you suspect issues with your PMP deal, please first log into the PubMatic Media Buyer Console (MBC) and click the Deal Name to view its Deal Health to see how that deal is performing for the specified date range. If any issues are identified, they will be listed within the analytics dashboard. If you are still unable to troubleshoot fully, please reach out to your PubMatic account manager for further assistance. 

Refer to Reviewing Deal Performance in MBC  for more detail and instructions.




 


 

Issue 1: You check deal performance in the PubMatic MBC and see that you are not responding to bid requests

  • Email your PubMatic account manager to troubleshoot with the correct Deal ID
  • Refer to DSP troubleshooting steps (above) and ensure that there are no issues with campaign setup within the DSP

Issue 2: You check deal performance in the PubMatic MBC and see that bid responses are being blocked

  • Email your PubMatic account manager to troubleshoot with the correct Deal ID
  • The below are common reasons that PubMatic sees bids being blocked:
    • Blocked (FF) - Deal ID Floor eCPM
      • Bid lost as the bid value sent by the DSP was below the floor set for this Deal ID
    • Blocked (DW) - Deal Whitelisting
      • Bid lost as the advertiser's category/name/domain associated with the bid response was not included in this deal's whitelist
      • Exact domain may not be whitelisted for the Deal ID - verify if you are bidding for unapproved domain for the Deal ID
    • Blocked (LB) - Low Bid
      • Bid value sent by the DSP is too low
    • Blocked (LPF) - Landing Page Filter
      • Domain is in the publisher's blocklist, where the opportunity is to enable the deal whitelisting to override the blocklist if neededOther auction blocks may occur but not be pulled into the MBC

Attachments

    Outcomes