# LinkedIn Ads (v2)

Information note **LinkedIn Ads extraction is supported by Stitch**   
This integration is powered by [Singer's](https://www.singer.io/) LinkedIn Ads tap and certified by Stitch. [Check out and contribute to the repo on GitHub](https://github.com/singer-io/tap-linkedin-ads).  
  
For support, contact [Support](https://community.qlik.com/t5/Support/ct-p/qlikSupport).

## LinkedIn Ads feature snapshot

A high-level look at Stitch's LinkedIn Ads (v2) integration, including release status, useful links, and the features supported in Stitch.

| **STITCH** |  |  |  |
| --- | --- | --- | --- |
| **[Release status](https://help.qlik.com/en-US/stitch/integrations/identify-an-integration-version)** | Released on February 7, 2023 | **Supported by**<br><br>the Info icon<br><br>Indicates if the integration is supported by Stitch or the Singer community. | [Stitch](https://community.qlik.com/t5/Support/ct-p/qlikSupport) |
| **Stitch plan**<br><br>the Info icon<br><br>The type of Stitch plan required to use the integration. | Standard | **[API availability](https://help.qlik.com/en-US/stitch/developers/stitch-connect/guides/source-destination-reference)**<br><br>the Info icon<br><br>Indicates if the integration is available as a source in Stitch Connect. | the Success icon<br><br>This version of the integration is available via the API.<br><br><br>Available |
| **Singer GitHub repository** | [singer-io/tap-linkedin-ads](https://github.com/singer-io/tap-linkedin-ads) |  |  |
| **REPLICATION SETTINGS** |  |  |  |
| **[Anchor Scheduling](https://help.qlik.com/en-US/stitch/replication/replication-scheduling/anchor-scheduling)**<br><br>the Info icon<br><br>A type of replication scheduling where an integration's Replication Frequency is anchored to a time you select. | the Success icon<br><br>This feature is supported for this version of the integration.<br><br><br>Supported | **[Advanced Scheduling](https://help.qlik.com/en-US/stitch/replication/replication-scheduling/advanced-scheduling)**<br><br>the Info icon<br><br>A type of replication scheduling that allows you to specify granular start times for data extraction using cron expressions. | the Success icon<br><br>This feature is supported for this version of the integration.<br><br><br>Supported |
| **Table-level reset**<br><br>the Info icon<br><br>Indicates if data can be reset at the table level. If unsupported, data can only be reset at the integration level. | the Remove icon<br><br>Table-level resets are not supported for this integration. Resets are only supported at the integration level.<br><br><br>Unsupported | **[Configurable Replication Methods](https://help.qlik.com/en-US/stitch/replication/replication-methods)**<br><br>the Info icon<br><br>Indicates if Replication Methods can be defined by you for tables in the integration. | the Remove icon<br><br>Configurable Replication Methods are not supported for this integration. Stitch will use pre-defined replication methods for tables you set to replicate.<br><br><br>Unsupported |
| **DATA SELECTION** |  |  |  |
| **Table selection**<br><br>the Info icon<br><br>The ability to select individual tables for replication in the Stitch interface. If table selection is unavailable, all tables and all the columns they contain will be set to replicate by default. | the Success icon<br><br>This feature is supported for this version of the integration.<br><br><br>Supported | **Column selection**<br><br>the Info icon<br><br>The ability to select individual columns for replication in the Stitch interface. If column selection is unavailable, all columns will be set to replicate by default. | the Success icon<br><br>This feature is supported for this version of the integration.<br><br><br>Supported |
| **Select all**<br><br>the Info icon<br><br>Indicates if the integration supports selecting all available tables and columns. | the Success icon<br><br>Supported<br><br><br>Supported |  |  |
| **TRANSPARENCY** |  |  |  |
| **[Extraction Logs](https://help.qlik.com/en-US/stitch/replication/extractions/integration-extraction-logs)**<br><br>the Info icon<br><br>Logs detailing the Extraction phase of the replication process for a given integration. Includes error info, should an error occur. | the Success icon<br><br>This feature is supported for this version of the integration.<br><br><br>Supported | **[Loading Reports](https://help.qlik.com/en-US/stitch/replication/integration-loading-reports)**<br><br>the Info icon<br><br>Reports detailing the Loading phase of the replication process for a given integration. Includes the number of rows loaded for each table and error info, should an error occur. | the Success icon<br><br>This feature is supported for this version of the integration.<br><br><br>Supported |

## Connecting LinkedIn Ads

### LinkedIn Ads setup requirements

To set up LinkedIn Ads in Stitch, you need:

* **Access to a LinkedIn Ads account**. This is necessary to login to the Campaign Manager account.

* **Access to a LinkedIn Ads Campaign Manager account**. Verify that you have access to use the Ad accounts you want to replicate data from. This is necessary to connect to Stitch.

### Step 1: Retrieve your LinkedIn Ads account IDs

1. Login to your LinkedIn account.

2. Click the **Work** menu, then **Advertise**:

   ![The LinkedIn Work and Advertise menus, highlighted](https://help.qlik.com/en-US/stitch/images/integrations/linkedin-ads-work-dropdown.png)The LinkedIn Work and Advertise menus, highlightedThe LinkedIn Work and Advertise menus, highlighted

3. In the Accounts table, locate the IDs for the accounts you want to replicate data from:

   ![LinkedIn Ads account IDs highlighted in the Accounts table of the Campaign Manager page.](https://help.qlik.com/en-US/stitch/images/integrations/linkedin-ads-account-ids.png)LinkedIn Ads account IDs highlighted in the Accounts table of the Campaign Manager page.LinkedIn Ads account IDs highlighted in the Accounts table of the Campaign Manager page.

### Step 2: Add LinkedIn Ads as a Stitch data source

1. [Sign into your Stitch account](https://app.stitchdata.com/).

2. On the Stitch Dashboard page, click the **Add Integration** button.

3. Click the **LinkedIn Ads** icon.

4. Enter a name for the integration. This is the name that will display on the Stitch Dashboard for the integration; it’ll also be used to create the schema in your destination.

   For example, the name “Stitch LinkedIn Ads” would create a schema called `stitch_linkedin_ads` in the destination. **Note**: Schema names cannot be changed after you save the integration.

5. In the **Accounts** field, enter a comma-separated list of the account IDs of the campaign accounts you want to replicate data from. These will be the account IDs you retrieved in [Step 1](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#retrieve-account-ids). For example: `503123456,503234567`, etc.

### Step 3: Define the historical replication start date

The Sync Historical Data setting defines the starting date for your LinkedIn Ads integration. This means that data **equal to or newer than this date** will be replicated to your data warehouse.

Change this setting if you want to replicate data beyond LinkedIn Ads’s default setting of **1 year**. For a detailed look at historical replication jobs, check out the [Syncing Historical SaaS Data](https://help.qlik.com/en-US/stitch/replication/syncing-historical-saas-data-resetting-replication-keys) guide.

### Step 4: Create a replication schedule

Information note Replication schedules affect the time Extraction begins, not the time to data loaded. Refer to the [Replication Scheduling](https://help.qlik.com/en-US/stitch/replication/replication-scheduling) documentation for more information.

In the **Replication Frequency** section, you’ll create the integration’s [replication schedule](https://help.qlik.com/en-US/stitch/replication/replication-scheduling). An integration’s replication schedule determines how often Stitch runs a replication job, and the time that job begins.

LinkedIn Ads integrations support the following replication scheduling methods:

* [Replication Frequency](https://help.qlik.com/en-US/stitch/replication/replication-scheduling/replication-frequency)

* [Anchor Scheduling](https://help.qlik.com/en-US/stitch/replication/replication-scheduling/anchor-scheduling)

* [Advanced Scheduling using Cron](https://help.qlik.com/en-US/stitch/replication/replication-scheduling/advanced-scheduling) (Advanced or Premium plans only)

To keep your row usage low, consider setting the integration to replicate less frequently. See the [Understanding and Reducing Your Row Usage guide](https://help.qlik.com/en-US/stitch/getting-started/understanding-stitch-usage) for tips on reducing your usage.

### Step 5: Set objects to replicate

Information note **Is an object missing or not replicating?** Verify that the object meets the requirements for [selection](https://help.qlik.com/en-US/stitch/replication/extractions/data-selection/setting-tables-and-columns-to-replicate#selection-requirements) and [replication](https://help.qlik.com/en-US/stitch/replication/extractions/data-selection/setting-tables-and-columns-to-replicate#replication-requirements).

The last step is to select the tables and columns you want to replicate. [Learn about the available tables for this integration.](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#schema)

**Note**: If a replication job is currently in progress, new selections won’t be used until the next job starts.

* Selection options
* Individual tables and columns
* All tables and columns

For LinkedIn Ads integrations, you can select:

1. **Individual tables and columns**

2. **All tables and columns**

Click the tabs to view instructions for each selection method.

1. In the integration’s **Tables to Replicate tab**, locate a table you want to replicate.

2. To track a table, click the **checkbox** next to the table’s name. A blue checkmark means the table is set to replicate.

3. To track a column, click the **checkbox** next to the column’s name. A blue checkmark means the column is set to replicate.

4. Repeat this process for all the tables and columns you want to replicate.

5. When finished, click the **Finalize Your Selections** button at the bottom of the screen to save your selections.

Information note **Important**: Using the **Select All** feature will overwrite any previous selections. However, selections aren’t final until **Finalize Your Selections** is clicked. Clicking **Cancel** will restore your previous selections. Refer to the [Select All guide](https://help.qlik.com/en-US/stitch/replication/extractions/data-selection/setting-tables-and-columns-to-replicate#set-all-data-to-replicate) for more info about this feature.

1. Click into the integration from the Stitch Dashboard page.

2. Click the **Tables to Replicate** tab.

3. In the list of tables, click the box next to the **Table Names** column.

4. In the menu that displays, click **Track all Tables and Fields**:

   ![The Track all Tables and Fields menu in the Tables to Replicate tab](https://help.qlik.com/en-US/stitch/images/replication/select-all-tables-menu.png)The Track all Tables and Fields menu in the Tables to Replicate tabThe Track all Tables and Fields menu in the Tables to Replicate tab

5. Click the **Finalize Your Selections** button at the bottom of the page to save your data selections.

### Initial and historical replication jobs

After you finish setting up LinkedIn Ads, its **Sync Status** may show as **Pending** on either the Stitch Dashboard or in the Integration Details page.

For a new integration, a **Pending** status indicates that Stitch is in the process of scheduling the initial replication job for the integration. **This may take some time to complete.**

Information note

**Initial replication jobs with Anchor Scheduling**

If using Anchor Scheduling, an initial replication job may not kick off immediately. This depends on the selected Replication Frequency and Anchor Time. Refer to the [Anchor Scheduling](https://help.qlik.com/en-US/stitch/replication/replication-scheduling#job-scheduling-and-anchor-times) documentation for more information.

#### Free historical data loads

The first seven days of replication, beginning when data is first replicated, are free. Rows replicated from the new integration during this time won’t count towards your quota. Stitch offers this as a way of testing new integrations, measuring usage, and ensuring historical data volumes don’t quickly consume your quota.

Information note **Replication will continue after the seven days are over**. If you’re no longer interested in this source, be sure to **pause** or **delete** the integration to prevent unwanted usage.

## LinkedIn Ads replication

Every time Stitch runs a replication job for LinkedIn Ads, the last 7 days’ worth of data will be replicated.

This is applicable to all tables in the integration.

Stitch replicates data in this way to account for updates made to existing records within the default attribution window of 7 days, thus ensuring you won’t make decisions based on stale (or false) data. **As a result, you may see a higher number of replicated rows than what’s being generated in LinkedIn Ads**.

Setting the Replication Frequency to a higher frequency - like 30 minutes - can result in re-replicating recent data and contribute to greater row usage. Replicating fewer tables or selecting a lower frequency can help keep your row count low.

Refer to the documentation for each of these tables in the next section for more info.

### Attribution window examples

In the tabs below are examples of attribution windows behave during historical (initial) and ongoing replication jobs.

* Historical and full re-replications
* Ongoing replications

For historical and full re-replications of LinkedIn Ads data, Stitch will query for and extract data newer than or equal to the date defined in the **Start Date** field in the Integration Settings page.

The **Start Date**, in conjunction with the **Attribution Window**, defines the minimum date Stitch should query for when extracting historical data. This is calculated as:

`Start Date - Attribution Window = Minimum Extraction Date`

**Example**

During the initial set up, the **Start Date** field is set to `06/03/2017`, or `June 3, 2017`.

To account for the Attribution Window, Stitch would calculate the **Minimum Extraction Date** value as: `2017-07-03 00:00:00 - 7 days = 2017-06-03 00:00:00`

If you were to write a SQL query using this date for the `ad_analytics_by_campaign` table, it might look like this:

```
  SELECT *
    FROM linkedin_ads.ad_analytics_by_campaign
   WHERE end_at >= '2017-06-03 00:00:00'   /* Min. Extraction Date */
ORDER BY end_at
```

For ongoing replication jobs, Stitch will query for and extract data using the last saved maximum value in the table’s Replication Key column and the Attribution Window for the table.

**Note:** This applies to every replication job that takes place after the historical replication job.

**Example**

The last maximum saved Replication Key value for the `ad_analytics_by_campaign` table is `2017-10-01 00:00:00`.

To account for the Attribution Window of 7 days, we’d subtract this from the last maximum saved Replication Key value:

`2017-10-01 00:00:00 - 7 days = 2017-09-24 00:00:00`

In this case, Stitch would query for and extract data that is newer than or equal to `2017-09-24 00:00:00` and older than or equal to `2017-10-01 00:00:00`.

If this were a SQL query, it might look like this:

```
  SELECT *
    FROM ad_analytics_by_campaign
   WHERE end_at >= '2017-09-24 00:00:00'
                              /* max Replication Key value - Attribution Window */
     AND end_at <= '2017-10-01 00:00:00'
                              /* max Replication Key value from previous job */
ORDER BY end_at
```

## LinkedIn Ads table reference

Information note

**Schemas and versioning**

Schemas and naming conventions can change from version to version, so we recommend verifying your integration’s version before continuing.

The schema and info displayed below is for **version 2** of this integration.

This is the latest version of the LinkedIn Ads integration.

Information note

**Table and column names in your destination**

Depending on your destination, table and column names may not appear as they are outlined below.

For example: Object names are lowercased in Redshift (`CusTomERs` &gt; `customers`), while case is maintained in PostgreSQL destinations (`CusTomERs` &gt; `CusTomERs`). Refer to the [Loading Guide](https://help.qlik.com/en-US/stitch/replication/loading/destination-guides) for your destination for more info.

### account\_users

The `account_users` table contains info about the users who have permissions to an ad account.

| **Replication Method [](https://help.qlik.com/en-US/stitch/replication/replication-methods)[the Info icon](https://help.qlik.com/en-US/stitch/replication/replication-methods)[](https://help.qlik.com/en-US/stitch/replication/replication-methods)** | Key-based Incremental |
| --- | --- |
| **Primary Keys ![](https://help.qlik.com/en-US/stitch/images/replication/primary-key-icon.svg)** | account\_id<br><br>user\_person\_id |
| **Replication Key ![](https://help.qlik.com/en-US/stitch/images/replication/replication-key-icon.svg)** | last\_modified\_time |
| **Useful links** | [account_users schema on GitHub](https://github.com/singer-io/tap-linkedin-ads/blob/master/tap_linkedin_ads/schemas/account_users.json "Opens in new tab: account_users schema on GitHub")<br><br><br>[LinkedIn Ads API method](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-account-users?view=li-lms-2022-07&tabs=http#find-ad-account-users-by-accounts "Opens in new tab: LinkedIn Ads API method") |

account\_users table foreign keys

| Join account\_users with | on |
| --- | --- |
| [accounts](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#accounts) | ```<br>account_users.account_id = accounts.id<br>``` |
| [campaigns](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaigns) | ```<br>account_users.account_id = campaigns.account_id<br>``` |
| [campaign_groups](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaign-groups) | ```<br>account_users.account_id = campaign_groups.account_id<br>``` |
| [video_ads](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#video-ads) | ```<br>account_users.account_id = video_ads.account_id<br>``` |

account\_users table schema

| **account**<br><br><br>STRING |
| --- |
| **account\_id**<br><br><br>INTEGER |
| **campaign\_contact**<br><br><br>BOOLEAN |
| **change\_audit\_stamps**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand change\_audit\_stamps<br><br><table> <tr> <td> <p> <strong>								created							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand created</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								last_modified							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand last_modified</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| **created\_time**<br><br><br>DATE-TIME |
| **last\_modified\_time**<br><br><br>DATE-TIME |
| **role**<br><br><br>STRING |
| **user**<br><br><br>STRING |
| **user\_person\_id**<br><br><br>STRING |

### accounts

The `accounts` table contains info about your LinkedIn Ads ad accounts.

| **Replication Method [](https://help.qlik.com/en-US/stitch/replication/replication-methods)[the Info icon](https://help.qlik.com/en-US/stitch/replication/replication-methods)[](https://help.qlik.com/en-US/stitch/replication/replication-methods)** | Key-based Incremental |
| --- | --- |
| **Primary Key ![](https://help.qlik.com/en-US/stitch/images/replication/primary-key-icon.svg)** | id |
| **Replication Key ![](https://help.qlik.com/en-US/stitch/images/replication/replication-key-icon.svg)** | last\_modified\_time |
| **Useful links** | [accounts schema on GitHub](https://github.com/singer-io/tap-linkedin-ads/blob/master/tap_linkedin_ads/schemas/accounts.json "Opens in new tab: accounts schema on GitHub")<br><br><br>[LinkedIn Ads API method](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-accounts?view=li-lms-2022-07&tabs=http#search-for-accounts "Opens in new tab: LinkedIn Ads API method") |

accounts table foreign keys

| Join accounts with | on |
| --- | --- |
| [account_users](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#account-users) | ```<br>accounts.id = account_users.account_id<br>``` |
| [campaigns](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaigns) | ```<br>accounts.id = campaigns.account_id<br>``` |
| [campaign_groups](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaign-groups) | ```<br>accounts.id = campaign_groups.account_id<br>``` |
| [video_ads](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#video-ads) | ```<br>accounts.id = video_ads.account_id<br>``` |

accounts table schema

| **change\_audit\_stamps**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand change\_audit\_stamps<br><br><table> <tr> <td> <p> <strong>								created							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand created</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								last_modified							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand last_modified</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| --- |
| **created\_time**<br><br><br>DATE-TIME |
| **currency**<br><br><br>STRING |
| **id**<br><br><br>INTEGER |
| **last\_modified\_time**<br><br><br>DATE-TIME |
| **name**<br><br><br>STRING |
| **notified\_on\_campaign\_optimization**<br><br><br>BOOLEAN |
| **notified\_on\_creative\_approval**<br><br><br>BOOLEAN |
| **notified\_on\_creative\_rejection**<br><br><br>BOOLEAN |
| **notified\_on\_end\_of\_campaign**<br><br><br>BOOLEAN |
| **notified\_on\_new\_features\_enabled**<br><br><br>BOOLEAN |
| **reference**<br><br><br>STRING |
| **reference\_organization\_id**<br><br><br>INTEGER |
| **reference\_person\_id**<br><br><br>STRING |
| **serving\_statuses**<br><br>ARRAY<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;. |
| **status**<br><br><br>STRING |
| **test**<br><br><br>BOOLEAN |
| **total\_budget**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand total\_budget<br><br><table> <tr> <td> <p> <strong>								amount							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								currency_code							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |
| **total\_budget\_ends\_at**<br><br><br>DATE-TIME |
| **type**<br><br><br>STRING |
| **version**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand version<br><br><table> <tr> <td> <p> <strong>								version_tag							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |

### ad\_analytics\_by\_campaign

The `ad_analytics_by_campaign` table contains analytics data for ads, segmented by campaign.

**Note**: This table is replicated using an attribution window of 7 days. Refer to the [Replication](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#replication) section for more info.

| **Replication Method [](https://help.qlik.com/en-US/stitch/replication/replication-methods)[the Info icon](https://help.qlik.com/en-US/stitch/replication/replication-methods)[](https://help.qlik.com/en-US/stitch/replication/replication-methods)** | Key-based Incremental |
| --- | --- |
| **Primary Keys ![](https://help.qlik.com/en-US/stitch/images/replication/primary-key-icon.svg)** | campaign\_id<br><br>start\_at |
| **Replication Key ![](https://help.qlik.com/en-US/stitch/images/replication/replication-key-icon.svg)** | end\_at |
| **Useful links** | [ad_analytics_by_campaign schema on GitHub](https://github.com/singer-io/tap-linkedin-ads/blob/master/tap_linkedin_ads/schemas/ad_analytics_by_campaign.json "Opens in new tab: ad_analytics_by_campaign schema on GitHub")<br><br><br>[LinkedIn Ads API method](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/ads-reporting?view=li-lms-2022-07&tabs=http#analytics-finder "Opens in new tab: LinkedIn Ads API method") |

ad\_analytics\_by\_campaign table foreign keys

| Join ad\_analytics\_by\_campaign with | on |
| --- | --- |
| [campaigns](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaigns) | ```<br>ad_analytics_by_campaign.campaign_id = campaigns.id<br>``` |
| [creatives](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#creatives) | ```<br>ad_analytics_by_campaign.campaign_id = creatives.campaign_id<br>``` |

ad\_analytics\_by\_campaign table schema

| **action\_clicks**<br><br><br>INTEGER |
| --- |
| **ad\_unit\_clicks**<br><br><br>INTEGER |
| **approximate\_unique\_impressions**<br><br><br>INTEGER |
| **average\_daily\_reach\_metrics**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand average\_daily\_reach\_metrics<br><br><table> <tr> <td> <p> <strong>								approximate_cost_in_currency_per_thousand_members_reached							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_frequency							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_reach							</strong> </p> <p>							NUMBER													</p> </td> </tr> </table> |
| **average\_previous\_seven\_day\_reach\_metrics**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand average\_previous\_seven\_day\_reach\_metrics<br><br><table> <tr> <td> <p> <strong>								approximate_cost_in_currency_per_thousand_members_reached							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_frequency							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_reach							</strong> </p> <p>							NUMBER													</p> </td> </tr> </table> |
| **average\_previous\_thirty\_day\_reach\_metrics**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand average\_previous\_thirty\_day\_reach\_metrics<br><br><table> <tr> <td> <p> <strong>								approximate_cost_in_currency_per_thousand_members_reached							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_frequency							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_reach							</strong> </p> <p>							NUMBER													</p> </td> </tr> </table> |
| **campaign**<br><br><br>STRING |
| **campaign\_id**<br><br><br>INTEGER |
| **card\_clicks**<br><br><br>INTEGER |
| **card\_impressions**<br><br><br>INTEGER |
| **clicks**<br><br><br>INTEGER |
| **comment\_likes**<br><br><br>INTEGER |
| **comments**<br><br><br>INTEGER |
| **company\_page\_clicks**<br><br><br>INTEGER |
| **conversion\_value\_in\_local\_currency**<br><br><br>NUMBER |
| **cost\_in\_local\_currency**<br><br><br>NUMBER |
| **cost\_in\_usd**<br><br><br>NUMBER |
| **date\_range**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand date\_range<br><br><table> <tr> <td> <p> <strong>								end							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand end</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								day							</strong> </p> <p>							INTEGER													</p> </td> </tr> <tr> <td> <p> <strong>								month							</strong> </p> <p>							INTEGER													</p> </td> </tr> <tr> <td> <p> <strong>								year							</strong> </p> <p>							INTEGER													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								start							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand start</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								day							</strong> </p> <p>							INTEGER													</p> </td> </tr> <tr> <td> <p> <strong>								month							</strong> </p> <p>							INTEGER													</p> </td> </tr> <tr> <td> <p> <strong>								year							</strong> </p> <p>							INTEGER													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| **document\_completions**<br><br><br>INTEGER |
| **document\_first\_quartile\_completions**<br><br><br>INTEGER |
| **document\_midpoint\_completions**<br><br><br>INTEGER |
| **document\_third\_quartile\_completions**<br><br><br>INTEGER |
| **download\_clicks**<br><br><br>INTEGER |
| **end\_at**<br><br><br>DATE-TIME |
| **external\_website\_conversions**<br><br><br>INTEGER |
| **external\_website\_post\_click\_conversions**<br><br><br>INTEGER |
| **external\_website\_post\_view\_conversions**<br><br><br>INTEGER |
| **follows**<br><br><br>INTEGER |
| **full\_screen\_plays**<br><br><br>INTEGER |
| **impressions**<br><br><br>INTEGER |
| **job\_applications**<br><br><br>NUMBER |
| **job\_apply\_clicks**<br><br><br>NUMBER |
| **landing\_page\_clicks**<br><br><br>INTEGER |
| **lead\_generation\_mail\_contact\_info\_shares**<br><br><br>INTEGER |
| **lead\_generation\_mail\_interested\_clicks**<br><br><br>INTEGER |
| **likes**<br><br><br>INTEGER |
| **one\_click\_lead\_form\_opens**<br><br><br>INTEGER |
| **one\_click\_leads**<br><br><br>INTEGER |
| **opens**<br><br><br>INTEGER |
| **other\_engagements**<br><br><br>INTEGER |
| **pivot**<br><br><br>STRING |
| **pivot\_value**<br><br><br>STRING |
| **pivot\_values**<br><br>ARRAY<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;. |
| **post\_click\_job\_applications**<br><br><br>NUMBER |
| **post\_click\_job\_apply\_clicks**<br><br><br>NUMBER |
| **post\_click\_registrations**<br><br><br>NUMBER |
| **post\_view\_job\_applications**<br><br><br>NUMBER |
| **post\_view\_job\_apply\_clicks**<br><br><br>NUMBER |
| **post\_view\_registrations**<br><br><br>NUMBER |
| **reactions**<br><br><br>INTEGER |
| **registrations**<br><br><br>NUMBER |
| **sends**<br><br><br>INTEGER |
| **shares**<br><br><br>INTEGER |
| **start\_at**<br><br><br>DATE-TIME |
| **talent\_leads**<br><br><br>INTEGER |
| **text\_url\_clicks**<br><br><br>INTEGER |
| **total\_engagements**<br><br><br>INTEGER |
| **video\_completions**<br><br><br>INTEGER |
| **video\_first\_quartile\_completions**<br><br><br>INTEGER |
| **video\_midpoint\_completions**<br><br><br>INTEGER |
| **video\_starts**<br><br><br>INTEGER |
| **video\_third\_quartile\_completions**<br><br><br>INTEGER |
| **video\_views**<br><br><br>INTEGER |
| **viral\_card\_clicks**<br><br><br>INTEGER |
| **viral\_card\_impressions**<br><br><br>INTEGER |
| **viral\_clicks**<br><br><br>INTEGER |
| **viral\_comment\_likes**<br><br><br>INTEGER |
| **viral\_comments**<br><br><br>INTEGER |
| **viral\_company\_page\_clicks**<br><br><br>INTEGER |
| **viral\_document\_completions**<br><br><br>INTEGER |
| **viral\_document\_first\_quartile\_completions**<br><br><br>INTEGER |
| **viral\_document\_midpoint\_completions**<br><br><br>INTEGER |
| **viral\_document\_third\_quartile\_completions**<br><br><br>INTEGER |
| **viral\_download\_clicks**<br><br><br>INTEGER |
| **viral\_external\_website\_conversions**<br><br><br>INTEGER |
| **viral\_external\_website\_post\_click\_conversions**<br><br><br>INTEGER |
| **viral\_external\_website\_post\_view\_conversions**<br><br><br>INTEGER |
| **viral\_follows**<br><br><br>INTEGER |
| **viral\_full\_screen\_plays**<br><br><br>INTEGER |
| **viral\_impressions**<br><br><br>INTEGER |
| **viral\_job\_applications**<br><br><br>NUMBER |
| **viral\_job\_apply\_clicks**<br><br><br>NUMBER |
| **viral\_landing\_page\_clicks**<br><br><br>INTEGER |
| **viral\_likes**<br><br><br>INTEGER |
| **viral\_one\_click\_lead\_form\_opens**<br><br><br>INTEGER |
| **viral\_one\_click\_leads**<br><br><br>INTEGER |
| **viral\_other\_engagements**<br><br><br>INTEGER |
| **viral\_post\_click\_job\_applications**<br><br><br>NUMBER |
| **viral\_post\_click\_job\_apply\_clicks**<br><br><br>NUMBER |
| **viral\_post\_click\_registrations**<br><br><br>NUMBER |
| **viral\_post\_view\_job\_applications**<br><br><br>NUMBER |
| **viral\_post\_view\_job\_apply\_clicks**<br><br><br>NUMBER |
| **viral\_post\_view\_registrations**<br><br><br>NUMBER |
| **viral\_reactions**<br><br><br>INTEGER |
| **viral\_registrations**<br><br><br>NUMBER |
| **viral\_shares**<br><br><br>INTEGER |
| **viral\_total\_engagements**<br><br><br>INTEGER |
| **viral\_video\_completions**<br><br><br>INTEGER |
| **viral\_video\_first\_quartile\_completions**<br><br><br>INTEGER |
| **viral\_video\_midpoint\_completions**<br><br><br>INTEGER |
| **viral\_video\_starts**<br><br><br>INTEGER |
| **viral\_video\_third\_quartile\_completions**<br><br><br>INTEGER |
| **viral\_video\_views**<br><br><br>INTEGER |

### ad\_analytics\_by\_creative

The `ad_analytics_by_creative` table contains info about ad analytics, segmented by creative.

**Note**: This table is replicated using an attribution window of 7 days. Refer to the [Replication](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#replication) section for more info.

| **Replication Method [](https://help.qlik.com/en-US/stitch/replication/replication-methods)[the Info icon](https://help.qlik.com/en-US/stitch/replication/replication-methods)[](https://help.qlik.com/en-US/stitch/replication/replication-methods)** | Key-based Incremental |
| --- | --- |
| **Primary Keys ![](https://help.qlik.com/en-US/stitch/images/replication/primary-key-icon.svg)** | creative\_id<br><br>start\_at |
| **Replication Key ![](https://help.qlik.com/en-US/stitch/images/replication/replication-key-icon.svg)** | end\_at |
| **Useful links** | [ad_analytics_by_creative schema on GitHub](https://github.com/singer-io/tap-linkedin-ads/blob/master/tap_linkedin_ads/schemas/ad_analytics_by_creative.json "Opens in new tab: ad_analytics_by_creative schema on GitHub")<br><br><br>[LinkedIn Ads API method](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/ads-reporting?view=li-lms-2022-07&tabs=http#analytics-finder "Opens in new tab: LinkedIn Ads API method") |

ad\_analytics\_by\_creative table foreign keys

| Join ad\_analytics\_by\_creative with | on |
| --- | --- |
| [creatives](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#creatives) | ```<br>ad_analytics_by_creative.creative_id = creatives.id<br>``` |

ad\_analytics\_by\_creative table schema

| **action\_clicks**<br><br><br>INTEGER |
| --- |
| **ad\_unit\_clicks**<br><br><br>INTEGER |
| **approximate\_unique\_impressions**<br><br><br>INTEGER |
| **average\_daily\_reach\_metrics**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand average\_daily\_reach\_metrics<br><br><table> <tr> <td> <p> <strong>								approximate_cost_in_currency_per_thousand_members_reached							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_frequency							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_reach							</strong> </p> <p>							NUMBER													</p> </td> </tr> </table> |
| **average\_previous\_seven\_day\_reach\_metrics**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand average\_previous\_seven\_day\_reach\_metrics<br><br><table> <tr> <td> <p> <strong>								approximate_cost_in_currency_per_thousand_members_reached							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_frequency							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_reach							</strong> </p> <p>							NUMBER													</p> </td> </tr> </table> |
| **average\_previous\_thirty\_day\_reach\_metrics**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand average\_previous\_thirty\_day\_reach\_metrics<br><br><table> <tr> <td> <p> <strong>								approximate_cost_in_currency_per_thousand_members_reached							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_frequency							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								approximate_reach							</strong> </p> <p>							NUMBER													</p> </td> </tr> </table> |
| **card\_clicks**<br><br><br>INTEGER |
| **card\_impressions**<br><br><br>INTEGER |
| **clicks**<br><br><br>INTEGER |
| **comment\_likes**<br><br><br>INTEGER |
| **comments**<br><br><br>INTEGER |
| **company\_page\_clicks**<br><br><br>INTEGER |
| **conversion\_value\_in\_local\_currency**<br><br><br>NUMBER |
| **cost\_in\_local\_currency**<br><br><br>NUMBER |
| **cost\_in\_usd**<br><br><br>NUMBER |
| **creative**<br><br><br>STRING |
| **creative\_id**<br><br><br>INTEGER |
| **date\_range**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand date\_range<br><br><table> <tr> <td> <p> <strong>								end							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand end</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								day							</strong> </p> <p>							INTEGER													</p> </td> </tr> <tr> <td> <p> <strong>								month							</strong> </p> <p>							INTEGER													</p> </td> </tr> <tr> <td> <p> <strong>								year							</strong> </p> <p>							INTEGER													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								start							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand start</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								day							</strong> </p> <p>							INTEGER													</p> </td> </tr> <tr> <td> <p> <strong>								month							</strong> </p> <p>							INTEGER													</p> </td> </tr> <tr> <td> <p> <strong>								year							</strong> </p> <p>							INTEGER													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| **document\_completions**<br><br><br>INTEGER |
| **document\_first\_quartile\_completions**<br><br><br>INTEGER |
| **document\_midpoint\_completions**<br><br><br>INTEGER |
| **document\_third\_quartile\_completions**<br><br><br>INTEGER |
| **download\_clicks**<br><br><br>INTEGER |
| **end\_at**<br><br><br>DATE-TIME |
| **external\_website\_conversions**<br><br><br>INTEGER |
| **external\_website\_post\_click\_conversions**<br><br><br>INTEGER |
| **external\_website\_post\_view\_conversions**<br><br><br>INTEGER |
| **follows**<br><br><br>INTEGER |
| **full\_screen\_plays**<br><br><br>INTEGER |
| **impressions**<br><br><br>INTEGER |
| **job\_applications**<br><br><br>NUMBER |
| **job\_apply\_clicks**<br><br><br>NUMBER |
| **landing\_page\_clicks**<br><br><br>INTEGER |
| **lead\_generation\_mail\_contact\_info\_shares**<br><br><br>INTEGER |
| **lead\_generation\_mail\_interested\_clicks**<br><br><br>INTEGER |
| **likes**<br><br><br>INTEGER |
| **one\_click\_lead\_form\_opens**<br><br><br>INTEGER |
| **one\_click\_leads**<br><br><br>INTEGER |
| **opens**<br><br><br>INTEGER |
| **other\_engagements**<br><br><br>INTEGER |
| **pivot**<br><br><br>STRING |
| **pivot\_value**<br><br><br>STRING |
| **pivot\_values**<br><br>ARRAY<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;. |
| **post\_click\_job\_applications**<br><br><br>NUMBER |
| **post\_click\_job\_apply\_clicks**<br><br><br>NUMBER |
| **post\_click\_registrations**<br><br><br>NUMBER |
| **post\_view\_job\_applications**<br><br><br>NUMBER |
| **post\_view\_job\_apply\_clicks**<br><br><br>NUMBER |
| **post\_view\_registrations**<br><br><br>NUMBER |
| **reactions**<br><br><br>INTEGER |
| **registrations**<br><br><br>NUMBER |
| **sends**<br><br><br>INTEGER |
| **shares**<br><br><br>INTEGER |
| **start\_at**<br><br><br>DATE-TIME |
| **talent\_leads**<br><br><br>INTEGER |
| **text\_url\_clicks**<br><br><br>INTEGER |
| **total\_engagements**<br><br><br>INTEGER |
| **video\_completions**<br><br><br>INTEGER |
| **video\_first\_quartile\_completions**<br><br><br>INTEGER |
| **video\_midpoint\_completions**<br><br><br>INTEGER |
| **video\_starts**<br><br><br>INTEGER |
| **video\_third\_quartile\_completions**<br><br><br>INTEGER |
| **video\_views**<br><br><br>INTEGER |
| **viral\_card\_clicks**<br><br><br>INTEGER |
| **viral\_card\_impressions**<br><br><br>INTEGER |
| **viral\_clicks**<br><br><br>INTEGER |
| **viral\_comment\_likes**<br><br><br>INTEGER |
| **viral\_comments**<br><br><br>INTEGER |
| **viral\_company\_page\_clicks**<br><br><br>INTEGER |
| **viral\_document\_completions**<br><br><br>INTEGER |
| **viral\_document\_first\_quartile\_completions**<br><br><br>INTEGER |
| **viral\_document\_midpoint\_completions**<br><br><br>INTEGER |
| **viral\_document\_third\_quartile\_completions**<br><br><br>INTEGER |
| **viral\_download\_clicks**<br><br><br>INTEGER |
| **viral\_external\_website\_conversions**<br><br><br>INTEGER |
| **viral\_external\_website\_post\_click\_conversions**<br><br><br>INTEGER |
| **viral\_external\_website\_post\_view\_conversions**<br><br><br>INTEGER |
| **viral\_follows**<br><br><br>INTEGER |
| **viral\_full\_screen\_plays**<br><br><br>INTEGER |
| **viral\_impressions**<br><br><br>INTEGER |
| **viral\_job\_applications**<br><br><br>NUMBER |
| **viral\_job\_apply\_clicks**<br><br><br>NUMBER |
| **viral\_landing\_page\_clicks**<br><br><br>INTEGER |
| **viral\_likes**<br><br><br>INTEGER |
| **viral\_one\_click\_lead\_form\_opens**<br><br><br>INTEGER |
| **viral\_one\_click\_leads**<br><br><br>INTEGER |
| **viral\_other\_engagements**<br><br><br>INTEGER |
| **viral\_post\_click\_job\_applications**<br><br><br>NUMBER |
| **viral\_post\_click\_job\_apply\_clicks**<br><br><br>NUMBER |
| **viral\_post\_click\_registrations**<br><br><br>NUMBER |
| **viral\_post\_view\_job\_applications**<br><br><br>NUMBER |
| **viral\_post\_view\_job\_apply\_clicks**<br><br><br>NUMBER |
| **viral\_post\_view\_registrations**<br><br><br>NUMBER |
| **viral\_reactions**<br><br><br>INTEGER |
| **viral\_registrations**<br><br><br>INTEGER |
| **viral\_shares**<br><br><br>INTEGER |
| **viral\_total\_engagements**<br><br><br>INTEGER |
| **viral\_video\_completions**<br><br><br>INTEGER |
| **viral\_video\_first\_quartile\_completions**<br><br><br>INTEGER |
| **viral\_video\_midpoint\_completions**<br><br><br>INTEGER |
| **viral\_video\_starts**<br><br><br>INTEGER |
| **viral\_video\_third\_quartile\_completions**<br><br><br>INTEGER |
| **viral\_video\_views**<br><br><br>INTEGER |

### campaign\_groups

The `campaign_groups` table contains info about the campaign groups in your LinkedIn Ads account.

| **Replication Method [](https://help.qlik.com/en-US/stitch/replication/replication-methods)[the Info icon](https://help.qlik.com/en-US/stitch/replication/replication-methods)[](https://help.qlik.com/en-US/stitch/replication/replication-methods)** | Key-based Incremental |
| --- | --- |
| **Primary Key ![](https://help.qlik.com/en-US/stitch/images/replication/primary-key-icon.svg)** | id |
| **Replication Key ![](https://help.qlik.com/en-US/stitch/images/replication/replication-key-icon.svg)** | last\_modified\_time |
| **Useful links** | [campaign_groups schema on GitHub](https://github.com/singer-io/tap-linkedin-ads/blob/master/tap_linkedin_ads/schemas/campaign_groups.json "Opens in new tab: campaign_groups schema on GitHub")<br><br><br>[LinkedIn Ads API method](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-campaign-groups?view=li-lms-2022-07&tabs=http#search-for-campaign-groups "Opens in new tab: LinkedIn Ads API method") |

campaign\_groups table foreign keys

| Join campaign\_groups with | on |
| --- | --- |
| [account_users](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#account-users) | ```<br>campaign_groups.account_id = account_users.account_id<br>``` |
| [accounts](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#accounts) | ```<br>campaign_groups.account_id = accounts.id<br>``` |
| [campaigns](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaigns) | ```<br>campaign_groups.account_id = campaigns.account_id<br>```<br><br>```<br>campaign_groups.id = campaigns.campaign_group_id<br>``` |
| [video_ads](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#video-ads) | ```<br>campaign_groups.account_id = video_ads.account_id<br>``` |

campaign\_groups table schema

| **account**<br><br><br>STRING |
| --- |
| **account\_id**<br><br><br>INTEGER |
| **allowed\_campaign\_types**<br><br><br>ARRAY<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;. |
| **backfilled**<br><br><br>BOOLEAN |
| **change\_audit\_stamps**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand change\_audit\_stamps<br><br><table> <tr> <td> <p> <strong>								created							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand created</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								last_modified							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand last_modified</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| **created\_time**<br><br><br>DATE-TIME |
| **id**<br><br><br>INTEGER |
| **last\_modified\_time**<br><br><br>DATE-TIME |
| **name**<br><br><br>STRING |
| **run\_schedule**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand run\_schedule<br><br><table> <tr> <td> <p> <strong>								end							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> <tr> <td> <p> <strong>								start							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> </table> |
| **serving\_statuses**<br><br>ARRAY<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;. |
| **status**<br><br><br>STRING |
| **test**<br><br><br>BOOLEAN |
| **total\_budget**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand total\_budget<br><br><table> <tr> <td> <p> <strong>								amount							</strong> </p> <p>							NUMBER													</p> </td> </tr> <tr> <td> <p> <strong>								currency_code							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |

### campaigns

The `campaigns` table contains info about the campaigns in your LinkedIn Ads account.

| **Replication Method [](https://help.qlik.com/en-US/stitch/replication/replication-methods)[the Info icon](https://help.qlik.com/en-US/stitch/replication/replication-methods)[](https://help.qlik.com/en-US/stitch/replication/replication-methods)** | Key-based Incremental |
| --- | --- |
| **Primary Key ![](https://help.qlik.com/en-US/stitch/images/replication/primary-key-icon.svg)** | id |
| **Replication Key ![](https://help.qlik.com/en-US/stitch/images/replication/replication-key-icon.svg)** | last\_modified\_time |
| **Useful links** | [campaigns schema on GitHub](https://github.com/singer-io/tap-linkedin-ads/blob/master/tap_linkedin_ads/schemas/campaigns.json "Opens in new tab: campaigns schema on GitHub")<br><br><br>[LinkedIn Ads API method](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-campaigns?view=li-lms-2022-07&tabs=http#search-for-campaigns "Opens in new tab: LinkedIn Ads API method") |

campaigns table foreign keys

| Join campaigns with | on |
| --- | --- |
| [account_users](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#account-users) | ```<br>campaigns.account_id = account_users.account_id<br>``` |
| [accounts](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#accounts) | ```<br>campaigns.account_id = accounts.id<br>``` |
| [campaign_groups](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaign-groups) | ```<br>campaigns.account_id = campaign_groups.account_id<br>```<br><br>```<br>campaigns.campaign_group_id = campaign_groups.id<br>``` |
| [video_ads](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#video-ads) | ```<br>campaigns.account_id = video_ads.account_id<br>``` |
| [creatives](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#creatives) | ```<br>campaigns.id = creatives.campaign_id<br>``` |
| [ad_analytics_by_campaign](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#ad-analytics-by-campaign) | ```<br>campaigns.id = ad_analytics_by_campaign.campaign_id<br>``` |

campaigns table schema

| **targeting**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand targeting<br><br><table> <tr> <td> <p> <strong>								included_targeting_facets							</strong> </p> <p> </p> <p>ARRAY																																</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand included_targeting_facets</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								type							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								values							</strong> </p> <p> </p> <p>ARRAY																																</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								excluded_targeting_facets							</strong> </p> <p> </p> <p>ARRAY																																</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand excluded_targeting_facets</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								type							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								values							</strong> </p> <p> </p> <p>ARRAY																																</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| --- |
| **targeting\_criteria**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand targeting\_criteria<br><br><table> <tr> <td> <p> <strong>								include							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand include</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								and							</strong> </p> <p> </p> <p>ARRAY																																</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand and</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								type							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								values							</strong> </p> <p> </p> <p>ARRAY																																</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								exclude							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand exclude</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								or							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand or</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								urn:li:ad_targeting_facet:titles							</strong> </p> <p>							ARRAY																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> <tr> <td> <p> <strong>								urn:li:ad_targeting_facet:staff_count_ranges							</strong> </p> <p>							ARRAY																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> <tr> <td> <p> <strong>								urn:li:ad_targeting_facet:followed_companies							</strong> </p> <p>							ARRAY																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> <tr> <td> <p> <strong>								urn:li:ad_targeting_facet:seniorities							</strong> </p> <p>							ARRAY																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| **serving\_statuses**<br><br>ARRAY<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;. |
| **type**<br><br><br>STRING |
| **story\_delivery\_enabled**<br><br><br>BOOLEAN |
| **connected\_television\_only**<br><br><br>BOOLEAN |
| **political\_intent**<br><br><br>STRING |
| **total\_budget**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand total\_budget<br><br><table> <tr> <td> <p> <strong>								currency_code							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								amount							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |
| **version\_tag**<br><br><br>STRING |
| **locale**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand locale<br><br><table> <tr> <td> <p> <strong>								country							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								language							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |
| **version**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand version<br><br><table> <tr> <td> <p> <strong>								version_tag							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |
| **associated\_entity**<br><br><br>STRING |
| **associated\_entity\_organization\_id**<br><br><br>INTEGER |
| **associated\_entity\_person\_id**<br><br><br>STRING |
| **run\_schedule**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand run\_schedule<br><br><table> <tr> <td> <p> <strong>								start							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								end							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |
| **optimization\_target\_type**<br><br><br>STRING |
| **change\_audit\_stamps**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand change\_audit\_stamps<br><br><table> <tr> <td> <p> <strong>								created							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand created</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							STRING													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								last_modified							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand last_modified</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							STRING													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| **created\_time**<br><br><br>STRING |
| **last\_modified\_time**<br><br><br>STRING |
| **campaign\_group**<br><br><br>STRING |
| **campaign\_group\_id**<br><br><br>INTEGER |
| **daily\_budget**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand daily\_budget<br><br><table> <tr> <td> <p> <strong>								amount							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								currency_code							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |
| **unit\_cost**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand unit\_cost<br><br><table> <tr> <td> <p> <strong>								amount							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								currency_code							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |
| **creative\_selection**<br><br><br>STRING |
| **cost\_type**<br><br><br>STRING |
| **name**<br><br><br>STRING |
| **objective\_type**<br><br><br>STRING |
| **offsite\_delivery\_enabled**<br><br><br>BOOLEAN |
| **offsite\_preferences**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand offsite\_preferences<br><br><table> <tr> <td> <p> <strong>								iab_categories							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand iab_categories</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								exclude							</strong> </p> <p>							ARRAY																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> <tr> <td> <p> <strong>								include							</strong> </p> <p>							ARRAY																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								publisher_restriction_files							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand publisher_restriction_files</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								exclude							</strong> </p> <p>							ARRAY																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| **id**<br><br><br>INTEGER |
| **audience\_expansion\_enabled**<br><br><br>BOOLEAN |
| **test**<br><br><br>BOOLEAN |
| **format**<br><br><br>STRING |
| **pacing\_strategy**<br><br><br>STRING |
| **account**<br><br><br>STRING |
| **account\_id**<br><br><br>INTEGER |
| **status**<br><br><br>STRING |

### creatives

The Creatives API contains all the data and information for visually rendering an ad.

| **Replication Method [](https://help.qlik.com/en-US/stitch/replication/replication-methods)[the Info icon](https://help.qlik.com/en-US/stitch/replication/replication-methods)[](https://help.qlik.com/en-US/stitch/replication/replication-methods)** | Key-based Incremental |
| --- | --- |
| **Primary Key ![](https://help.qlik.com/en-US/stitch/images/replication/primary-key-icon.svg)** | id |
| **Replication Key ![](https://help.qlik.com/en-US/stitch/images/replication/replication-key-icon.svg)** | last\_modified\_at |
| **Useful links** | [LinkedIn Ads documentation](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-creatives?view=li-lms-2023-01&tabs=http#search-for-creatives "Opens in new tab: LinkedIn Ads documentation")<br><br><br>[creatives schema on GitHub](https://github.com/singer-io/tap-linkedin-ads/tree/master/tap_linkedin_ads/schemas/creatives.json "Opens in new tab: creatives schema on GitHub") |

creatives table foreign keys

| Join creatives with | on |
| --- | --- |
| [campaigns](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaigns) | ```<br>creatives.campaign_id = campaigns.id<br>``` |
| [ad_analytics_by_campaign](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#ad-analytics-by-campaign) | ```<br>creatives.campaign_id = ad_analytics_by_campaign.campaign_id<br>``` |
| [ad_analytics_by_creative](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#ad-analytics-by-creative) | ```<br>creatives.id = ad_analytics_by_creative.creative_id<br>``` |

creatives table schema

| **account**<br><br><br>STRING |
| --- |
| **name**<br><br><br>STRING |
| **review**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand review<br><br><table> <tr> <td> <p> <strong>								status							</strong> </p> <p>							STRING													</p> </td> </tr> </table> |
| **account\_id**<br><br><br>INTEGER |
| **campaign**<br><br><br>STRING |
| **campaign\_id**<br><br><br>INTEGER |
| **content**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand content<br><br><table> <tr> <td> <p> <strong>								reference							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								text_ad							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand text_ad</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								headline							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								description							</strong> </p> <p>							STRING													</p> </td> </tr> <tr> <td> <p> <strong>								landing_page							</strong> </p> <p>							STRING													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| **created\_at**<br><br><br>STRING |
| **created\_by**<br><br><br>STRING |
| **last\_modified\_at**<br><br><br>STRING |
| **last\_modified\_by**<br><br><br>STRING |
| **id**<br><br><br>STRING |
| **intended\_status**<br><br><br>STRING |
| **is\_serving**<br><br><br>BOOLEAN |
| **is\_test**<br><br><br>BOOLEAN |
| **serving\_hold\_reasons**<br><br><br>ARRAY<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes will be denested into a subtable. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;. |

### video\_ads

The `video_ads` table contains info about the video ads in your LinkedIn Ads account.

| **Replication Method [](https://help.qlik.com/en-US/stitch/replication/replication-methods)[the Info icon](https://help.qlik.com/en-US/stitch/replication/replication-methods)[](https://help.qlik.com/en-US/stitch/replication/replication-methods)** | Key-based Incremental |
| --- | --- |
| **Primary Key ![](https://help.qlik.com/en-US/stitch/images/replication/primary-key-icon.svg)** | content\_reference |
| **Replication Key ![](https://help.qlik.com/en-US/stitch/images/replication/replication-key-icon.svg)** | last\_modified\_time |
| **Useful links** | [video_ads schema on GitHub](https://github.com/singer-io/tap-linkedin-ads/blob/master/tap_linkedin_ads/schemas/video_ads.json "Opens in new tab: video_ads schema on GitHub")<br><br><br>[LinkedIn Ads API method](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/advertising-targeting/create-and-manage-video?view=li-lms-unversioned&tabs=http&viewFallbackFrom=li-lms-2022-07#finders "Opens in new tab: LinkedIn Ads API method") |

video\_ads table foreign keys

| Join video\_ads with | on |
| --- | --- |
| [account_users](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#account-users) | ```<br>video_ads.account_id = account_users.account_id<br>``` |
| [accounts](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#accounts) | ```<br>video_ads.account_id = accounts.id<br>``` |
| [campaigns](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaigns) | ```<br>video_ads.account_id = campaigns.account_id<br>``` |
| [campaign_groups](https://help.qlik.com/en-US/stitch/integrations/saas/linkedin-ads#campaign-groups) | ```<br>video_ads.account_id = campaign_groups.account_id<br>``` |

video\_ads table schema

| **account**<br><br><br>STRING |
| --- |
| **account\_id**<br><br><br>INTEGER |
| **change\_audit\_stamps**<br><br><br>OBJECT<br><br>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.<br><br>Click to expand change\_audit\_stamps<br><br><table> <tr> <td> <p> <strong>								created							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand created</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> <tr> <td> <p> <strong>								last_modified							</strong> </p> <p>							OBJECT																							</p><div><button><div>This is a nested data structure. If your destination doesn't natively support nested data, attributes in this object will be flattened into the table. &lt;a href='/en-US/stitch/replication/loading/understanding-loading-row-usage-for-nested-data-structures' target='new'&gt;Learn more&lt;/a&gt;.</div></button></div> <p></p> <div> <button>Click to expand last_modified</button><div> <div> <div><div><table> <tr> <td> <p> <strong>								time							</strong> </p> <p>							DATE-TIME													</p> </td> </tr> </table></div></div></div> </div></div> </td> </tr> </table> |
| **content\_reference**<br><br><br>STRING |
| **content\_reference\_share\_id**<br><br><br>INTEGER |
| **content\_reference\_ucg\_post\_id**<br><br><br>INTEGER |
| **created\_time**<br><br><br>DATE-TIME |
| **last\_modified\_time**<br><br><br>DATE-TIME |
| **name**<br><br><br>STRING |
| **owner**<br><br><br>STRING |
| **owner\_organization\_id**<br><br><br>INTEGER |
| **type**<br><br><br>STRING |