> ## 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.

# AcuityAds (Illumin)

> Learn how to set up AcuityAds (Illumin) integration with Rockerbox for display and OTT tracking

## 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. Apply URL parameters and impression pixels to all placements within the Acuity platform using the instructions below. Parameters use macros and do not need to be manually replaced
3. Set up automated spend reporting from Acuity to Rockerbox (see Batch Spend section below). This should be completed before launch
4. Allow at least one full day of data collection after launch, then confirm that tracking is applied to all your ads using the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page

**Match pixel to inventory type.** Using the wrong pixel type (e.g., Display pixel on OTT inventory) will cause tracking failures.

## Display and Programmatic Video

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
ac_type=display&ac_campaignid=[CAMPAIGN_ID]&ac_campaignname=[CAMPAIGN_NAME_ENCODED]&ac_adgroupid=[AD_GROUP_ID]&ac_adgroupname=[AD_GROUP_NAME_ENCODED]&ac_creativeid=[CREATIVE_ID]&ac_domain=[EXCHANGE_SITE_ID_OR_DOMAIN]
```

<Accordion title="Parameter Details">
  | Parameter         | Macro                          | Description                 |
  | ----------------- | ------------------------------ | --------------------------- |
  | `ac_type`         | `display`                      | Campaign Type (hardcoded)   |
  | `ac_campaignid`   | `[CAMPAIGN_ID]`                | Campaign ID (required)      |
  | `ac_campaignname` | `[CAMPAIGN_NAME_ENCODED]`      | Campaign Name (URL encoded) |
  | `ac_adgroupid`    | `[AD_GROUP_ID]`                | Ad Group ID                 |
  | `ac_adgroupname`  | `[AD_GROUP_NAME_ENCODED]`      | Ad Group Name (URL encoded) |
  | `ac_creativeid`   | `[CREATIVE_ID]`                | Creative ID                 |
  | `ac_domain`       | `[EXCHANGE_SITE_ID_OR_DOMAIN]` | Exchange Site ID or Domain  |
</Accordion>

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=acuity-display&tier_two=[CAMPAIGN_ID]&tier_three=[CAMPAIGN_NAME_ENCODED]&tier_four=[AD_GROUP_ID]&tier_five=[AD_GROUP_NAME_ENCODED]&cachebuster=[CACHEBUSTER]&referrer=[EXCHANGE_SITE_ID_OR_DOMAIN]
```

**Note:** `[SOURCE]` is a hardcoded value that must be obtained from Rockerbox. It's your company's [Account ID](https://app.rockerbox.com/v3/settings/account).

<Accordion title="Parameter Details">
  | Parameter     | Macro                          | Description                     |
  | ------------- | ------------------------------ | ------------------------------- |
  | `tier_one`    | `acuity-display`               | Platform identifier (hardcoded) |
  | `tier_two`    | `[CAMPAIGN_ID]`                | Campaign ID (required)          |
  | `tier_three`  | `[CAMPAIGN_NAME_ENCODED]`      | Campaign Name (required)        |
  | `tier_four`   | `[AD_GROUP_ID]`                | Ad Group ID (required)          |
  | `tier_five`   | `[AD_GROUP_NAME_ENCODED]`      | Ad Group Name (required)        |
  | `cachebuster` | `[CACHEBUSTER]`                | Cache Buster (required)         |
  | `referrer`    | `[EXCHANGE_SITE_ID_OR_DOMAIN]` | Exchange Site/Domain            |
</Accordion>

## OTT/CTV

Uses the same URL parameters as Display, with `ac_type=ott` and `tier_one=acuity-ott`.

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
ac_type=ott&ac_campaignid=[CAMPAIGN_ID]&ac_campaignname=[CAMPAIGN_NAME_ENCODED]&ac_adgroupid=[AD_GROUP_ID]&ac_adgroupname=[AD_GROUP_NAME_ENCODED]&ac_creativeid=[CREATIVE_ID]&ac_domain=[EXCHANGE_SITE_ID_OR_DOMAIN]
```

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=acuity-ott&tier_two=[CAMPAIGN_ID]&tier_three=[CAMPAIGN_NAME_ENCODED]&tier_four=[AD_GROUP_ID]&tier_five=[AD_GROUP_NAME_ENCODED]&cachebuster=[CACHEBUSTER]&referrer=[EXCHANGE_SITE_ID_OR_DOMAIN]
```

**Note:** `[SOURCE]` is a hardcoded value that must be obtained from Rockerbox. It's your company's [Account ID](https://app.rockerbox.com/v3/settings/account).

## Batch Spend

Acuity will need to set up automated reporting within their platform to be sent to Rockerbox daily.

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

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

```
Time Interval
Campaign ID
Campaign Name
Tactic ID
Tactic Name
Creative ID
Creative Name
Cost
```

## Verification

After setup:

1. Verify impression pixels are firing correctly (check by inventory type)
2. Validate click tracking parameters are populating
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