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

# AdRoll

> Learn how to set up AdRoll integration with Rockerbox for display and native tracking

## Setup Process

1. Authenticate your AdRoll account on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page to enable daily spend ingestion
2. Apply URL parameters and impression pixels to all ads using the instructions below. Parameters use macros and do not need to be manually replaced
3. Contact [support@rockerbox.com](mailto:support@rockerbox.com) with the channel name, launch date and your desired [tier structure](https://help.rockerbox.com/article/obce43haen-1-hierarchy-mappings)
4. Allow at least one full day of data collection after launch, then verify deployment on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page

Impression tracking pixels cannot be added in the AdRoll UI. Send the pixel code below to your AdRoll representative for implementation.

AdRoll's guide to editing campaigns and updating landing page parameters can be found [here](https://help.adroll.com/hc/en-us/articles/212466248-Edit-Your-Campaign).

## HTML5 Creatives

Found by filtering your Ad Library to the "Web" type.

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
ar_type=html5&ar_campaign=[ADROLL:CAMPAIGN_NAME]&ar_campaignid=[ADROLL:CAMPAIGN_EID]&ar_adgroupid=[ADROLL:AD_GROUP_EID]&ar_adid=[ADROLL:AD_EID]
```

<Accordion title="Parameter Details">
  | Parameter       | Macro                    | Description               |
  | --------------- | ------------------------ | ------------------------- |
  | `ar_type`       | `html5`                  | Creative type (hardcoded) |
  | `ar_campaign`   | `[ADROLL:CAMPAIGN_NAME]` | Campaign Name             |
  | `ar_campaignid` | `[ADROLL:CAMPAIGN_EID]`  | Campaign ID (required)    |
  | `ar_adgroupid`  | `[ADROLL:AD_GROUP_EID]`  | Ad Group ID               |
  | `ar_adid`       | `[ADROLL:AD_EID]`        | Ad ID                     |
</Accordion>

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=adroll_html5&tier_two=[CAMPAIGN_EID]&tier_three=[ADGROUP_EID]&tier_four=[AD_EID]&auction_id=[randomNo]
```

**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`   | `adroll_html5`   | Platform identifier (hardcoded) |
  | `tier_two`   | `[CAMPAIGN_EID]` | Campaign ID (required)          |
  | `tier_three` | `[ADGROUP_EID]`  | Ad Group ID                     |
  | `tier_four`  | `[AD_EID]`       | Ad ID                           |
  | `auction_id` | `[randomNo]`     | Random number for deduplication |
</Accordion>

## Native Creatives

Found by filtering your Ad Library to the "Native Inventory" type.

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
ar_type=native&ar_campaign=[ADROLL:CAMPAIGN_NAME]&ar_campaignid=[ADROLL:CAMPAIGN_EID]&ar_adgroupid=[ADROLL:AD_GROUP_EID]&ar_adid=[ADROLL:AD_EID]
```

<Accordion title="Parameter Details">
  | Parameter       | Macro                    | Description               |
  | --------------- | ------------------------ | ------------------------- |
  | `ar_type`       | `native`                 | Creative type (hardcoded) |
  | `ar_campaign`   | `[ADROLL:CAMPAIGN_NAME]` | Campaign Name             |
  | `ar_campaignid` | `[ADROLL:CAMPAIGN_EID]`  | Campaign ID (required)    |
  | `ar_adgroupid`  | `[ADROLL:AD_GROUP_EID]`  | Ad Group ID               |
  | `ar_adid`       | `[ADROLL:AD_EID]`        | Ad ID                     |
</Accordion>

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=adroll_native&tier_two=[ADROLL:CAMPAIGN_EID]&tier_three=[ADROLL:AD_GROUP_EID]&tier_four=[ADROLL:AD_EID]&tier_five=[ADROLL:CAMPAIGN_NAME]&auction_id=[randomNo]&referrer=[ADROLL: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`   | `adroll_native`          | Platform identifier (hardcoded) |
  | `tier_two`   | `[ADROLL:CAMPAIGN_EID]`  | Campaign ID (required)          |
  | `tier_three` | `[ADROLL:AD_GROUP_EID]`  | Ad Group ID                     |
  | `tier_four`  | `[ADROLL:AD_EID]`        | Ad ID                           |
  | `tier_five`  | `[ADROLL:CAMPAIGN_NAME]` | Campaign Name                   |
  | `auction_id` | `[randomNo]`             | Random number for deduplication |
  | `referrer`   | `[ADROLL:DOMAIN]`        | Domain                          |
</Accordion>

## Verification

After setup:

1. Verify impression pixels are firing correctly (confirm with your AdRoll representative)
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