Developer GuideCookbookDelegate: CTV Campaign — UAE & Saudi

Delegate: CTV Campaign — UAE & Saudi

Context: Streaming demand source (DSP) with CTV-focused inventory. Targeting UAE and Saudi Arabia. Higher bids during prime time (18:00–23:00 UTC). Daily budget capped at $500.

Expected result: Bids only on CTV placements in AE and SA. +40% bid during prime time hours. No spend outside the region.


Strategy JSON

Copy, replace your-dsp-uuid, and save via dashboard or API.

{
  "version": "1.0",
  "dsp_id": "your-dsp-uuid",
  "campaigns": [
    {
      "id": "ctv-mena-2026",
      "name": "CTV MENA — Q1 2026",
      "active": true,
      "priority": 1,
      "daily_budget": 500.00,
      "start_date": "2026-02-17",
      "end_date": "2026-03-31"
    }
  ],
  "rules": [
    {
      "name": "CTV UAE + SA — Prime Time",
      "campaign_id": "ctv-mena-2026",
      "conditions": {
        "device.devicetype": "3",
        "geo.country": ["AE", "SA"],
        "hour": ["18", "19", "20", "21", "22", "23"]
      },
      "bid": {
        "base_cpm": 6.00,
        "multipliers": {
          "prime_time": 1.4
        },
        "max_cpm": 12.00,
        "min_cpm": 4.00
      },
      "priority": 1
    },
    {
      "name": "CTV UAE + SA — Off Peak",
      "campaign_id": "ctv-mena-2026",
      "conditions": {
        "device.devicetype": "3",
        "geo.country": ["AE", "SA"]
      },
      "bid": {
        "base_cpm": 4.50,
        "max_cpm": 8.00,
        "min_cpm": 3.00
      },
      "priority": 2
    }
  ],
  "default_bid": 0
}

default_bid: 0 means the demand source only bids when a rule matches — no spend outside UAE/SA or non-CTV inventory.


What this does

ConditionBid
CTV + UAE or SA + hours 18–23 UTC$6.00 × 1.4 = $8.40 CPM (capped at $12.00)
CTV + UAE or SA + any other hour$4.50 CPM
Any other device or countryNo bid

Deploy via API

PUT /api/demand/sources/{DSP_ID}/strategy
X-API-Key: {YOUR_KEY}
Content-Type: application/json
 
{ ...strategy JSON above... }

Strategy takes effect within 30 seconds.


Validate in sandbox

Before going live:

POST /api/sandbox/simulate-auction
{
  "dsp_id": "{DSP_ID}",
  "auction": {
    "device": { "devicetype": "3", "geo": { "country": "AE" } },
    "hour": "20",
    "bidfloor": 3.00
  }
}

Expected: matched_rule: "CTV UAE + SA — Prime Time", bid_cpm: 8.40, won: true.

POST /api/sandbox/simulate-auction
{
  "dsp_id": "{DSP_ID}",
  "auction": {
    "device": { "devicetype": "1", "geo": { "country": "GB" } },
    "hour": "20",
    "bidfloor": 1.00
  }
}

Expected: matched_rule: null, bid_cpm: 0, won: false. ✓ Confirms no spend outside target.

Prime time hours (18–23) are UTC. UAE is UTC+4, Saudi Arabia is UTC+3. Prime time locally is 21:00–02:00 UAE / 21:00–02:00 KSA → map to UTC hours 17:00–22:00 for UAE. Adjust hours to match your audience’s local evening hours.