> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/ppc/linkedin-ads/data-overview.md). # 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.coupler.io/sources/category/ppc/linkedin-ads/data-overview.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.