In addition to campaign creation and monitoring, a critical step for developers is understanding how to programmatically add advertising materials to a campaign request. According to the general procedure, a request must have promotional materials attached to pass the mandatory audit process¹¹¹.

The following example demonstrates the JSON structure for associating a creative asset with a specific campaign request.

Example: Adding Advertising Materials to a Request

This POST request is used to link a creative (such as a video or image) to an existing draft request.

Endpoint: POST /api/v2/agency/<dsp_agency_id>/dsp/request/<request_id>/ad/

{
  "title": "Summer Promotion 2024",
  "ad_type": "video",
  "media_url": "https://storage.provider.com/assets/promo_video_10s.mp4",
  "duration": 10,
  "width": 1920,
  "height": 1080,
  "format": "mp4"
}

Why This Example is Important for Learning

• Audit Readiness: A campaign request remains in "draft" status until materials are added. Understanding this JSON structure allows users to complete Step 8 of the integration workflow.

• Technical Synchronization: The width, height, and duration fields must align with the parameters specified in the initial campaign request to ensure the ad is compatible with the selected hardware inventory.

• Status Tracking: Once this data is submitted, the system triggers the moderation process. Each ad will then receive its own status, such as "pending_audit" or "approved," which the DSP must monitor.

• Multi-Ad Support: Users can learn that a single campaign request can contain an array of multiple ads (ads: []), allowing for A/B testing or rotating creatives within a single budget.

By mastering this interaction, customers can automate the final preparation stage, moving their campaigns efficiently from a technical draft to a live, bidding entity.