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

# Amobee

> Learn how to set up Amobee integration with Rockerbox for display and OTT tracking

Tracking and required reporting will differ depending on the ad server Amobee is using (Turn or Videology).

## 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. Apply URL parameters and impression pixels to all placements within the Amobee platform using the instructions below. Parameters use macros and do not need to be manually replaced
3. Set up automated spend reporting from Amobee 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 and impression pixels

**Use the correct pixel for your inventory type.** Using the wrong pixel type (e.g., Display pixel on OTT inventory) will cause tracking failures.

## Turn: Display

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
ab_insertionorderid=$!{INSERTION_ORDER_ID}&ab_lineitemid=$!{LINE_ITEM_ID}&ab_creativeid=$!{CREATIVE_ID}&ab_adid=$!{AD_ID}&ab_domain=$!{SITE_URL_ENC}
```

<Accordion title="Parameter Details">
  | Parameter             | Macro                    | Description                   |
  | --------------------- | ------------------------ | ----------------------------- |
  | `ab_insertionorderid` | `$!{INSERTION_ORDER_ID}` | Insertion Order ID (required) |
  | `ab_lineitemid`       | `$!{LINE_ITEM_ID}`       | Line Item ID                  |
  | `ab_creativeid`       | `$!{CREATIVE_ID}`        | Creative ID                   |
  | `ab_adid`             | `$!{AD_ID}`              | Ad ID                         |
  | `ab_domain`           | `$!{SITE_URL_ENC}`       | Site URL (encoded)            |
</Accordion>

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=amobee-display&tier_two=$!{INSERTION_ORDER_ID}&tier_three=$!{LINE_ITEM_ID}&tier_four=$!{CREATIVE_ID}&tier_five=$!{AD_ID}&auction_id=$!{AD_CALL_ID}&referrer=$!{SITE_URL_ENC}
```

**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).

## Turn: OTT/CTV

Uses the same URL parameters as Turn Display. The only difference is `tier_one=amobee-ott` on the impression pixel.

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
ab_insertionorderid=$!{INSERTION_ORDER_ID}&ab_lineitemid=$!{LINE_ITEM_ID}&ab_creativeid=$!{CREATIVE_ID}&ab_adid=$!{AD_ID}&ab_domain=$!{SITE_URL_ENC}
```

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=amobee-ott&tier_two=$!{INSERTION_ORDER_ID}&tier_three=$!{LINE_ITEM_ID}&tier_four=$!{CREATIVE_ID}&tier_five=$!{AD_ID}&auction_id=$!{AD_CALL_ID}&referrer=$!{SITE_URL_ENC}
```

**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).

## Videology

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
ab_planid={PLANID}&ab_campaignid=$!{CAMPID}&ab_flightid=$!{MID}
```

<Accordion title="Parameter Details">
  | Parameter       | Macro        | Description        |
  | --------------- | ------------ | ------------------ |
  | `ab_planid`     | `{PLANID}`   | Plan ID (required) |
  | `ab_campaignid` | `$!{CAMPID}` | Campaign ID        |
  | `ab_flightid`   | `$!{MID}`    | Media/Flight ID    |
</Accordion>

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=amobee-ott&tier_two={PLANID}&tier_three={CAMPID}&tier_four={FMID}&tier_five={MID}&auction_id={RANDOMNUM}&referrer={REFURL}
```

**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).

## Batch Spend

Amobee 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 Amobee batch file delivery
2. Share the endpoint details with Amobee 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
   * Reports must be scheduled without a "totals" row and without any extra rows at the top (row 1 must be column headers)

### Turn: Required Columns

Must match exactly, including capitalization and spacing:

```
data_date
advertiser_id
line_item_name
creative_id
ad_id
ad_name
creative_name
line_item_id
insertion_order_name
insertion_order_id
advertiser_name
advertiser_invoice
```

### Videology: Required Columns

Must match exactly, including capitalization and spacing:

```
GMT Date
Campaign Name
FMID
Media ID
Media
Flight Name
Campaign ID
Plan
Plan ID
Net Spend - USD
```

## Verification

After setup:

1. Verify impression pixels are firing correctly (check by inventory type)
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