v1

latestOpenAPI 3.1.02026-07-26950137.9 KB

Update a Campaign

Submit a JSON object in a PUT or POST request body. Fields that are omitted or null will not be updated.

post/backstage/api/1.0/{account_id}/campaigns/{campaign_id}

Path parameters

account_idstring required

An alphabetic ID. See Get Account Details.

campaign_idstring required

A numeric ID. See the response returned by Get All Campaigns.

Request body

RAW_BODYstring json required

A JSON object representing the fields to be updated. (See examples below.)

Response

200

idstring

advertiser_idstring

namestring

branding_textstring

tracking_codestring

cpcnumber

daily_capinteger

spending_limitinteger

spending_limit_modelstring

{"stackTrail":"paths:/backstage/api/1.0/{account_id}/campaigns/{campaign_id}:post:responses:200:content:application/json:schema:properties:sub_country_targeting","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/backstage/api/1.0/{account_id}/campaigns/{campaign_id}:post:responses:200:content:application/json:schema:properties:postal_code_targeting","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/backstage/api/1.0/{account_id}/campaigns/{campaign_id}:post:responses:200:content:application/json:schema:properties:publisher_targeting","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/backstage/api/1.0/{account_id}/campaigns/{campaign_id}:post:responses:200:content:application/json:schema:properties:comments","oasType":"schema","type":"unknown"}

start_datestring

end_datestring

approval_statestring

is_activeboolean

spentinteger

statusstring

daily_ad_delivery_modelstring

traffic_allocation_modestring

Example response

{
  "id": "124",
  "advertiser_id": "taboola-demo-advertiser",
  "name": "DemoCampaign - Edited",
  "branding_text": "Pizza",
  "tracking_code": "taboola-track",
  "cpc": 0.25,
  "daily_cap": 100,
  "spending_limit": 1000,
  "spending_limit_model": "MONTHLY",
  "country_targeting": {
    "type": "INCLUDE",
    "value": [
      "AU"
    ]
  },
  "platform_targeting": {
    "type": "INCLUDE",
    "value": [
      "TBLT"
    ]
  },
  "os_targeting": {
    "type": "ALL"
  },
  "start_date": "2015-04-30",
  "end_date": "2015-05-30",
  "approval_state": "APPROVED",
  "is_active": true,
  "status": "RUNNING",
  "daily_ad_delivery_model": "STRICT",
  "traffic_allocation_mode": "EVEN",
  "publisher_bid_modifier": {
    "values": [
      {
        "target": "publisher1",
        "cpc_modification": 1.5
      }
    ]
  }
}