Delivery Inspector for video

The Delivery Inspector validates video ad tags and simulates ad and ad rule requests while providing additional troubleshooting information. You can use this tool to:

  • Check if video ad tags have all the required parameters.
  • See the request type of a video ad tag (e.g., ad, ad rule, optimized pod).
  • Test which ad rule is returning to an ad rule tag.
  • See which ingested video content applies to a request.
  • Visualize the placement of ads on a piece of video content.
  • See which line item would deliver if you were to request the ad slot again.

You can also share the delivery details with other users in your network.

Troubleshoot video ads (7:38)
Note: Delivery Inspector for video doesn't support features that require context (such as frequency caps) or cookies (such as session ad rules).

Access Delivery Inspector for video

You simply enter a video ad tag to troubleshoot, and DFP provides request and delivery details.

Find the video ad tag

You can find the video ad tag using Chrome Developer Tools or 3rd-party software.

Chrome Developer Tools:

  1. In Google Chrome, navigate to the page with the video ad request.
  2. From the Chrome menu bar, click View and then Developer and then Developer Tools.
    You can also right-click on the page and click Inspect from the dropdown. The Developer Tools panel opens at the bottom of the page.
  3. From the Developer Tools menu bar, click Network.
    • The record button is automatically activated.
    • It’s important that the inspector is in record mode before you refresh the page.
  4. Refresh the page to restart the video ad and collect and view information in the Developer Tools panel.
  5. From the Developer Tools panel, in the “Filter” box, type
  6. Click one of the values in the “Name” column.
  7. To the right of the “Name” column, click the “Headers” tab if it isn’t selected by default.
  8. Next to “Request URL”, copy the entire URL.
    This is the video ad tag you’ll need to access video delivery details below.

3rd-party software:

You can use 3rd-party software tools such as Charles and Fiddler to access browser or mobile device traffic and find the video ad tags. Note that Google does not endorse Charles, Fiddler, or any other 3rd-party tool in any way, and you may use them at your own risk.

Access video delivery details

Once you have the video ad tag, you can troubleshoot in DFP:

  1. Sign in to DoubleClick for Publishers.
  2. Click Delivery and then Troubleshoot
  3. Click the Video subtab.
  4. In the “Enter video tag to troubleshoot” box, paste the video ad tag that you copied from the section above.
  5. (Optional) Click Advanced and enter:
    • Country: Country in which the video ad will be displayed — used for targeting.
    • User agent: A text string sent to the server that identifies the browser, operating system, and environment for targeting.
  6. Click Troubleshoot.
    The troubleshooting information appears on the same page. You can share the details with another user in your network by clicking Share this session above the details.

Analyze the details

In the delivery details that appear on the DFP Troubleshoot page, you’ll see some of the following details:

  • A timeline of the placement of video ads in the content.
    Hover over each break for more information about the positions where the ads have been inserted, ad duration, etc.
  • A summary of the winning ad rule for each break.
    • Click Details to see display-only settings from the ad rule.
    • Click the ad rule ID to view the ad rules page and update settings.
  • A simulation of the ad for each position in the ad rule (labeled as “Standard pod request,” “VAST video ad,” “Pre-roll ad break,” etc.). It can be one ad, a series of ads, or a pod of multiple ads.
    • Click More info to see line item debugging information, with links to additional details as needed.
    • Click Simulate request to help determine why a different ad delivered than the one you expected.

Share the details

You can share the details with users who have access to your network. This allows you to easily collaborate with others to help determine a plan for troubleshooting your line items.

  1. Above the details that appear on the Troubleshoot page, click Share this session.
  2. From the pop-up that appears, click Copy URL.
    The URL is now coppied to your clipboard and ready to be pasted
  3. Send the URL to a user with access to your network.
    Tell the user to paste the URL into their browser.

Simulate ad requests

The Simulate request feature shows which line item would win if you were to request the ad slot again. If an unexpected line item wins the simulation, you can see why. You can then change targeting and tag information to try and get the desired line item to win the simulation.

When you click Simulate request as mentioned above, the following sections appear.

The Simulate request feature doesn’t retain information on page or server state. Therefore, competitive exclusions, roadblocks, and frequency caps won’t match the original request.

“Original request” section

This section recreates how the ad request you selected on the Troubleshoot page actually delivered. It includes:

  • Ad request details: The request and targeting information for the winning line item.
  • Winning line item details: The delivery details for the winning line item.
  • View non-delivery reasons: Click this button to see reasons why other line items were selected to serve over this one in cases that this line item was eligible. Here are details of the possible non-delivery reasons.

“Simulation” section

This section shows what would happen if you were to request this ad slot again. It includes:

  • Ad request details: The request and targeting information for the simulated request. It defaults to the current settings.
  • Winning line item details: The delivery details for the line item that wins the simulation.
  • Search for the line item you were expecting to win: If an unexpected line item wins the simulation, you can use this box to search for the line item you thought would win and click Go. You’ll see a pop-up with the details for the winning line item on the left side, and the reasons for non-delivery of the line item you searched for on the right side. Here are details of the possible non-delivery reasons.
  • Rerun simulation: You can change the targeting and tag information under “Ad request details” and then click Rerun simulation to see if the winning line item changes. If you eventually find a simulation that provides the desired winning line item, you can go back and update the actual targeting and tag information.

Why is the line item that won the simulation different from the original winner?

There are several possible reasons for this. Here are a few:

  • Every run request, whether actual or simulated, happens dynamically. As a result, several things can change from one request to the other, including run time, goals, new line items to compete against, etc.
  • The DFP ad selection process can result in different line items serving from one ad request to the next.
  • The simulation only considers one ad slot at a time. Therefore, if original winning line item is part of a request with multiple ad slots, like a roadblock, it won’t win the simulation.
  • The line item reached a frequency cap.
  • The line item met its delivery goal.
Was this article helpful?
How can we improve it?