Create a Campaign

Submit a JSON object representing the new campaign in the request body. (See examples below.)

Returns the newly created Campaign in the response body.

🚧

You can optionally pass a start_date for the new campaign.

If omitted, the default start date is 'now' (in the majority of cases).

🚧

Returns a list of campaigns owned (created) by the account passed in the path. E.g.

GET /backstage/api/1.0/demo-advertiser/campaigns/?fetch_level=R

Returns all campaigns created by the account demo-advertiser.


Your network account (if you have one) is not used to create campaigns. You need to use your individual sub-accounts.

See: Network Accounts

Sample JSON Objects

The JSON object in the request body represents the new campaign. Some examples follow.

{
   "name": "DemoCampaign",
   "branding_text": "Pizza",
   "cpc": 0.25,
   "spending_limit": 1000,
   "spending_limit_model": "MONTHLY",
   "marketing_objective": "DRIVE_WEBSITE_TRAFFIC"
}
{
    "name": "Demo Campaign",
    "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", "GB"]
    },
    "sub_country_targeting": null,
    "platform_targeting": {
        "type"  : "INCLUDE",
        "value" : ["TBLT", "PHON"]
    },
    "os_targeting": {
        "type": "INCLUDE",
        "value": [{"os_family": "Android"}]
    },
    "publisher_targeting": null,
    "daily_ad_delivery_model" : "STRICT",
    "publisher_bid_modifier" : {
                 "values": [{"target"  : "publisher1", "cpc_modification" : 1.5},
                            {"target"  : "publisher2", "cpc_modification" : 0.9}
                           ]
    },
    "activity_schedule": {
        "mode": "CUSTOM",
        "rules": [
              {
                    "type": "INCLUDE",
                    "day": "MONDAY",
                    "from_hour": "10",
                    "until_hour": "18"
              },
              {
                    "type": "EXCLUDE",
                    "day": "SATURDAY",
                    "from_hour": "0",
                    "until_hour": "24"
              },
              {
                    "type": "EXCLUDE",
                    "day": "SUNDAY",
                    "from_hour": "10",
                    "until_hour": "22"
              },
        ],
        "time_zone": "US/Eastern"
    },
    "comments"   : null,
    "bid_type": "OPTIMIZED_CONVERSIONS",
    "marketing_objective" : "MOBILE_APP_INSTALL",
    "start_date": "2015-04-30",
    "end_date": "2015-05-30",
    "approval_state" : "APPROVED",
    "is_active": true
}
Language