A campaign is a collection of ads aimed at promoting and selling your services or products. It defines settings such as schedule, budget, and brand controls that Adform uses to deliver, optimize, and report on ads.
Tip
For more information about campaign settings, see Create Campaigns.
After you've created an advertiser, you need to create a campaign. Once you have a campaign, you'll be able to create orders and different types of line items, and then place your ads under them. Campaigns are where you define your advertising goal, for example, sales, website traffic, or brand awareness.
With Campaigns Management API, you can create a new campaign, define and update specific campaign settings, and retrieve information about the status of a specific campaign. You can also retrieve the list of all campaigns that you have access to.
To authenticate and use Adform APIs, your user account must have the necessary permissions and your OAuth client must have the required scopes assigned to it.
To create a campaign, Adform DSP and Ad Server user account must have these permissions assigned by the business account admin:
-
Manage Campaigns & Orders
-
Manage Advertisers
Depending on your objectives and workflow, you'll need some or all of the following scopes assigned to your OAuth client by Adform Support (technical@adform.com):
-
https://api.adform.com/scope/buyer.classifiers.readonly: Grants access to Advertisers Classifiers API. -
https://api.adform.com/scope/buyer.campaigns.api: Grants access to Campaigns Management API.
Tip
If you don't have an OAuth client yet, follow the procedure in Get Authentication Credentials for Adform APIs to register one.
To create a campaign with API, use the following IDs in your requests:
|
ID |
Used To |
Retrieve From |
|---|---|---|
|
|
Specify the advertiser to which the campaign belongs |
|
|
|
Specify the campaign to check its status |
Provided as part of response body after creating a campaign (see step 1 in Workflow) |
Note
Additional IDs might be used, but the listed ones are required to pass a request.
After you've created an advertiser, you can continue with creating a campaign.
Tip
To learn how to use Adform APIs, read Guide to Using Adform APIs.
To create a campaign with API, use these endpoints:
-
(Optional) GET endpoints in Advertisers Classifiers API: To retrieve a list of managers and available time zones for campaign setup.
-
POST endpoint in Campaigns Management API: To create a campaign.
-
GET endpoint in Campaigns Management API: To check the campaign creation status.
After you've created a campaign, you can continue with creating an order.