Campaign Planner is a tool for advertisers and agencies to streamline campaign planning and execution. It helps users share and refine plans with stakeholders. Users can test different scenarios and build on past successes. With its efficient organization and workflow management, Campaign Planner simplifies campaign creation and management for better results.
Tip
For more information about the benefits and use cases of the Campaign Planner, see Learn About Campaign Planner.
After you've created an advertiser, you can create a campaign plan in two ways:
-
Create a campaign plan from scratch: You can start by inserting the minimal required information — the name of the plan, your budget, time, campaign goals, and inventory targeting. Adform will recommend the remaining campaign settings based on the latest advertising landscape and Adform AI-powered algorithm to help you set up effective campaigns. To specify campaign targeting, you can also define additional settings.
-
Create a campaign plan based on a previous campaign: If you have a campaign that performed well in the past, you can choose to create a new plan based on that campaign. When you use this functionality, Adform takes the key learnings from the selected past campaign, evaluates the targeting settings that performed best, and suggests the most suitable setup for your next campaign plan.
After you've created a campaign plan, you can use it to generate a campaign.
With Programmatic Media Plans API, you can create a new plan from scratch, build one based on a previous successful campaign, and generate a campaign from a created plan. You can also retrieve information about existing plans, update, or delete them.
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 plan, Adform DSP and Ad Server user account must have these permissions assigned by the business account admin:
-
Manage Programmatic Line Items
-
Manage Campaigns & Orders
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.mediaplans: Grants access to Programmatic Media Plans API. -
https://api.adform.com/scope/buyer.marketplace.inventories.readonly: Grants access to Inventory Marketplace API. -
https://api.adform.com/scope/integrations.classifiers.readonly: Grants access to Classifiers API. -
https://api.adform.com/scope/dmp.segments.readonly: Grants access to the Segments section of the Data Management Platform 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 and work with campaign plans with API, use the following IDs in your requests:
|
ID |
Used To |
Retrieve From |
|---|---|---|
|
|
Specify the advertiser for the campaign plan |
|
|
|
Specify the campaign on which to base on new plan |
|
|
|
Specify the campaign plan from which to generate a campaign |
Provided as part of response body after creating an advertiser (see step 4 in Create a Plan From Scratch or step 1 in Create a Plan Based on a Previous Campaign). |
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 plan.
Tip
To learn how to use Adform APIs, read Guide to Using Adform APIs.
To create a new campaign plan from scratch, use these endpoints:
-
POST endpoints in Inventory Marketplace API: To create lists of ad exchanges, deals, apps, and domains for inventory targeting setup.
-
(Optional) GET endpoints in Classifiers API: To retrieve criteria for geography targeting setup.
-
(Optional) GET endpoints in Segment section of Data Management Platform API: To retrieve lists of audience IDs for audience targeting setup.
-
POST endpoint in MediaPlans section of Programmatic Media Plans API: To create a campaign plan.
Tip
To evaluate the effectiveness of your campaign plan, we recommend using Adform forecasting tool before creating it.
To create a campaign plan based on a previous successful campaign, use this endpoint:
-
GET endpoint in Jobs section of Programmatic Media Plans API: To create a plan using an existing campaign ID.
After you've created a campaign plan, you can generate a campaign from it. To do that, use this endpoint:
-
POST endpoint in Jobs section of Programmatic Media Plans API: To create a campaign using a media plan ID.