Skip to main content
Feedback

LinkedIn Ads walkthrough

info

LinkedIn Ads API version 2024-06 is currently supported.

This integration empowers marketers and businesses to manage their LinkedIn ad campaigns alongside other data sources, streamlining the process of campaign analysis, performance tracking, ad spend optimization, and gaining valuable insights to enhance their marketing strategies.

By leveraging LinkedIn Ads on Data Integration, you can make data-driven decisions, improve ROI, and maximize the effectiveness of your advertising efforts on LinkedIn.

Connection

To connect LinkedIn Ads with your destination, follow the step-by-step tutorial. Choose a Source Connection after creating a connection.

Predefined reports

Data Integration provides a convenient entry point and recommended approach for accessing a range of predefined reports. Each report includes a concise data description, a list of customizable fields (if applicable), and the schema mapping.

These reports follow a standardized format, so specific fields are locked, and you can only access them through the Custom reports.

Custom reports

Select a specific report to pull data from the LinkedIn Ads.

Build your LinkedIn river by selecting your desired report from this list. Each report has its related inputs.

Ads statistics report

The Ad Statistics report provides account, campaign, and creative level stats on current spend as well as chargeable clicks and impressions

  1. Select the accounts, campaigns, and creatives of the report. Click on each input to get the list of all available items. Leave any input empty to get all available results for that input. You must select at least one account, campaign, or creative to pull the report.
  2. Select the time period of the report.

a. Leave the end date empty to return results until the moment the report runs. b. Last days back - Move the start date backward by the given number of days. For example, if the start date is 10.7.17, the end date is 10.7.17, and the last days back is 7, the report runs for the dates 3.7.17-10.7.17. c. After the river successfully runs in Data Integration, the start date updates with the end date, and the end date updates with an empty value. The next run of the river includes the following period.

  1. Pivots: Select the Pivots of results, which each report data point is grouped by. You can select up to 2 pivots for this report.
  1. Time granularity: Select the Time granularity of results. Each record in the results contains details for each unit in the time period, including the start and end dates of the time unit.

For example: If you run the report for dates 1.6.2017-10.7.17 with the time granularity set to Monthly, the results contain two records (for each selected pivot): one for June and one for July. If you choose Daily **** granularity, the results include 30 records, one for each day.

Ads analytics report

The Ad Analytics API provides account, campaign, and creative level insights on click intelligence numbers, such as clicks, shares, and impressions. You can retrieve demographics data, such as clicks grouped by member job function. If there is no activity to report, the response is empty.

  1. Select the accounts, campaigns, and creatives of the report. Click on each input to get the list of all available items. Leave any input empty to get all available results for that input. Select at least one account, campaign, or creative to get results.

  2. Select the time period of the report.

  • Leave the end date empty to return results until the report runs.
  • Last days back - Move the start date backward by the given number of days. For example, if the start date is 10.7.17, the end date is 10.7.17, and the last days back is 7, the report runs for the dates 3.7.17-10.7.17.
  • After the river successfully runs in Data Integration, the start date updates with the end date, and the end date updates with an empty value. The next run of the river includes the following period.
note

The Start Date does not advance if a River run is unsuccessful. If you do not want this default setting, click More Options and select the checkbox to advance the start date even if the River run is unsuccessful (not recommended).

  1. Pivot: Select the Pivot of results, which groups each report data point. You can select only one pivot.

  2. Time granularity: Select the Time granularity of results. Each record in the results contains details for each unit in the time period, including the start and end dates of the time unit. For example: If you run the report for dates 1.6.2017-10.7.17 with the time granularity set to Monthly, the results contain two records (for each selected pivot): one for June and one for July. If you select Daily granularity, the results contain 30 records, one for each day.

Accounts report

The Accounts report returns details for all the available accounts in the LinkedIn connection.

  1. Select the status of the accounts from which you want to retrieve data. Leave the status input empty to pull all the available accounts in the report.

Campaigns report

The Campaigns report returns details for all the available campaigns in the given LinkedIn connection:

  1. Select the accounts containing the campaigns for which you want to retrieve the results. Leave empty to have campaigns for all the accounts. Click on the accounts input to view all available accounts.
  2. Select the status of the campaigns you want to retrieve data. Leave the status input empty to pull all the available campaigns in the report.

Creatives report

The Creatives report returns details for all the available creatives in the LinkedIn connection.

  1. Select the accounts that contain the creatives to retrieve the results. Leave empty to have creatives for all the accounts. Click on the accounts input to view all available accounts.
  2. Select the status of the creatives you want to retrieve data. Leave the status input empty to pull all the available creatives in the report.
  3. Select the campaigns that contain the creatives to retrieve the results. Leave empty to have creatives for all the campaigns. Click on the campaigns input to all available campaigns.

Creatives shares report

The Creatives shares report returns information about shares of given creatives.

  1. Select the accounts that contain the creatives to retrieve the results. Leave empty to have creatives for all the accounts. Click on the accounts input to view all available accounts.
  2. Select the campaigns that contain the creatives to retrieve the results. Leave empty to have creatives for all the campaigns. Click on the campaigns input to view all available campaigns.
  3. Select the specific creatives to get their shares. Leave empty to get shares for all creatives of the given accounts/campaigns.
(Important )

  • The share information is extracted by a separate API call for each creative. If you do not select any creatives, Data Integration retrieves the shares for all available creatives for the given accounts and campaigns. It is not recommended to leave all inputs of accounts, campaigns, and creatives empty, as this causes Data Integration to run for all the creatives in the given LinkedIn connection and sends thousands of requests to LinkedIn. This operation might cause issues in LinkedIn due to an overload of requests.

  • The /shares API provides access to personal and organization shares. The type of URN specified in the owner field of a share indicates the share type. image.png

Differences between ad Analytics and ad Statistics reports

The Analytics and the Statistics reports are similar, with two key differences:

  1. You can choose up to 2 pivots with the "Statistics" report and only one with the "Analytics". 
  2. Some pivots are unique to the "Analytics" report, while the others are available on both reports.

These pivots are unique to the analytics report:

  • MEMBER_COMPANY_SIZE - Group results by member company size.
  • MEMBER_INDUSTRY - Group results by member industry.
  • MEMBER_SENIORITY - Group results by member seniority.
  • MEMBER_JOB_TITLE - Group results by member job title.
  • MEMBER_JOB_FUNCTION - Group results by member job function.
  • MEMBER_COUNTRY - Group results by member country.
  • MEMBER_REGION - Group results by member region.
  • MEMBER_COMPANY - Group results by member company.
On this Page