Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Warning
Deprecation Notice
The Marketing Version 202406 (Marketing June 2024) has been sunset. We recommend that you migrate to the latest versioned 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 is in the process of rolling out a Technical Sign Off process for the Campaign Management program. This ensures that our members get the best experience whether using LinkedIn's native UI or a partner product. The technical review and sign off also ensures that there are no gaps in integrations and that partner products keep up with the latest features and updates released by LinkedIn.
As an API partner, please go through the requirements listed below. These are the capabilities that an integrating partner is expected to build in their product. We request you to plan and incorporate these features early in your design. When you are nearing completion, you must initiate a Technical Sign Off request by contacting your LinkedIn POC on the Business Development team.
A Demo will be scheduled during which you will be asked to showcase all your product capabilities. During this evaluation, LinkedIn may suggest modifications which will need to be completed for the sign off. If all criteria are met (as per the envisioned scope), the technical sign-off is awarded.
Note
You can begin sharing your product with your Beta customers only after receiving the sign off.
Requirements
| Rule | API capabilities to be demonstrated in Demo |
|---|---|
| Basics | |
| ADS-001 | Demonstrate OAuth 2.0 integration, with right scopes, consent screen |
| ADS-002 | Demonstrate ability to periodically verify that an access token is valid (heartbeat /me) |
| ADS-003 | Demonstrate ability to detect access token expiry |
| ADS-004 | Demonstrate ability to re-trigger OAuth Flow incase token has expired or been invalidated. |
| ADS-005 | Demonstrate ability to use refresh tokens to mint new access tokens. |
| ADS-006 | Demonstrate ability to detect refresh token expiry and re-trigger OAuth Flow |
| ADS-007 | Demonstrate ability to check user access and permissions to start receiving leads |
| Account Structure (Hierarchy) and Basic control | |
| ADS-101 | Demonstrate ability to retrieve all Sponsored Accounts for the logged in user |
| ADS-102 | Demonstrate ability to retrieve all CampaignsGroups within Sponsored Accounts |
| ADS-103 | Demonstrate ability to retrieve all Campaigns within Sponsored Accounts |
| ADS-104 | Demonstrate ability to retrieve all Creatives within Campaigns |
| ADS-105 | Demonstrate ability to visualize account hierarchy (accounts -> Creative (Ad)) |
| ADS-106 | Demonstrate ability to turn off / turn on Campaigns and Creatives |
| Creating a Sponsored Update campaign (image/article ads) | |
| ADS-201 | Demonstrate ability to create a sponsored update campaign |
| ADS-202 | Demonstrate ability to use an existing image share to create a creative in the campaign |
| ADS-203 | Demonstrate ability to use an existing article share to create a creative in the campaign |
| ADS-204 | Demonstrate ability to create a dark share (image) to create a creative in the campaign |
| ADS-205 | Demonstrate ability to create a dark share (article) to create a creative in the campaign |
| Targeting proficiency | |
| ADS-301 | Demonstrate ability to offer all targeting facets in parity with Campaign Manager UI |
| ADS-302 | Demonstrate ability to visualize targeting expressiveness (boolean structure, with include/exclude) |
| ADS-303 | Demonstrate ability to use saved Audiences in a campaign |
| ADS-304 | Demonstrate ability to enable/disable Audience Expansion |
| ADS-305 | Demonstrate ability to leverage LinkedIn Audience Network (use blocklists) |
| Tracking | |
| ADS-401 | Demonstrate ability to setup UTM Tracking |
| ADS-402 | Demonstrate ability to setup Conversion Tracking |
| ADS-403 | Demonstrate ability to setup 3rd Party Tracking |
| Reporting | |
| ADS-501 | Demonstrate ability to perform Campaign Reporting based on Pivots |
| ADS-502 | Demonstrate ability to perform Campaign Reporting based on Professional Demographics |