# LinkedIn Ads Cloud Mode Integration


After you have [successfully instrumented]({{< ref "destinations/streaming-destinations/linkedin-ads/setup-guide.md" >}}) LinkedIn Ads as a destination in RudderStack, follow this guide to correctly send your events to LinkedIn Ads in [cloud mode]({{< ref "/destinations/rudderstack-connection-modes.md#cloud-mode" >}}).

{{< info >}}
RudderStack leverages the [LinkedIn Conversions API](https://www.linkedin.com/help/lms/answer/a1680223) (covered under [LinkedIn's Data Processing Agreement](https://www.linkedin.com/legal/l/dpa)) to send the events.

Note that:

- LinkedIn holds the conversion data for a maximum of 180 days before erasing it. It persists only the aggregate conversion reporting data in the Campaign Manager is persisted.
- RudderStack hashes all the email addresses in SHA256 format before sending them to LinkedIn.
- The Conversions API supports a batch size of 5000 records with a rate limit of 300 events per minute.
{{< /info >}}

Find the open source transformer code for this destination in the [GitHub repository](https://github.com/rudderlabs/rudder-transformer/tree/main/src/cdk/v2/destinations/linkedin_ads).

## Track

You can use the [`track`]({{< ref "event-spec/standard-events/track.md" >}}) call to send your conversion data to LinkedIn to measure and optimize the campaigns.

```javascript
rudderanalytics.track(
  "Conversion Event", {
    campaign: "Conversion",
    tax: 2,
    total: 27.5,
    coupon: "coupon55",
    revenue: 48,
    price: 25,
    quantity: 2
  }, {
    traits: {
      firstName: "Alex",
      lastName: "Keener",
      email: "alex@example.com"
    }
  }
);
```

### Supported mappings

RudderStack maps the following `track` fields to the corresponding LinkedIn Ads properties:

| RudderStack property | LinkedIn Ads property | 
| :----| :----| 
| `traits.email` <br /> `context.traits.email` <br /> `properties.email` <br/> <span style="color: #4D4DFF;font-size:12px;">Required, if `context.externalId.id.identifierType` is not present.</span> | `SHA256_EMAIL` |
| If `context.externalId.id.identifierType` is set to `LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID` <br/> <span style="color: #4D4DFF;font-size:12px;">Required, if `email` is not present.</span> | `LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID` | 
| If `context.externalId.id.identifierType` is set to `ACXIOM_ID` <br/> <span style="color: #4D4DFF;font-size:12px;">Required, if `email` is not present.</span> | `ACXIOM_ID` | 
| If `context.externalId.id.identifierType` is set to `ORACLE_MOAT_ID` <br/> <span style="color: #4D4DFF;font-size:12px;">Required, if `email` is not present.</span>  | `ORACLE_MOAT_ID` | 
| `traits.firstName` <br /> `traits.firstname` <br /> `traits.first_name` <br /> `context.traits.firstName` <br /> `context.traits.firstname` <br /> `context.traits.first_name` <br/> <span style="color: #4D4DFF;font-size:12px;">Required, if you are sending user traits.</span>  | `firstName` | 
| `traits.lastName` <br /> `traits.lastname` <br /> `traits.last_name` <br /> `context.traits.lastName` <br /> `context.traits.lastname` <br /> `context.traits.last_name` <br/> <span style="color: #4D4DFF;font-size:12px;">Required, if you are sending user traits.</span> | `lastName` | 
| `traits.title` <br /> `context.traits.title` | `title` | 
| `context.traits.companyName` | `companyName ` | 
| `context.traits.countryCode` | `countryCode` | 
| `properties.eventId` <br /> `properties.messageId` | `eventId` | 
| `timestamp` | `conversionHappenedAt` | 

{{< info >}}
Note the following:

- LinkedIn uses the `eventId` field for deduplicating the data. 
- The event's `timestamp` must be within the last 90 days.
-  If the **Hash and encode data** data is turned on in the dashboard settings, RudderStack automatically hash encodes the user's email associated with the conversion event in the SHA256 format. If the events already contain hashed emails, make sure to turn off this setting.
- Your conversion event must have at least one of the following fields:
  - `email`
  - `context.externalId.id.identifierType` set to either:

    - `LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID`
    - `ACXIOM_ID`
    - `ORACLE_MOAT_ID`
{{< /info >}}

**Calculating conversion value**

- For events not having a `product` array:

| RudderStack property | LinkedIn Ads property | 
| :----| :----| 
| `properties.currency` | `conversionValue.currencyCode` |
| `properties.price` * `properties.quantity` | `conversionValue.amount` |

- For events having a `product` array:

| RudderStack property | LinkedIn Ads property | 
| :----| :----| 
| `properties.currency` | `conversionValue.currencyCode` |
| Σ  (`properties.product[i].price` * `properties.product[i].quantity`) | `conversionValue.amount` |