LinkedIn Ads - Structure
Vendor/Partner | |
|---|---|
Version |
|
API Documentation | https://learn.microsoft.com/en-us/linkedin/marketing/versioning?view=li-lms-2023-03#version-cadence |
Sunset Date | None as of 01.04.2024 |
Channel(s) | Social |
Refresh Time (CST) | 6 am |
Default backfill | N/A |
Alli Data Library |
|
Before Getting Started
To get started with the LinkedIn Ads Structure datasource, ensure you have the following:
A LinkedIn profile with at least Viewer access to a LinkedIn Ads account
A LinkedIn Ads account ID found in LinkedIn Campaign Manager
Required Authorization
Click the button to login to your LinkedIn account instance and provide Alli access to your ad accounts.
Additional Configurations
Account ID
Paste in your LinkedIn Ads account ID.
Report Type
Select the type of report, Campaign, Conversion, or Creative, that you like to gather data for.
Account Report
Column Name | Comments |
|---|---|
Account ID | Unique numerical identifier for the advertising account |
Test Account | Flag showing whether this account is marked as a test account. |
Currency | The ISO 4217 currency code of the account |
Name | Name of the Account |
Reference Account | The entity on whose behalf the account advertises. |
Serving Statuses | An array of enums with information about the account's system serving statuses. |
Status | Status of the Account |
Type | Either BUSINESS or ENTERPRISE |
Campaign Groups Report
Column Name | Description |
|---|---|
Campaign Group ID | Unique numerical identifier for the campaign group |
Account ID | URN identifying the advertising account associated with the Campaign. This value is immutable once set |
Is Test Account | Flag showing whether this campaign group is a test campaign group |
Name | The name of the campaign group used to make it easier to reference a campaign group and recall its purpose. |
Serving Status | Array of enums that determine whether or not campaigns within the campaign group may be served |
Backfilled Status | Flag that denotes whether the campaign group was created organically or to backfill existing campaigns. |
Status | Status of campaign group. |
Campaign Report
Column Name | Description |
|---|---|
Campaign ID | Unique numerical identifier for the ad campaign |
Name | The name of the Campaign; primarily used to make it easier to reference a Campaign and to recall its purpose |
Account ID | URN identifying the advertising account associated with the Campaign. This value is immutable once set |
Campaign Group ID | URN identifying the campaign group associated with the Campaign |
Associated Entity | An URN for a strongly associated object, with semantics varying based on the Campaign type. The urn typically identifies the intended beneficiary of the advertising campaign, such as a specific company or member |
Audience Expansion | Campaign provides query expansion for certain targeting criteria. Set to true or false. |
Cost Type | CPM - Cost per thousand advertising impressions CPC - Cost per individual click on the associated link |
Creative Selection | ROUND_ROBIN - Rotate through available creatives to serve them as easily as possible OPTIMIZED - Bias selection taking into account such things as expected performance. Not available for Message and Conversation Ads (type=SPONSORED_INMAILS) |
Daily Budget Amount | Maximum amount to spend per day. |
Daily Budget Currency | ISO currency code |
Offsite Delivery | Campaign access to be served on the LinkedIn Advertising Network. Set to true or false. |
Status | Status of the campaign |
Locale Country | Locale of the campaign. The language and country come from ISO-639-1 and ISO-3166-1 alpha-2, respectively. An uppercase two-letter country code as defined by ISO-3166. |
Locale Language | Locale of the campaign. The language and country come from ISO-639-1 and ISO-3166-1 alpha-2, respectively. A lowercase two-letter language code as defined by ISO-639. |
Type | The type, either TEXT_AD or SPONSORED_UPDATES |
Total Budget Amount | Total Budget Amount |
Total Budget Currency Code | Total Budget Currency Code |
Pacing Strategy | Identifies the pacing option used for the campaign.
|
Optimization Target Type | Determines how this campaign is optimized for spending. If this is not set, there is no optimization. |
Creative Report
Column Name | Description |
|---|---|
Creative ID | Unique numerical identifier for the ad creative |
Account ID | URN identifying the Account associated with the creative |
Campaign ID | URN identifying the campaign associated with the creative |
Status | The possible values are:
|
Serving Status | This indicates whether the creative is currently being served or not |
Content URN reference | Content sponsored in the creative. |
Created At | Time at which the resource was created in milliseconds since epoch. |
Last Modified | Time at which the resource was last modified in milliseconds since epoch. |
Posts Report
Posts can be joined with Creatives by Post ID and Creative content_reference
Column Name | Description |
|---|---|
Post ID | Unique numerical identifier for the post |
Status | The status of the advertising company content |
Name | Name of the DSC post |
Type | The type of DSC (e.g. VIDEO, STANDARD, CAROUSEL, etc.) |
Account ID | Ad Account that created the Direct Sponsored Content |
Commentary | The user generated commentary for the post. |
URL | Web page that is opened when the member clicks on the associated content. |
Article Title | Article Title |
Created At | Time at which the resource was created in milliseconds since epoch. |
Last Modified | Time at which the resource was last modified in milliseconds since epoch. |
Visibility Restrictions | Visibility restrictions on content.
|
Published Time | The time at which the content was published represented in epoch time. |
author | URN of the author of the content. |
Frequently Asked Questions
How can I get the name of my creative?
LinkedIn keeps the creative name within their Post report as name. This report type can be joined with the creative report using the Post ID and the Creative Content URN reference.
Why did my datasource stop loading data?
This could be for a number of different reasons, however it’s often related to the authorization. We suggest trying to refresh your authorization if it has been over a year.