To help users further understand the management and optimization capabilities of the DISPL Ads External DSP API, another essential JSON example is the Campaign Update request.

Once a campaign has been approved and is actively running, the API allows Demand-Side Platforms (DSPs) to programmatically adjust certain parameters to optimize performance in real-time. This is a critical learning point for customers who wish to implement automated bidding strategies based on live performance data.

Example: Updating an Active Campaign (Patch Request)

This JSON payload is used in a PATCH request to the campaign endpoint. It demonstrates how a user can adjust the financial and temporal constraints of an existing campaign without needing to re-submit it for full moderation (note that promotional materials cannot be changed in an active campaign).

Endpoint: PATCH /api/v2/agency/<dsp_agency_id>/dsp/request/<campaign_id>/

{
  "max_bid": 12.50,
  "budget": 1500000,
  "end_date": "2021-03-15",
  "time_range": [36000, 72000],
  "schedule": {
    "mon": true,
    "tue": true,
    "wed": true,
    "thu": true,
    "fri": true,
    "sat": true,
    "sun": true
  }
}

Why This Example is Important for Learning

• Dynamic Bidding Adjustment: The max_bid field is the primary tool for optimization¹. If a DSP receives reports indicating they are losing auctions in high-traffic areas, they can programmatically increase this value to remain competitive.

• Budget Management: The budget parameter can be updated to extend the life of a successful campaign or to scale back spending if goals are being met ahead of schedule.

• Temporal Optimization: Users can refine the time_range and schedule. If data shows that ad engagement is higher during specific morning hours, the DSP can narrow the time_range (measured in seconds from the start of the day) to focus spending only during those high-impact windows.

• Operational Flexibility: Learning that these specific parameters are "live-editable" teaches the customer how to manage the campaign lifecycle programmatically (Step 14 of the general procedure) without interrupting the playout status.

By understanding this JSON structure, customers can build "auto-pilot" scripts that monitor the system's bidding progress reports and automatically adjust these parameters to ensure the best possible ROI for their advertising spend.