Image Ads (Legacy)
Warning
Deprecation Notice
The Marketing Version 202310 (Marketing October 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. 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.
Single Image Ads are Sponsored Content posts that appear in the LinkedIn feed. Deliver your message to a targeted audience beyond your organization's LinkedIn Page with these native ads.
Advertisers can create Sponsored Content Image Ads in two different ways:
- Post images on a Company Page as organic content and then sponsor the image post to reach more than just Company Page followers.
- Create image posts that do not appear to Company Page followers, but can be directly sponsored to target LinkedIn members' news feed. These types of posts are known as Direct Sponsored Content (DSC) or Dark Shares.
Requirements
Your application must have an access token with the following scopes:
rw_ads
to manage Ad Accountsw_organization_social
to create posts on a Company Pager_organization_social
to read posts from a Company Page
Additionally, the authenticated member must meet both of the following conditions:
- Be an
ADMINISTRATOR
of a Company Page or aDIRECT_SPONSORED_CONTENT_POSTER
with access to Campaign Manager. - Have one of the following ad account roles:
ACCOUNT_BILLING_ADMIN
ACCOUNT_MANAGER
CAMPAIGN_MANAGER
CREATIVE_MANAGER
Workflows
Sponsoring an Existing Organic Image
- Obtain authorization from the user to manage LinkedIn Ad Account and Company Page data.
- Ask user to select Ad Accounts and Company Pages they would like to manage.
- Upload image as a media asset upload.
- Create an organic image share on the Company Page referencing the rich media upload.
- Track its organic growth.
- Create a Sponsored Content Campaign.
- Create a Sponsored Content Ad Creative referencing the previously created image share.
Creating a Direct Sponsored Image
- Obtain authorization from the user to manage LinkedIn Ad Account and Company Page data.
- Ask user to select Ad Accounts and Company Pages they would like to manage.
- Upload image as a media asset upload.
- Create a dark image share on the Company Page referencing the rich media upload.
- Create a Sponsored Content Campaign.
- Create a Sponsored Content Ad Creative referencing the previously created image share.
Prerequisite Values for Image Ad Campaigns
Attribute | Possible Values |
---|---|
Campaign Type | SPONSORED_UPDATES |
Campaign Format | STANDARD_UPDATE |
Creative Type | SPONSORED_STATUS_UPDATE |
Objective Type |
|
API Documentation Links
- Create a Campaign
- Create a Sponsored Content Share
- Create a Direct Sponsored Content Share
- Upload Asset Media
- Create a Share