Targeting Video/Audio (VAST) Inventory

[James Tildesley]

Hi all!

I'm currently implementing inventory checking (getAvailabilityForecast) and am trying to figure out how I can specifically target Video/Audio inventory. I have tried using both a Placement Id and Ad Unit Id in my payload but it appears to be returning all inventory (including Display).

I also tried adding creativePlaceholders and videoMaxDuration nodes to specify the specific Ad Size but after adding this it returns zero units...

I have checked via the UI and am getting inventory returned for both the Placement and Ad Unit requests with the same Ad Size. The only thing I can see that is different is there is a "388" node included in the UI payload but I can't see any reference to what this is (interestingly, if I add Inventory Type Targeting in the UI the node value is the same as that for the "388" node so I assume that this is the Inventory Type but I can't see any way of specifying this in the request...

Any help on how I should be constructing the XML Payload to target VAST inventory and specify the Ad Size would be very much appreciated! I have been through the documentation but can't see anything mentioned...

Cheers,

James

[Ad Manager API Forum Advisor]

Hi,

Thank you for contacting the Ad Manager API support team.

To specifically target "Video/Audio (VAST) inventory" within the getAvailabilityForecast(), add AvailabilityForecastOptions into your request. This will help ensure that the forecast accurately reflects your  targeting settings. To implement this, you can refer to the Java sample code and available client libraries.

If the issue still persists, please provide the following information.

• Complete SOAP request and response logs (SOAP logging must be enabled).
• Ad Manager UI uncropped screenshot which you are trying to retrieve via API. 
•  Network code.

Thanks,
 

Ad Manager API Team

Feedback
How was our support today?

               
[2025-02-26 04:18:23Z GMT] This message is in relation to case "ref:!00D1U01174p.!5004Q02vH3wv:ref" (ADR-00289829)

[James Tildesley]

Hi,

Thanks for your response.

I have gone through the documentation and samples but still can't find the correct payload structure. I have tried a number of approaches to this but am still unable to replicate the OOTB inventory request:

• UI Request
  • I have attached the screenshots of the UI Inventory Check showing the payload configuration and returning 545,304 Available Impressions with a Total Capacity of 829,257.
• No Ad-Size Targeting
  • The "General-Payload" and "General-Response" files show the Inventory that is returned for the same configuration (Dates, Placement, etc) which is showing 89,897,326 Available Impressions.
• Creative Placeholder
  • The "creativePlaceholders-Payload" and "creativePlaceholders-Response" files show the Inventory that is returned for the same configuration (Dates, Placement, etc) as the "General-Payload" request but also including the creativePlaceholders Node. This is showing 0 Available Impressions.
• Breakdown
  • The "breakdown-Payload" and "breakdown-Response" files show the Inventory that is returned for the same configuration (Dates, Placement, etc) as the "General-Payload" request but also including the creativePlaceholders Node. This is showing 89,897,326 Available Impressions.
    

From what I can tell, there appears to be 2 issues:

• Availability is being returned for all Inventory Types rather than just Video (VAST)
• The Creative Placeholder specified in the payload is not matching the 640v360v Ad Size that is configured in the UI.

Any support on the correct payload structure for this would be much appreciated...

Cheers,

James

[James Tildesley]

Hi,

Thanks for your response!

I have reviewed the links and sample requests but am still unable to replicate the Inventory Check from the UI through the API. I have tried a number of approached but the resulting availability is inconsistent with the UI. Please find attached screenshots of the UI configuration which shows 545,304 Available Impressions and a Total Capacity of 829,257. I have also attached the payloads and responses from the API

• No Ad-Size Targeting
  • The "general-payload" and "general-response" files shows the behaviour for the same Placement and configuration as the UI but without any Ad-Size Targeting. This is returning 89,897,326 Available Impressions.
• Creative Placeholder Targeting
  • In the "creativePlaceholders-payload" and "creativePlaceholders-response" I have added the creativePlaceholders node and specified the width and height as 640 and 360 respectively. However, this is returning 0 Available Impressions.
• Breakdown
  • The "breakdown-payload" and "breakdown-response" files include the breakdown node under forecastOptions and include the creative. However, this is returning 89,897,326 Available Impressions.

Based on the above, there appear to be 2 issues:

• The response is showing Availability for all Inventory Types rather than just Video (VAST)
• The specified Ad-Size is not matching the 640x360v Ad Size that is selected in the UI

Any support on resolving this issue would be hugely appreciated!

Cheers,

James

On Wednesday, 26 February 2025 at 04:18:39 UTC Ad Manager API Forum Advisor wrote:

[Ad Manager API Forum Advisor]

Hi,

Please note that this feature is currently supported only in UI and not via the API. We have raised a feature request from our end to make this feature available for you, subject for review. Kindly note that I am unable to comment on any timelines for its exposure. I would recommend you to kindly follow our release notes and blog post for future updates.

Thanks,
 

Ad Manager API Team

Feedback
How was our support today?

               

[2025-03-04 20:29:10Z GMT] This message is in relation to case "ref:!00D1U01174p.!5004Q02vH3wv:ref" (ADR-00289829)