Manage Ads

Manage campaigns and ads

Reddit keeps an on/off switch at each level, and Zernio writes to the level you call:

Set a bid

bidStrategy on an ad group takes:

• LOWEST_COST_WITHOUT_CAP (automatic bidding)
• LOWEST_COST_WITH_BID_CAP (a manual bid of bidAmount)
• COST_CAP (Reddit's maximize-volume bidding capped at bidAmount)

bidAmount is in whole currency units. Any other strategy returns 422.

Create a campaign on its own

POST /v1/ads/campaigns creates a campaign on its own (Create a standalone campaign).

With a budget it becomes a campaign-budget campaign: send a daily budget (a lifetime one returns 400, as this call takes no end date), and the pixel rules apply.

Under a campaign budget, change the budget with PUT /v1/ads/campaigns/{campaignId}: an ad group budget update answers with an error that points there.

How it behaves

• Reddit cannot switch a published budget between daily and lifetime, so sending the other type returns 422: keep the type, or create a new ad.
• A targeting update replaces the whole set, so a field you leave out is cleared on the ad group (locations fall back to US).
• Creative edits are not available: creative on PUT /v1/ads/{adId} returns 501 with code feature_not_available; create a new ad instead.
• Deleting archives. Zernio sets the campaign, ad group or ad to ARCHIVED on Reddit and marks it cancelled in Zernio.
• Reddit only lets an archived entity be deleted for good after it has been archived for 3 hours, and Zernio never performs that final delete.
• Reddit's listings stop returning archived and deleted entities, so Zernio re-reads by id any stored campaign, ad group or ad the listing no longer returns.
• One that was archived or deleted in Reddit Ads Manager settles as cancelled, and one Reddit no longer finds is marked deleted.

Related

• Update ad, Update a campaign and Get campaign tree.