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

# tvScientific

> Learn how to set up tvScientific integration with Rockerbox for display, OTT and linear TV tracking

## Setup Process

1. Contact [support@rockerbox.com](mailto:support@rockerbox.com) to enable the integration. Let the team know the launch date, the [tier structure](https://help.rockerbox.com/article/obce43haen-1-hierarchy-mappings) you'd like applied, and which type of inventory you will be running (Display, CPM-Based OTT, CPA-Based OTT, or Linear TV)
2. Follow the instructions below to set up tracking and spend reporting for your inventory type. This must be completed before launch
3. Allow at least one full day of data collection after launch, then let Rockerbox know you have launched so they can QA your tracking

## Display

### Impression Pixel

Apply the pixel below to all active display placements.

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=tvscientific-display&tier_two={{ADVERTISER_ID}}&tier_three={{CAMPAIGN_ID}}&tier_four={{CREATIVE_ID}}&tier_five={{APP_ID}}&auction_id={{CACHEBUSTER}}
```

**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`   | `tvscientific-display` | Platform identifier (hardcoded)           |
  | `tier_two`   | `{{ADVERTISER_ID}}`    | Advertiser ID (required)                  |
  | `tier_three` | `{{CAMPAIGN_ID}}`      | Campaign ID (required)                    |
  | `tier_four`  | `{{CREATIVE_ID}}`      | Creative ID (required)                    |
  | `tier_five`  | `{{APP_ID}}`           | App ID (required)                         |
  | `auction_id` | `{{CACHEBUSTER}}`      | Cache buster for deduplication (required) |
</Accordion>

### Batch Spend

tvScientific sends spend files to a Rockerbox S3 endpoint.

1. Contact [support@rockerbox.com](mailto:support@rockerbox.com) to obtain the S3 endpoint details
2. Provide the endpoint to tvScientific so they can set up automated daily reporting
   * Files should be sent on a **daily** cadence
   * Each file should contain the previous day of spend data

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

```
campaign_id
campaign_name
advertiser_id
advertiser_name
creative_id
creative_name
app_id
app_name
date
cost
```

## OTT/CTV (CPM)

The instructions below are for **CPM clients**. If you are running CPA campaigns with tvScientific, contact your Rockerbox representative for next steps.

tvScientific delivers daily log-level files to Rockerbox containing impression data and spend. Contact [support@rockerbox.com](mailto:support@rockerbox.com) to obtain the S3 endpoint details and provide them to tvScientific.

* Files should be sent on a **daily** cadence
* Each file should contain the previous day of data

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

```
ip_address
impression_datetime
user_agent
cost
campaign_id
ad_group_id
creative_id
campaign_name
creative_name
```

## Linear TV

tvScientific can also run Linear TV campaigns. Confirm with tvScientific whether Linear TV inventory will run through Comcast, as this affects the setup process.

Contact [support@rockerbox.com](mailto:support@rockerbox.com) to coordinate the Linear TV integration setup with tvScientific.

## Verification

After setup:

1. Verify impression pixels are firing correctly (display)
2. Confirm log files are being delivered daily (OTT)
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