Sign in
Ad Targeting

Impressions, clicks and spend forecast

LinkedIn-only. Forecasted impressions, clicks, spend and ~20 other metrics for a targeting spec over a time range. Wraps LinkedIn's adSupplyForecasts finder.

Each returned series carries a metricType (IMPRESSION, CLICK, SPENDING, MAX_POTENTIAL_BUDGET, COST_PER_MILLION_IMPRESSIONS, ...) and a granularity (DAILY, SEVEN_DAY, THIRTY_DAY, CUSTOM). LinkedIn caps the daily spending forecast at 1.2x the daily budget and returns 0 once the total budget is exhausted.

Non-LinkedIn accounts return available: false.

post/v1/ads/targeting/supply-forecast

Request body

accountIdstring required
adAccountIdstring required
campaignType'SPONSORED_UPDATES' | 'SPONSORED_INMAILS' | 'DYNAMIC'

Defaults to SPONSORED_UPDATES.

timeRangeStartinteger required

Unix ms. Must be in the future.

timeRangeEndinteger required

Unix ms. Must be after start and within LinkedIn's max horizon.

objectiveTypestring
optimizationTargetstring

When set, the forecast assumes auto-bidding. When unset, competingBid is required.

dailyBudgetnumber

Either dailyBudget or totalBudget is required.

totalBudgetnumber
currencystring

ISO 4217, defaults to USD.

enableAudienceNetworkboolean

Defaults to false. Required true for connectedTelevisionOnly.

enableAudienceExpansionboolean

Defaults to false.

connectedTelevisionOnlyboolean

Defaults to false.

Response

Forecast series

availableboolean required

Changes

Changed in 1 of the 31 revisions of this API.3

  • 017dff7e43243See the full diff
    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property

    • ○

      added the new optional request property /////

      new-optional-request-property