Use Forecasting in Campaign Planning With API

Greta
Greta
  • Updated

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.

Authentication

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.

Prerequisites

To use forecasting in campaign planning with API, use the following IDs in your requests:

ID

Used To

Retrieve From

advertiserId

Specify the advertiser for the campaign plan

Advertisers Management API

campaignId

Specify the campaign on which to base the new plan

Campaigns Management API

Note

Additional IDs might be used, but the listed ones are required to pass a request.

Workflow

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:

  1. POST endpoints in Inventory Marketplace API: To create lists of ad exchanges, deals, apps, and domains for inventory targeting setup.

  2. (Optional) GET endpoints in Classifiers API: To retrieve criteria for geography targeting setup.

  3. (Optional) GET endpoints in Segment section of Data Management Platform API: To retrieve lists of audience IDs for audience targeting setup.

  4. 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.

Endpoints

[{"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"}]

impressions

Was this article helpful?

/
How we can make it better?

Thank you for your feedback!