> ## Documentation Index
> Fetch the complete documentation index at: https://data-foundation.rockerbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LiveIntent

> Learn how to set up LiveIntent integration with Rockerbox for email display tracking

Rockerbox has standard URL parameters to track clicks, as well as a log file integration that allows tracking of view-based conversions.

## Setup Process

1. Contact [support@rockerbox.com](mailto:support@rockerbox.com) to enable the integration. Let the team know the launch date and the [tier structure](https://help.rockerbox.com/article/obce43haen-1-hierarchy-mappings) you'd like applied
2. Append click-through URL parameters to your landing page URLs using the instructions below. Parameters use macros and do not need to be manually replaced
3. To enable view-through tracking, loop your LiveIntent rep in with your Rockerbox representative. Rockerbox will provide the S3 endpoint details to share with LiveIntent. It will take LiveIntent up to 3 weeks to complete setup on their end
4. Set up automated spend reporting from LiveIntent to Rockerbox (see Batch Spend section below). This should be completed before launch
5. Allow at least one full day of data collection after launch, then let Rockerbox know you have launched so they can QA your tracking

## Click Tracking

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
lv_campaignid=${CAMPAIGN_ID}&lv_lineitemid=${LINE_ITEM_ID}&lv_adslotid=${SECTION_ID}&lv_adid=${CREATIVE_ID}&lv_auctionid=${DECISION_ID}&lv_publisherid=${PUBLISHER_ID}
```

<Accordion title="Parameter Details">
  | Parameter        | Macro             | Description            |
  | ---------------- | ----------------- | ---------------------- |
  | `lv_campaignid`  | `${CAMPAIGN_ID}`  | Campaign ID (required) |
  | `lv_lineitemid`  | `${LINE_ITEM_ID}` | Line Item ID           |
  | `lv_adslotid`    | `${SECTION_ID}`   | Ad Slot/Section ID     |
  | `lv_adid`        | `${CREATIVE_ID}`  | Creative/Ad ID         |
  | `lv_auctionid`   | `${DECISION_ID}`  | Auction/Decision ID    |
  | `lv_publisherid` | `${PUBLISHER_ID}` | Publisher ID           |
</Accordion>

## View-Through Tracking

View-through tracking is handled via server-side log files sent from LiveIntent to Rockerbox. No impression pixel implementation is required.

* Rockerbox attributes credit to LiveIntent views on known opened emails
* iOS Proxy email opens are not included as touchpoints, as there is no deterministic way to tie these to users. More info on iOS proxy emails [here](https://blog.liveintent.com/how-publishers-can-adapt-to-ios-15-with-liveintent)
* Rockerbox automatically applies a 7-day attribution window on LiveIntent data

## Batch Spend

Contact your LiveIntent account manager and ask them to set up the Rockerbox Custom Report.

1. Contact [support@rockerbox.com](mailto:support@rockerbox.com) to obtain the endpoint details for LiveIntent batch file delivery
2. Share the endpoint details with LiveIntent and request daily reporting with the following requirements:
   * Files sent on a daily cadence
   * Each file contains the previous 1 day of data

**Required Columns** (must match exactly, including capitalization and spacing):

```
Event Date
Campaign ID
Campaign Name
Line Item ID
Line Item Name
Creative ID
Creative Name
Gross Revenue
```

## Verification

After setup:

1. Validate click tracking parameters are populating
2. Confirm view-through log files are being delivered (may take up to 3 weeks)
3. Check spend data appears in Rockerbox dashboard after at least one full day
4. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance