Media Planning API Use Cases

Warning

Deprecation Notice
The Marketing Version 202401 (Marketing January 2024) has been sunset. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

LinkedIn's Media Planning API enables marketers to understand investment delivery against valuable audiences and objectives.

Why?

LinkedIn's Media Planning API enables marketers to understand investment delivery against valuable audiences and objectives. By leveraging this API, marketers can forecast the reach, impressions, and potential leads of their campaigns before committing to a budget. This allows for more informed decision-making and optimized budget allocation. The API provides detailed insights into how different audience segments respond to various marketing strategies, helping marketers to fine-tune their campaigns for maximum effectiveness. Additionally, the Media Planning API supports cross-channel planning, enabling marketers to integrate LinkedIn's data with other advertising platforms for a comprehensive view of their marketing efforts.

Marketers need:

  • To understand target audience reach across channels to accurately forecast business outcomes
  • Right data to forecast against the specific buying groups and lower-funnel actions vital to success in B2B and/or high-consideration B2C
  • The ability to test different budget scenarios to optimize their media plans against desired outcomes

Permissions

Media Planning API Permissions

Prerequisites

  • Your developer application has access to LinkedIn Advertising APIs. If you are new to our APIs, get started by applying for Advertising API access.
  • Your developer application needs to be provisioned with the Media Planning API product.
  • You have access to atleast one ad account with one of the below roles:
    • ACCOUNT_BILLING_ADMIN
    • ACCOUNT_MANAGER
    • CAMPAIGN_MANAGER
    • CREATIVE_MANAGER
    • VIEWER

For more information on Ad Account roles and permissions:

Example User Process Flow - Media Plan for Brand Planning

Media Planner and/or buyer received a new campaign brief. Media Planner logs into planner tool built with LinkedIn APIs and navigates to the LinkedIn Media Planning module to begin validating the campaign brief. Planner inputs include age, gender, location criteria, and so on. The module produces a reach curve that planner is able to estimate the reach and frequency of multiple budget levels to optimize for highest ROI on LinkedIn. From there, planner can allocate budget to the platform and activate their holistic marketing plan.

media planning

Use Case 1: Brand Planning/High-level Channel Planning

Plan based on key upper-funnel metrics to assist clients in managing their category and increasing their brand equity. Use LinkedIn Data to compare reach across other investment channels (e.g., social, video) accurately. Required inputs: high-level budget, audience (e.g., sourced from LinkedIn Audience API), or geo location, demographic data.

Flexibility to choose which inventory you want to forecast against:

  • LinkedIn feed only “Social Media”
  • LinkedIn LAN “Display”
  • LinkedIn CTV “TV / Video (online)”

media planning usecase

Step 1: Perform 3L OAuth Flow

If there is no valid existing member token for the relevant user from any previous integration, we recommend using the bare minimum scope permissions like r_ads which will be required to fetch authenticated user's ad accounts.

For more information on generating 3L OAuth token, see 3L OAuth Token.

Step 2: Retrieve all LinkedIn Ad Accounts

Retrieve all LinkedIn Ad Accounts for the end user to choose one to further use with LinkedIn Media Planning APIs. The selected ad account should be then passed to subsequent API requests metadata.

For more information on retrieving ad accounts, see Retrieve Ad Accounts.

Step 3: Forecast Reach/Impression/Leads for Brand Planning

Use the ad account from the previous step to forecast reach, impressions, and leads. Age, gender, location, and campaign objectives (BRAND_AWARENESS, VIDEO_VIEW or LEAD_GENERATION) will guide high-level planning.

For more information on targeting capabilities, see:

For more information on forecasting with Media Planning API, see documentation.

Use Case 2: Full-Funnel/ B2B Professional Audience Planning

Use LinkedIn Data to forecast any Professional audience accurately. This planning takes input of LinkedIn Professional audiences like IT Decision Makers, Campaign Objectives, Ad Formats, etc., and helps clients plan full-funnel metrics (reach, impressions, leads, etc.) for every stage of the marketing funnel by defining B2B audiences.

media planning full funnel

Step 1: Perform the 3L OAuth Flow

If there is no valid existing member token for the relevant user from any previous integration, we recommend using the bare minimum scope permissions like r_ads which will be required to fetch authenticated user's ad accounts.

For more information on generating 3L OAuth token, see 3L OAuth Token.

Step 2: Retrieve all the LinkedIn Ad Accounts

Retrieve all LinkedIn Ad Accounts for the end user to choose one to further use with LinkedIn Media Planning APIs. The selected ad account should be then passed to subsequent API requests metadata.

For more information on retrieving ad accounts, see Retrieve Ad Accounts.

Step 3: Forecast Reach/Impression/Leads

Use the ad account from the previous step to forecast reach, impressions, and leads. For B2B professional audience forecasting use LinkedIn’s rich B2B targeting facets like interests, job title, seniority, job function, industries, firmographic facets etc., in addition to age, gender, location.

For more information on targeting capabilities, see:

For information on audience segment size, see documentation. For more information on forecasting with Media Planning API, see documentation.