LinkedIn Ads
The LinkedIn Ads connector imports campaign spend, impressions, clicks, and conversion data from your LinkedIn Campaign Manager. This is particularly valuable for B2B teams where LinkedIn is a primary demand generation channel.
Authentication
LinkedIn Ads uses OAuth 2.0 with the r_ads and r_ads_reporting scopes.
Click Connect on the Sensors page
Find the LinkedIn Ads card and click Connect. You'll be redirected to LinkedIn's authorization screen.
Sign in with LinkedIn
Use your LinkedIn account that has Campaign Manager access.
Authorize access
Grant Apex permission to read your ad accounts and reporting data.
Select your ad account
Apex lists all ad accounts you have access to, including the account name and status. Select the account to sync.
OAuth Scopes
| Scope | Purpose |
|---|---|
r_ads | Read ad account structure (accounts, campaigns, creatives) |
r_ads_reporting | Read ad performance metrics and analytics |
Data Synced
Each sync pulls analytics data with daily granularity, pivoted by campaign:
| Metric | Description |
|---|---|
| Spend | Cost in local currency (costInLocalCurrency) |
| Impressions | Number of times your ads were shown |
| Clicks | Total ad clicks |
| Conversions | External website conversions tracked by LinkedIn |
Configuration
| Parameter | Type | Description |
|---|---|---|
accountIdrequired | string | LinkedIn Ad Account ID (numeric). Selected during setup. |
dateRange | object | Custom date range for syncs. Default: last 30 days. |
How Apex Uses This Data
- Channel attribution — LinkedIn clicks are matched to visitors via
li_fat_id(LinkedIn First-Party Ad Tracking ID), captured by the tracking snippet - B2B pipeline attribution — Combine with HubSpot deal data to trace LinkedIn campaigns all the way to closed revenue
- Cost efficiency — Compare LinkedIn's cost per lead against other channels in the dashboard
- Budget optimization — Use the budget dashboard to allocate spend based on actual conversion performance
Tip
LinkedIn's REST API uses versioned headers. Apex handles this automatically, including the LinkedIn-Version and X-Restli-Protocol-Version headers required by the v2 API.
Troubleshooting
| Issue | Cause | Fix |
|---|---|---|
| No accounts listed | LinkedIn account lacks Campaign Manager access | Request Campaign Manager access from your company's LinkedIn admin |
| "403" on analytics sync | Account-level reporting permissions missing | Ensure your LinkedIn role includes reporting access |
| Low conversion counts | LinkedIn Insight Tag not installed | Install the LinkedIn Insight Tag on your website for conversion tracking |
Next Steps
- Connect HubSpot to match LinkedIn leads to CRM deals
- Run an experiment targeting LinkedIn traffic