LinkedIn Ads Connector

The Switchboard LinkedIn Ads Connector connector provides automated ingestion of Ad Analytics and Campaign Recommendations reports.

Prerequisites

To configure access to the Switchboard LinkedIn Ads connector, you need:

Client ID
Go to the LinkedIn Developer Portal, select the app you’ll be using, click the “Auth” tab,
Client Secret
Go to the LinkedIn Developer Portal, select the app you’ll be using, click the “Auth” tab,

Scheduling

The LinkedIn Ads connector can be scheduled to ingest data once per day at a user-defined hour and timezone. By default, the connector will run once at 6am PT. See Daily Scheduling for more information.

LinkedIn Ad Analytics Reports

To import LinkedIn Ad Analytics reports, use the linkedin:ad_analytics import type.

Sample Switchboard Script

download t from {
            type: "linkedin:ad_analytics";
            key: "linkedin_key";

            # Required; customer can find them through Linkedin UI (see notes below)
            campaign_group_ids: ["<sample id>"];
 
            # Required; report_type (or [pivot](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/ads-reporting#query-parameters) as LinkedIn calls it)  is the field that Linkedin will use to group the data.
            report_type: "<report_type>";
            fields: ["<field>", "<field>", "<field>", ......]; # 20 fields max.

            # Allows daily schedule
            # Allows lookback_days, lookback_months and lookback_years
} using {*};

Parameters

report_type
Pivot of results, by which each report data point is grouped. Corresponds to the pivot query parameter the underlying API call.

The following values are supported:

  • COMPANY
  • ACCOUNT
  • SHARE
  • MEMBER_COMPANY
fields
up to 20 metrics available as specified in the dcoumentation for the Ad Analytics endpoint.

For further information consult the LinkedIn Reporting documentation

LinkedIn Campaign Recommendation Reports

To import Linked In Campaign Recommendation reports, use the linkedin:campaign_recommendation import type.

Sample Switchboard Script

download t from {
            type: "linkedin:campaign_recommendation";
            key: "linkedin_key";

           # Required: This is the list of ids of the campaign group to base the search on. Same as campaign_group_ids in the above endpoint, customers can find it through the UI.
           sponsored_campaigns: ["..."]

            # Allows daily schedule
            # Allows lookback_days, lookback_months and lookback_years
} using {*};

Parameters

sponsored_campaigns
Sponsored Campaign URNs for which recommendations should be returned. Specify multiple campaigns parameters with additional campaign URNs to request recommendations for multiple campaigns.

For further information consult the the LinkedIn Campaign Recommendations documentation