Skip to main content
Skip table of contents

Install LinkedIn CAPI with JENTIS

LinkedIn campaign tracking allows businesses to monitor the effectiveness of their marketing efforts on the platform. By utilizing unique campaign parameters, businesses can accurately attribute conversions and engagements to specific LinkedIn campaigns. Detailed analytics provided through LinkedIn campaign tracking empower businesses to optimize their strategies and maximize their return on investment.

Official Ressources

Step by Step - Guide

Create a new app in LinkedIn

Follow the steps given below to implement the 3-legged OAuth for LinkedIn APIs:

Configure your Application

Official Documentation: https://learn.microsoft.com/en-us/linkedin/shared/authentication/authorization-code-flow?context=linkedin%2Fcontext&tabs=HTTPS1#step-1-configure-your-application

Request an Authorization Code

Official Documentation: https://learn.microsoft.com/en-us/linkedin/shared/authentication/authorization-code-flow?context=linkedin%2Fcontext&tabs=HTTPS1#step-2-request-an-authorization-code

image-20240403-071942.png

To request the Authorization Code, please redirect to your main domain, for example. The sole purpose of this action is to extract the authorization code from the redirected URL.

This is the example request for retrieving the authorization code with the necessary scopes for JENTIS. Please replace

  • Client-ID

  • Redirect-URL

with your configured values from the APP:

CODE
https://www.linkedin.com/oauth/v2/authorization?response_type=code&client_id={Client-ID}&redirect_uri={Redirect-URL}&state=foobar&scope=rw_conversions%20r_ads

On the resulted redirect-URL the URL-Parameter code is added. Please copy/paste this authorization code.

Example goal-url after successful authentication:

CODE
https://www.jentis.com/?code=AQSmy0q_HjWVRuN13pyE4i646Hfvpg6fFxNqQvOrSZLUSobxkkeJWCCIvEvOF2T3ZwWMSWhM-elssFrgfm-1LyYSmdfyvw2-1IShau_KFMHccex7iObqsFIf7Nvt9p3K8r7ymY6Yqq7rJLGmtQ9jvUb66qGw8QD3B8nYDCeQ4q_tobdmnr1Ha75EUcxEXpJbGaTPDB7UWeAyBxgV5dI&state=foobar

Install the LinkedIn Tool in JENTIS

image-20240403-072707.png

Transfer now all the necessary tool-constants to the configuration page of the LinkedIn tool in JENTIS:

Client-ID

Generated in the Application Credentials Auth Screen

(See Screenshot from LinkedIn above)

Client-Secret

Generated in the Application Credentials Auth Screen

(See Screenshot from LinkedIn above)

Redirect-URL

Configured in the Application Credentials Auth Screen and must be used 1:1 the same on the JENTIS Configuration

(See Screenshot from LinkedIn above)

APP-Code

Added on the redirect_uri after the customer successfully created an APP-Code (described above how to retrieve it)

Default Tags

For the server-side approach we are per default installing a Campaign-Parameter Detection Tag and a Conversion-Tag.

Campaign-Detection - Tag

The Campaign-Parameter Detection Tag is searching on all pageviews for the URL-Parameter “li_fat_id” and stores it in the server-side storage of the tool. This value must be then re-used on the conversion tag.

Conversion - Tag

Official Documentation: https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api?view=li-lms-2023-09&tabs=http#streaming-conversion-events

Everything mentioned in the official documentation can be configured on our side. By default, we have already set up everything needed to track conversions to LinkedIn, including the campaign parameter. If you wish to track additional information, please follow the guidelines provided by LinkedIn and refer to the official documentation.

Where can I find the Converison-ID?

In the LinkedIn Campaign-Manager click on the conversion you want to track.

image-20240403-105644.png

On the following page, please extract from the URL the conversion-id and enter this in the corresponding placeholder on the conversion-template in JENTIS.

image-20240403-105744.png

First Tests

After generating an APP-Code, please trigger a conversion within the next 5 minutes via preview to retrieve and store an access token. Failure to do so promptly after generating the APP-Code may result in its expiration, rendering it unusable. In the event of changing the APP-Code at the Tool-Edit-Level, our system will automatically attempt to obtain a new Authorization Token. Upon successful testing, JENTIS manages the authorization and refresh tokens for future use.

When an APP-Code has been used once, it is not usable for a second attempt. You must generate a new APP-Code until you have retrieved your first access token.

Deduplication

By default, if you are using both client-side and server-side tags, deduplication is active and shared between them, provided that the corresponding tags (client-side conversion and server-side conversion) use the same trigger.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.