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

# MediaAlpha

> Learn how to set up MediaAlpha integration with Rockerbox for display 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. 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. Set up automated spend reporting from MediaAlpha 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 let Rockerbox know you have launched so they can QA your tracking

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
ma_campaignid={campaign_id}&ma_campaignname={campaign}&ma_adgroupid={ad_group_id}&ma_adgroupname={ad_group}&ma_creativeid={ad_id}&ma_creativename={ad}&ma_publisherid={publisher_id}&ma_publishername={publisher}&ma_clickid={token}
```

<Accordion title="Parameter Details">
  | Parameter          | Macro            | Description            |
  | ------------------ | ---------------- | ---------------------- |
  | `ma_campaignid`    | `{campaign_id}`  | Campaign ID (required) |
  | `ma_campaignname`  | `{campaign}`     | Campaign Name          |
  | `ma_adgroupid`     | `{ad_group_id}`  | Ad Group ID            |
  | `ma_adgroupname`   | `{ad_group}`     | Ad Group Name          |
  | `ma_creativeid`    | `{ad_id}`        | Creative/Ad ID         |
  | `ma_creativename`  | `{ad}`           | Creative/Ad Name       |
  | `ma_publisherid`   | `{publisher_id}` | Publisher ID           |
  | `ma_publishername` | `{publisher}`    | Publisher Name         |
  | `ma_clickid`       | `{token}`        | Click Token            |
</Accordion>

## Batch Spend

MediaAlpha 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 MediaAlpha batch file delivery
2. Share the endpoint details with MediaAlpha 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):

```
Token
Date
Cost
Publisher
Channel
```

## Verification

After setup:

1. Validate click tracking parameters are populating
2. Check spend data appears in Rockerbox dashboard after at least one full day
3. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance