Once your advertising materials are approved, the final step to going live is to transition your campaign from a "Draft" to an "Active" status. This is Step 14 of the general procedure.

Starting the Campaign

To start the campaign, you send a PATCH request to the specific Campaign Request ID. This effectively "flips the switch" to allow the system to start bidding in the auction.

Endpoint Structure:

PATCH https://api.dooh.one/api/v2/agency/{YOUR_AGENCY_ID}/dsp/request/{REQUEST_ID}/

Example Command (cURL)

curl -i -X PATCH \
  -H 'x-authorization: Bearer <access_token>' \
  -H 'x-adexchange-role: dsp' \
  -H 'Content-Type: application/json' \
  -d '{"status": "active"}' \
  'https://api.dooh.one/api/v2/agency/2/dsp/request/317/'

The Full Lifecycle Summary

To help you visualize how these pieces fit together, here is the flow of statuses your campaign and ads will go through:

Important "Go-Live" Requirements

Before your campaign can actually start playing on screens, the system performs a final check. Ensure the following are true:

1. Positive Balance: Your agency balance must be greater than zero. If you run out of funds, the campaign will stop automatically.

2. Date Alignment: The current date must be between the start_date and end_date you set in the initial request.

3. Active Ad: At least one creative asset (ad) linked to the campaign must have the status approved.

4. Campaign Active: The campaign itself must be set to active.

What happens next?

Once the status is active, the system begins the Bidding Process (Step 15). It will look for screens that match your target areas and resolutions, then place bids based on your max_bid.