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.
You can use Adform IQ-powered forecasting to evaluate the effectiveness of your campaign plan. Forecasting reduces the need for repeated campaign optimization as the campaign is running, and provides guidance to secure better results.
Based on the forecasting data you retrieve, you can adjust your plan settings to ensure that the campaign that you'll create from this plan will reach your KPIs and spend the defined budget.
Tip
For more information about Adform campaign plan forecast capabilities and restrictions, see Use Data-Driven Forecast to Optimize Your Plan.
With Media plan predictions API, you can get the following forecasting information about your campaign plan:
-
Spend: Estimated budget that'd be spent with the current settings. Use it to see if it's possible to spend the defined budget within the boundaries of the campaign setup. The budget itself, as well as the defined KPIs, targeting settings, and supply impact the budget spend forecast. Data is based on the campaign period.
-
KPI reach: Estimated KPI values that'd be reached with the current plan settings. This helps to understand the extent to which current plan settings are suitable for reaching your campaign goals. You can see this information for the whole plan or for specific line items Adform could create from this plan. Media plan predictions API shows those forecasted KPIs that are defined in the plan setup. Data is based on the campaign period.
Note
Currently, Adform provides estimated KPI reach for eCPC, CTR, eCPM Viewable, and Viewability Rate. Other KPIs aren't available.
-
Impressions: Estimated number of impressions that'll be reached with the defined plan settings.
-
Cookies: Number of all available unique IDs that can be reached without any applied limitations. Data is based on the past 7 days.
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 use forecasting for your 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 use forecasting in campaign planning 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 the new plan |
Note
Additional IDs might be used, but the listed ones are required to pass a request.
To evaluate the effectiveness of your campaign plan, we recommend using Adform forecasting tool before creating the plan.
Tip
To learn how to use Adform APIs, read Guide to Using Adform APIs.
To get forecasting data for your campaign plan with API, 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 endpoints in Media plan predictions API: To enter all campaign plan settings and retrieve the forecasting information for it.
Once you've checked the forecasting for the plan, you can reuse the setup to create the campaign plan.
[{"api":"Media plan predictions","titles":"DeliveryPredictions"},
{"api":"Data Management Platform","titles":"Segment"},
{"api":"Classifier","titles":"Bandwidths, Cities, Continents, Countries, DeviceProperties, DmaRegions, IabCategories, IpLocations, Isps, Languages, Locales, Locations, MobileCarriers, Regions, ZipCodes"}]