You can see which ads are eligible to deliver to your in-stream video or audio content to better understand the Ad Manager ad selection process or troubleshoot issues related to delivery.
Simply enter a VAST ad tag URL to see ad request and delivery details. You can then share the details with other users in your network.
Below are some common questions answered by Ad Manager delivery tools:
- Which ads delivered on my page?
- Why these ads and not others?
- Are my line items and creatives are set up correctly?
- Why is my line item behind schedule, or not delivering at all?
To inspect ad delivery, you need to paste a video ad request tag into Ad Manager delivery tools. You can find the video ad tag using Chrome Developer Tools or third-party software, such as Charles and Fiddler.
Find your video or audio ad tag with Chrome Developer Tools
- Open the Google Chrome browser and navigate to the page with the video or audio ad request.
- From the Chrome menu bar, click View Developer Developer Tools. The Developer Tools panel opens at the bottom of the page.
- 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.
- Refresh the page to restart the video ad and collect information in the Developer Tools panel.
- In the "Filter" field of Developer Tools, type
- Click one of the values in the "Name" column.
- To the right of the "Name" column, click the Headers tab.
- Next to "Request URL", copy the entire URL. This is the ad tag URL.
- Sign in to Google Ad Manager.
- Click Delivery Delivery tools Video and audio ads.
- In the "Enter video or audio tag to troubleshoot" box, paste your video or audio ad tag URL.
- (Optional) Select a specific line item to troubleshoot. If you want to inspect a line item to see additional information about non-delivery causes, or to check line item eligibility, this is required.
- (Optional) Click Advanced to enter additional parameters that might affect ad delivery:
- 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 targeted environment.
- Click Troubleshoot. The troubleshooting information appears on the same page.
In the delivery details that appear, you'll see some of the following details:
- A timeline of the placement of ads in the content. You can hover over each break for more information about ad positions and ad duration.
- 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 (for example, "Standard pod request," "VAST video ad," "Pre-roll ad break"). 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.
- Click Simulate request to help determine why an unexpected ad delivered.
Inspect delivery details
In the "Action" column of the delivery details, click Inspect to see specific information about what was requested and what delivered. Depending on the demand channel, you may also be able to additional information in the "Auction details" tab, including:
- Any pricing rules that apply to the request
- The eligible programmatic delivery channels
- The protections that apply to the request
- The video inventory rules that apply to the request. When multiple rules apply, their configurations are merged to represent the most constrained set.
- The video inventory rule constraints, which are the effective settings applied to the request after merging all rules.
- Any applicable Ad Exchange creative constraints
You can share the details with users who have access to your network. This helps you collaborate with others to help determine a plan for troubleshooting your line items.
- Above the details on the Troubleshoot page, click Share this session.
- Click Copy URL. The URL is now copied to your clipboard and ready to be pasted.
- Send the URL to a user with access to your network to paste the URL into their browser.
A simulation 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. Change targeting and tag information to try and get the desired line item to win the simulation.
When you click Simulate request, Ad Manager runs a simulation and provides the details outlined below.
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.
Shows what would happen if you were to request this ad slot again.
The request and targeting information for the simulation, which defaults to the current settings.
The delivery details for the line item that wins the simulation.
If an unexpected line item wins the simulation, you can search for the line item you thought would win and click Go. Details for the winning line item and the reasons for non-delivery of the line item you searched for are shown.
Learn more about causes for line item non-delivery
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.
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, and so forth.
- The ad selection process can result in different line items serving to requests.
- 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.
Why did my line item not deliver 100%?
Ad Manager distributes impression delivery based on both the Deliver impressions setting for the line items and Ad Manager pacing rules that attempt to optimize delivery. Changes to pacing may affect traffic and delivery.