Ad Targeting

Forecast ad delivery

Changed on

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

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/targeting/supply-forecast
  • Auth: HTTP bearer

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

  • c6dd037b213dRevision changes
    • info

      added the new optional request property /////

  • 27c96850cc66Revision changes
    • info

      added the new optional request property /////

    • info

      added the new optional request property /////

    • info

      added the new optional request property /////

    • info

      added the new optional request property /////