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

# iHeartRadio

> Learn how to set up iHeartRadio streaming audio integration with Rockerbox

## Overview

Rockerbox has an existing integration with iHeart where we receive user-level log files for streaming audio. This allows Rockerbox to attribute these touchpoints to conversions.

<Warning>This integration only supports standard streaming audio. Rockerbox does not support iHeart podcast attribution.</Warning>

## Setup Process

1. Enable the iHeartRadio integration on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page. This will create an SFTP endpoint for log file delivery
2. Contact your Rockerbox representative about your upcoming launch. Rockerbox will coordinate with iHeart to set up log file deliveries
3. If running display or video ads through iHeart, apply click tracking parameters and impression pixels (see below)
4. Contact [support@rockerbox.com](mailto:support@rockerbox.com) with the launch date and the [tier structure](https://help.rockerbox.com/article/obce43haen-1-hierarchy-mappings) you'd like applied

## Log File Delivery

Rockerbox coordinates directly with iHeart to set up log file delivery.

* Files are sent on a **daily** cadence. iHeart sends files on a 1-day delay (Monday's impressions arrive on Wednesday)
* Each file should contain only 1 day of data

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

```
ip_address
cost
device_type
timestamp
user_agent
campaign_id
campaign_name
creative_id
creative_name
publisher_id
publisher_name
```

## Display and Video Tracking

### Example Parameter String

```text wrap theme={null}
ih_adgroupid=%eaid!&ih_campaignid=%ebuy!&ih_creativeid=%ecid!&ih_placementid=%epid!&ih_type=dv
```

<Accordion title="Parameter Details">
  | Parameter        | Macro    | Description              |
  | ---------------- | -------- | ------------------------ |
  | `ih_adgroupid`   | `%eaid!` | Ad group ID (required)   |
  | `ih_campaignid`  | `%ebuy!` | Campaign ID (required)   |
  | `ih_creativeid`  | `%ecid!` | Creative ID (required)   |
  | `ih_placementid` | `%epid!` | Placement ID (required)  |
  | `ih_type`        | `dv`     | Campaign type (required) |
</Accordion>

### Impression Pixel

Contact [support@rockerbox.com](mailto:support@rockerbox.com) for your account-specific `[SOURCE]` value (your company's pixel\_source\_name).

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=iheartradio-dv&tier_two=%ebuy!&tier_three=%eaid!&tier_four=%ecid!&tier_five=%epid!&auction_id=%%CACHEBUSTER%%&mobile_device_id=%%ADVERTISING_IDENTIFIER_PLAIN%%
```

<Accordion title="Impression Pixel Details">
  | Parameter          | Value                              | Description                                                |
  | ------------------ | ---------------------------------- | ---------------------------------------------------------- |
  | `source`           | `[SOURCE]`                         | Your company's pixel\_source\_name (provided by Rockerbox) |
  | `tier_one`         | `iheartradio-dv`                   | Vendor and campaign type identifier (hardcoded)            |
  | `tier_two`         | `%ebuy!`                           | Campaign ID                                                |
  | `tier_three`       | `%eaid!`                           | Ad group ID                                                |
  | `tier_four`        | `%ecid!`                           | Creative ID                                                |
  | `tier_five`        | `%epid!`                           | Placement ID                                               |
  | `auction_id`       | `%%CACHEBUSTER%%`                  | Cache buster                                               |
  | `mobile_device_id` | `%%ADVERTISING_IDENTIFIER_PLAIN%%` | Mobile advertising identifier                              |
</Accordion>

## Verification

After setup:

1. Confirm log files are being delivered to the SFTP endpoint
2. Confirm tracking is applied on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page
3. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance