LinkedIn Conversions API

With LinkedIn Conversions API modules in Boost.space Integrator, you can associate a campaign to a conversion, create conversion rules and reports, send conversion events, and list conversion rules in your LinkedIn account.

To use the LinkedIn Conversions API modules, you must have a LinkedIn account with the following user permissions: r_ads, rw_offlineConversions, rw_conversions, r_ads_reporting. You can create an account at linkedin.com.

Connect LinkedIn Conversions API to Boost.space Integrator

To connect your LinkedIn Ads Campaign Management account to Make, you can choose between two different connection methods:

  • LinkedIn

  • LinkedIn (OpenID Connect)

    Note: This connection method uses OpenID Connect for a secure and standardized way to manage user identities.

  1. Log in to your Boost.space Integrator account, add a LinkedIn Conversions API module to your scenario, and click Create a connection.

  2. Optional: In the Connection name field, enter a name for the connection.

  3. Optional: Click Show Advanced Settings and add additional scopes and/or enter your custom client credentials, and Developer Application URN. For more information, see the LinkedIn API documentation.

    If requested, use the following Redirect URI when creating your custom app:

    • LinkedIn: https://integrator.boost.space/oauth/cb/linkedin2

    • LinkedIn (OpenID Connect): https://integrator.boost.space/oauth/cb/linkedin-openid

  4. Click Save.

  5. If prompted, authenticate your account and confirm access.

You have successfully established the connection. You can now edit your scenario and add more LinkedIn Conversions API modules. If your connection requires reauthorization at any point, follow the connection renewal steps here.

Build LinkedIn Conversions API Scenarios

After connecting the app, you can perform the following actions:

Actions

Associate Campaign to Conversion

Associates a campaign to a conversion rule by their IDs.

Connection

Establish a connection to your LinkedIn Conversions API account.Connecting LinkedIn Offline Conversions with Boost.space Integrator

Campaign ID

Select the Campaign ID which you want to associate with the conversion.

Conversion Rule ID

Select or map the Conversion Rule ID to which you want to associate the campaign.

Create a Conversion Rule

Creates a new conversion rule to track conversions.

Connection

Establish a connection to your LinkedIn Conversions API account.Connecting LinkedIn Offline Conversions with Boost.space Integrator

Account URN

Select or map the account for which you want to create the conversion rule.

Name

Enter (map) a name for the conversion rule.

Type

Select or map the offline conversion rule type to track this conversion rule. For example, Ad Click. See the complete list of conversion rule types.

Attribution Type

Select or map the attribution type that describes the process to count the conversion actions:

  • Last touch by campaign

  • Last touch by conversion

Post Click Attribution Window Size

Specifies a user’s settings on the post-click attribution window in days. For example, 5.

View through Attribution Window Size

Specifies a user’s settings on the view through (post view) attribution window in days. For example, 5.

Send Conversion Events

Sends multiple conversion events in a batch.

Connection

Establish a connection to your LinkedIn Conversions API account.Connecting LinkedIn Offline Conversions with Boost.space Integrator

Account URN

Select or map the account to which you want to send the conversion events

Events

Enter (map) the event details. You can add multiple actions.

Conversion

Conversion Rule

Enter (map) the rule that determines the action in which the conversion occurred.

Conversion Happened At

Enter (map) the time at which the conversion happened. See the list of supported date and time formats.

User

Enter the user details:

User IDs

Enter (map) the user’s email address. You can add multiple email addresses by clicking Add item.

First Name

Enter (map) the user’s first name. The maximum number of allowed characters is 35.

Last Name

Enter (map) the user’s last name. The maximum number of allowed characters is 35.

Company Name

Enter (map) the user’s company name. The maximum number of allowed characters is 50.

Title

Enter (map) the user’s job title. The maximum number of allowed characters is 50.

Country Code

Enter (map) the user’s ISO standardized country code. For example, US.

Lead

Enter (map) the lead gen form response of the user. The value should be in the following format: urn:li:leadGenFormResponse:id.

Conversion Value

Enter the conversion details:

Conversion Type

Select or map the conversion type. For example, download.

Money Amount

Enter the amount details.

Amount

Enter the amount applicable to the conversion.

Currency Code

Enter the applicable three-letter currency code.

Event ID

The unique id generated by advertisers to indicate each event. This field is optional and is used for deduplication.

Searches

Generate a Conversion Report

Generates a conversion report.

Connection

Establish a connection to your LinkedIn Conversions API account.Connecting LinkedIn Offline Conversions with Boost.space Integrator

Accounts

Select or map the accounts for which you want to generate the conversion report.

Time Granularity

Select or map the time for which you want to generate the report:

  • All

  • Daily

  • Monthly

  • Yearly

Start Date

Enter (map) the date to generate the report of the offline conversions that occurred on or after the specified date. See the list of supported date and time formats.

End Date

Enter (map) the date to generate the report of the offline conversions that occurred on or before the specified date. See the list of supported date and time formats.

Pivots

Select or map the pivots to include in the report. Conversion is the default pivot and you can add at the most two additional pivots to include in the report.

Campaigns

Select or map the campaigns for which you want to generate the conversion report.

Note: Either Accounts or Campaigns must be provided.

Fields

Select or map the fields to include in the report:

  • External Website Conversion

  • External Website Post Click Conversion

  • External Website Post View Conversion

  • Viral External Website Conversion

  • Viral External Website Post Click Conversion

  • Viral External Website Post View Conversion

Campaign Type

Select or map the campaign type for which you want to generate the report:

  • Text Ad

  • Sponsored Updates

  • Sponsored InMails

  • Dynamic

Limit

Set the maximum number of results Boost.space Integrator should return during one execution cycle.

List Conversion Rules

Retrieves a list of conversion rules by the ad account.

Connection

Establish a connection to your LinkedIn Conversions API account.Connecting LinkedIn Offline Conversions with Boost.space Integrator

Account URN

Select or map the account whose conversion rules you want to list.

Conversion Method

Select the filtering method of conversion rules:

  • Offline Conversions Upload

  • Conversions API

If not specified, both types are returned.

Limit

Set the maximum number of conversion rules Boost.space Integrator should return during one execution cycle.