# LinkedIn Ads

## How It Works <a href="#sync-with-your-activecampaign-list" id="sync-with-your-activecampaign-list"></a>

The LinkedIn Ads integration lets you retarget website visitors who arrive through referral links and track their conversions. Once connected, LinkedIn Ads will track these referred visitors and conversions when they submit their email addresses on your website.

{% hint style="success" %}
Under the hood, GrowSurf loads the LinkedIn Ads library for event tracking. If LinkedIn Ads is already installed, GrowSurf intelligently avoids loading it twice.
{% endhint %}

***

## How to Set Up

**Step 1**: In *Campaign Editor > 4. Options > Integrations*, open the LinkedIn Ads integration card and enter your [LinkedIn Ads partner ID](https://www.linkedin.com/help/lms/answer/a417869/access-your-linkedin-partner-id?lang=en).

{% hint style="info" %}
**Note:** If you are 100% certain that you already have LinkedIn Ads installed on your website, you do not need to enter in the LinkedIn Ads partner ID. Simply press *Connect* and the integration will be enabled. However, we recommend that you still enter it to account for URLs that do not have LinkedIn Ads installed.
{% endhint %}

<figure><img src="https://2794996218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LeklWo0yn03AhWro2Ux%2Fuploads%2F66BvWTx3ocXcTpn1shku%2Fimage.png?alt=media&#x26;token=7bcb26e0-adc1-4fb7-901a-f2564b32d2a7" alt=""><figcaption></figcaption></figure>

**Step 2:** Once connected, GrowSurf will have all events enabled by default. Disable any events that you do not want to track.

**Step 3:** In your LinkedIn Ads account, you will need to add the following two Insight Tag conversions (You can skip this step if you have both "Track conversion event" checkboxes toggled off). Follow the instructions in [How to Add Insight Tag Conversions In LinkedIn Ads](#how-to-add-insight-tag-conversions-in-linkedin-a-ds).

* `growsurf_referral_signup` - This conversion event represents when a referred visitor submits their email address on the form on your website that has referral tracking on it.
* `growsurf_referral_trigger` - This conversion event represents when a participant completes a qualifying action, like making a purchase (Note: this only applies when you are using [`growsurf.triggerReferral()`](https://docs.growsurf.com/developer-tools/javascript-sdk/api-reference#trigger-referral)from the front-end).

***

## How to Add Insight Tag Conversions In LinkedIn Ads

<details>

<summary>Open instructions</summary>

You'll need to complete steps 1-12 below for each event `growsurf_referral_signup` and `growsurf_referral_trigger`.

1. Log into your [LinkedIn Ads Campaign Manager account](https://www.linkedin.com/campaignmanager/login).
2. In the left-side menu, navigate to *Measurement > Conversion tracking* and click *Create conversion > Insight Tag conversion* (see image below).

   <figure><img src="https://2794996218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LeklWo0yn03AhWro2Ux%2Fuploads%2FRV5QJjISYvzrVEUGkxPi%2Fimage.png?alt=media&#x26;token=c9e104c2-afa4-4e05-a751-c7dbdd817a05" alt=""><figcaption></figcaption></figure>
3. For the Name, enter the following conversion name depending on which conversion event you're adding:
   1. `growsurf_referral_signup`&#x20;
   2. `growsurf_referral_trigger`
4. For the conversion category, choose one of the following:
   1. For `growsurf_referral_signup`, we recommend using "Sign Up" (or choose a different category that best represents a referred visitor signing up).
   2. For `growsurf_referral_trigger`, we recommend using "Purchase" (or choose a different category that best represents when a referred participant completes a qualifying action, which triggers a referral).
5. Set the currency (optional).
6. For the other fields like Clicks and Views, you can adjust to your preferences.
7. Click the bottom *Next Step* button (see image below).

   <figure><img src="https://2794996218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LeklWo0yn03AhWro2Ux%2Fuploads%2FCjj7v61As4kq1hLdnesE%2Fimage.png?alt=media&#x26;token=b72e4047-a542-4463-bb07-1bbc3c8b0d55" alt=""><figcaption></figcaption></figure>
8. In the next screen, for the "conversion tracking method", select "Manual conversions setup"
9. In the "Define your conversion tracking method" section, choose "Event-specific" (see image below).<br>

   <figure><img src="https://2794996218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LeklWo0yn03AhWro2Ux%2Fuploads%2FOlC1PHTiyxA41hJ4MTVy%2Fimage.png?alt=media&#x26;token=6794dfed-a407-499c-b315-9e02d738c7b2" alt=""><figcaption></figcaption></figure>
10. Scroll to the bottom of the page and copy the conversion ID to use for the next step (see image below).

    <figure><img src="https://2794996218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LeklWo0yn03AhWro2Ux%2Fuploads%2Fmy3fNyuedYUxchF51zhw%2Fimage.png?alt=media&#x26;token=bd2343e2-9c45-4b3c-815c-788a2ba938f2" alt=""><figcaption></figcaption></figure>
11. In your GrowSurf campaign editor, enter the conversion ID for the appropriate input field (see image below).

    <figure><img src="https://2794996218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LeklWo0yn03AhWro2Ux%2Fuploads%2F66b5C4D960lFG3VQolwQ%2Fimage.png?alt=media&#x26;token=e992197e-58d9-4458-b797-0a943b6c5e65" alt=""><figcaption></figcaption></figure>
12. Return to LinkedIn Ads manager and Click *Next step*
13. Click *Create*
14. Make sure that you repeat steps 1-12 above for `growsurf_referral_trigger` as well.

</details>

***

## **Troubleshooting Tips** <a href="#troubleshooting-tips" id="troubleshooting-tips"></a>

Here are common scenarios and how to troubleshoot them.

#### If LinkedIn Ads events are NOT occurring, but you were expecting them:

* Make sure you do not have any ad-blockers or browser extensions blocking requests to LinkedIn Ads.
* If you are testing conversions being tracked, make sure that you've allowed up to 24-48 hours for LinkedIn Ads to process the events.
* To troubleshoot if the LinkedIn ads script is loading on your website, you'll want to make sure you that you visit a participant's referral link first.

#### If LinkedIn Ad events are occurring, but you were NOT expecting them:

* If you want to prevent LinkedIn Ads from being loaded completely, you must disconnect the integration completely. Simply toggling off all checkboxes is insufficient.
* If you see LinkedIn Ads network requests being made on your website and you have the integration completely disabled, GrowSurf may not be emitting these events. Check other parts of your code to find where these events might be happening.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.growsurf.com/integrations/linkedin-ads.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.