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

# PowerInbox

> Learn how to set up PowerInbox integration with Rockerbox for email 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 batch spend reporting from PowerInbox 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 URL parameters

### URL Tracking Parameters

Append the parameters below to your destination URLs in PowerInbox campaign settings. Macros use square bracket format and are automatically populated when the ad is served.

**Example Parameter String:**

```text wrap theme={null}
pi_adid=[AdID]&pi_clickid=[ClickID]&pi_publisherid=[PublisherID]
```

<Accordion title="Parameter Details">
  | Parameter        | Macro           | Description      |
  | ---------------- | --------------- | ---------------- |
  | `pi_adid`        | `[AdID]`        | Ad ID (required) |
  | `pi_clickid`     | `[ClickID]`     | Click ID         |
  | `pi_publisherid` | `[PublisherID]` | Publisher ID     |
</Accordion>

## Batch Spend

PowerInbox sends spend reports to a Rockerbox email endpoint.

1. In Rockerbox, navigate to the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page and enable the PowerInbox integration. This creates an email endpoint for receiving spend files
2. Contact your Rockerbox representative for the endpoint details
3. PowerInbox will send manual reports from their platform to the Rockerbox endpoint
   * Files should be sent on a **weekly** cadence
   * Each file should contain the previous 7 days of spend data

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

```
Date
Cost
Campaign
Name
Creative ID
```

## Verification

After setup:

1. Validate click tracking parameters are populating
2. Confirm spend files are being delivered weekly
3. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance