GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelogLog In
Guides

[Campaigns] Update Campaign Bids

Update Bid Target For A Campaign

Bid targets can be updated by making a PUT call to the campaign bids endpoint. The payload should be an array of bid changes, each specifying a campaignId and a bidValue.

https://api.criteo.com/legacy/marketing/v1/campaigns/bids
curl --request PUT \
  --url https://api.criteo.com/legacy/marketing/v1/campaigns/bids \
  --header 'Accept: application/json' \
  --header 'Content-Type: text/json' \
  --data '[{"campaignId":1234,"bidValue":2},{"campaignId":4,"bidValue":1.5}]'

The API will return an array of campaigns representing the updated state:

[
  {
    campaignType: 'LowerFunnel',
    advertiserName: 'Advertiser US',
    categories: [],
    budgetId: 99999,
    campaignId: 1234,
    campaignName: 'Web Conversion - Retargeting',
    advertiserId: 1,
    campaignStatus: 'Running',
    campaignBid: { 
      bidValue: 2.00,
      bidCurrency: 'USD',
      bidType: 'CPC'
    } 
  },
  {
    campaignType: 'MidFunnel',
    advertiserName: 'Advertiser US',
    categories: [],
    budgetId: 99998,
    campaignId: 5678,
    campaignName: 'Web Consideration - Similar Audience',
    advertiserId: 1,
    campaignStatus: 'Running',
    campaignBid: { 
      bidValue: 1.50,
      bidCurrency: 'USD',
      bidType: 'CPC'
    } 
  }
]

What’s Next

Learn about Category-Level Bidding