# Data Overview LinkedIn Ads in Coupler.io gives you access to two types of data: **analytics reports** (what happened with your ads) and **core components** (what your account is made of). Understanding which entity to use will save you a lot of time when building reports. ## Entity summary | Entity | Best for | Date range support | | ----------------------------------- | ---------------------------------- | ----------------------- | | Ad analytics by single dimension | Performance reporting by one pivot | Yes (with period split) | | Ad analytics by multiple dimensions | Cross-dimensional analysis | Yes (with period split) | | Sponsored leads | Exporting lead form submissions | Yes | | Campaigns | Campaign settings and status | Start date only | | Campaign groups | Budget and grouping info | Start date only | | Creatives | Ad creative metadata | Start date only | | Video ads | Video ad details | Start date only | | Conversions | Conversion definitions | Start date only | | Ad account users | Account access management | No | | Shares | Sponsored content post data | No | ## Analytics reports #### Dimensions available for single-dimension reports | Dimension | What it tells you | | ----------------------------------- | -------------------------------------- | | Account | Performance rolled up per ad account | | Campaign | Metrics per individual campaign | | Campaign group | Metrics per campaign group | | Creative | Metrics per ad creative | | Company | Reach and engagement by target company | | Member country | Geographic breakdown by country | | Member region | Sub-country regional breakdown | | Member company size | Audience breakdown by company size | | Member industry | Audience breakdown by industry | | Member job function | Audience breakdown by job function | | Member job title | Audience breakdown by job title | | Member seniority | Audience breakdown by seniority level | | Impression device type | Desktop vs. mobile performance | | Placement | LinkedIn feed, messaging, etc. | | Serving location | On-site vs. off-site delivery | | Conversion | Performance per conversion event | | Card index | Carousel card-level performance | | Conversation node | Message ad conversation path | | Shares (creative sponsored content) | Post-level performance | #### Dimensions available for multi-dimension reports | Dimension | Notes | | ----------------------------------- | --------------------------------- | | Account | | | Campaign | | | Campaign group | | | Creative | | | Company | | | Campaign objective type | Not available in single-dimension | | Conversion | | | Impression device type | | | Placement name | | | Serving location | | | Card index | | | Shares (creative sponsored content) | | #### Available metrics (both report types) | Category | Metrics | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | Clicks | Clicks, Action clicks, Ad unit clicks, Card clicks, Company page clicks, Download clicks, Job apply clicks, Landing page clicks, Text URL clicks | | Impressions & reach | Impressions, Card impressions, Viral impressions, Viral card impressions, Reach, Audience penetration, Average dwell time | | Spend | Amount spend in local currency, Amount spend in USD, Conversion value in local currency | | Conversions | Conversions, Post-click conversions, Post-view conversions, Viral conversions, Registrations, Job applications | | Leads | Leads, Lead form opens, Lead generation mail interested clicks, Lead generation mail contact info shares, Talent leads, Valid work email leads, Viral leads | | Engagement | Likes, Comments, Shares, Follows, Reactions, Opens, Sends, Other engagements, Comment likes, Engagements | | Video | Video starts, Video views, Video 25/50/75% completions, Video completions, Full screen plays | | Document ads | Document 25/50/75% completions, Document completions | | Viral variants | Most of the above metrics have a viral equivalent (e.g., Viral clicks, Viral likes, Viral video views) | {% hint style="warning" %} LinkedIn Ads limits analytics reports to **18 metrics per request**. If you need more, create a second data flow with the remaining metrics and use **Append** or **Join** to combine them in your destination. {% endhint %} #### Period split options | Option | Use case | | ----------- | -------------------------------------- | | Totals only | Overall performance for the date range | | Daily | Day-by-day trend analysis | | Monthly | Month-over-month comparisons | | Yearly | Annual reporting | ## Use cases by role {% tabs %} {% tab title="Performance marketers" %} * Use **Ad analytics by single dimension** with Campaign or Creative dimension + daily split to track performance trends and identify underperforming ads * Pull **Member country** or **Member industry** dimension data to understand which audiences convert best — then use this to refine targeting * Join campaign analytics with the **Campaigns** entity to enrich performance data with campaign names, objectives, and budget settings * Send weekly performance exports to ChatGPT or Claude for automated commentary and anomaly detection {% endtab %} {% tab title="Demand gen & lead gen teams" %} * Use the **Sponsored leads** entity to export all lead form submissions directly into Google Sheets or a CRM pipeline * Filter by specific lead generation forms using the form selector to keep each export scoped to one campaign or form type * Append lead data from multiple ad accounts into a single sheet for a consolidated view of all lead gen activity {% endtab %} {% tab title="Analysts & BI teams" %} * Use **Ad analytics by multiple dimensions** to cross-tab campaign performance with audience attributes (e.g., Campaign × Member seniority) * Load raw data into BigQuery and join with CRM or revenue data to calculate pipeline influenced by LinkedIn Ads * Use **Append** mode with daily refreshes to build a historical time series — LinkedIn's UI only shows a rolling window * Combine LinkedIn Ads data with Google Ads and Meta Ads data flows using Coupler.io's Join transformation for a cross-channel paid media dashboard in Looker Studio {% endtab %} {% endtabs %} ## Platform-specific notes * The **Reach** metric and related fields (frequency, CPM) are only available when the **Reach** metric is specifically selected — they won't appear in all reports automatically * **Ad name** is not a dimension in analytics reports; to get ad names, join the analytics report with the **Creatives** entity on the creative ID * The `approximateUniqueImpressions` field (used for reach) may return null for campaigns with small audience sizes due to LinkedIn's privacy thresholds * Conversions and Shares entities do not support date filtering — they return all data available in your account * LinkedIn enforces a hard cap of 18 metrics per analytics request; plan your metric selection carefully before running large reports