A crucial part of using the DISPL Ads External DSP API is understanding the feedback the system provides before a campaign is launched. The following JSON example represents the response from the Campaign Cost Estimation (Forecast) endpoint.

Learning to interpret this response is vital for any user, as it provides the predictive data needed to optimize bidding strategies and budget allocations before committing financial resources.

Example: Campaign Cost Estimation (Forecast) Response

This response is returned when a GET request is made to the device statistics endpoint. It allows the Demand-Side Platform to see a forecast of its reach based on the current targeting parameters, such as location, time, and audience.

{
 "payment_model": "cpv",
 "payment_model_coef": 1,
 "price": {
 "min": 7.0,
 "max": 15.0,
 "avg": 10.5
 },
 "currency": "USD",
 "total_max_budget_in_currency": 2995.5,
 "target_budget_in_currency": 7000.0,
 "budget": {
 "value": 31103.3,
 "total": 31103.3
 },
 "impressions": {
 "value": 428.0,
 "total": 428.0,
 "acquired": 0
 },
 "inventory": {
 "value": 28,
 "total": 192,
 "excel_url": "https://api.dooh.one/downloads/address_plan_317.xlsx"
 },
 "specs": [
 {
 "type": "monitor",
 "resolution": "1920x1080",
 "count": 28
 }
 ]
}

Why This Example is Important for Learning

• Bid Optimization: The price object is the most critical component for a DSP. It provides the min, max, and avg rates currently active in the auction for the selected targeting. If a user sets their max_bid lower than the price.min shown here, their campaign is guaranteed to never win an auction.
• Reach Forecasting: The impressions.value field provides a forecast of the number of views or contacts the campaign will likely achieve based on the current budget and rules. This helps agencies manage client expectations regarding campaign performance.
• Inventory Transparency: The inventory.value indicates how many physical broadcasting outlets or screens are available for the specific campaign parameters. The inclusion of an excel_url allows users to download a full address plan, providing a tangible list of locations where their ads will appear.
• Technical Compatibility: The specs array lists the hardware specifications of the available screens, such as their resolution and type. This ensures the creative production team can prepare assets that are perfectly formatted for the available inventory.

By mastering this specific JSON structure, users can move beyond simply creating requests and begin performing sophisticated market analysis to ensure their Digital Out-of-Home campaigns are both competitive and cost-effective.