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

# Display & Video 360 (DV360)

> Learn how to set up DV360 integration with Rockerbox for display and video tracking

## Prerequisites

Before setting up the integration, you'll need:

* An active DV360 advertiser account
* Google account credentials with access to your DV360 account(s)

## Setup Process

1. Navigate to the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page
2. Find and select DV360 from the list of platforms
3. Click "Connect" and authenticate your Google account

<Note>If you receive a "this app is blocked" error, follow [these troubleshooting steps](https://rockerbox.helpdocs.io/article/pbie8dbaj6-google-error-this-app-is-blocked) to resolve it.</Note>

4. Implement tracking (URL parameters and/or impression pixels) under **Creative Details > Additional Details** for all ads
5. Contact [support@rockerbox.com](mailto:support@rockerbox.com) with the channel name, launch date and your desired [tier structure](https://help.rockerbox.com/article/obce43haen-1-hierarchy-mappings)
6. Allow at least one full day of data collection after launch, then verify deployment via the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page

**Match pixel to inventory type.** Using the wrong pixel type (e.g., Display pixel on Video inventory) will cause tracking failures.

## Display Campaigns

### URL Tracking Parameters

Parameter values use macros that are dynamically filled by the platform when the ad is served. No manual replacement is needed.

**Example Parameter String:**

```text wrap theme={null}
dv_campaignid=${CAMPAIGN_ID}&dv_insertionorderid=${INSERTION_ORDER_ID}&dv_creativeid=${CREATIVE_ID}&dv_advertiserid=${ADVERTISER_ID}&dv_inventorysource=${INVENTORY_SOURCE_ID}&dv_type=display
```

<Accordion title="Parameter Details">
  | Parameter             | Macro                    | Description                   |
  | --------------------- | ------------------------ | ----------------------------- |
  | `dv_campaignid`       | `${CAMPAIGN_ID}`         | Campaign ID (required)        |
  | `dv_insertionorderid` | `${INSERTION_ORDER_ID}`  | Insertion Order ID (required) |
  | `dv_creativeid`       | `${CREATIVE_ID}`         | Creative ID (required)        |
  | `dv_advertiserid`     | `${ADVERTISER_ID}`       | Advertiser ID                 |
  | `dv_inventorysource`  | `${INVENTORY_SOURCE_ID}` | Inventory Source ID           |
  | `dv_type`             | `display`                | Inventory Type (hardcoded)    |
</Accordion>

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=dv360-display&tier_two=${CAMPAIGN_ID}&tier_three=${INSERTION_ORDER_ID}&tier_four=${CREATIVE_ID}&cachebuster=${CACHEBUSTER}&referrer=${INVENTORY_SOURCE_ID}
```

**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`    | `dv360-display`          | Platform identifier (hardcoded) |
  | `tier_two`    | `${CAMPAIGN_ID}`         | Campaign ID (required)          |
  | `tier_three`  | `${INSERTION_ORDER_ID}`  | Insertion Order ID (required)   |
  | `tier_four`   | `${CREATIVE_ID}`         | Creative ID (required)          |
  | `cachebuster` | `${CACHEBUSTER}`         | Cache Buster (required)         |
  | `referrer`    | `${INVENTORY_SOURCE_ID}` | Inventory Source ID             |
</Accordion>

## Video Campaigns

Due to a [Google limitation](https://support.google.com/displayvideo/answer/2789508?hl=en), DV360 macros are not supported in YouTube ads. You must manually replace the placeholders below with the actual IDs.

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
dv_insertionorderid=[INSERTION ORDER ID]&dv_campaignid=[CAMPAIGN ID]&dv_creativeid=[CREATIVE ID]&dv_type=video
```

<Accordion title="Parameter Details">
  | Parameter             | Value                               | Description                   |
  | --------------------- | ----------------------------------- | ----------------------------- |
  | `dv_insertionorderid` | `[REPLACE WITH INSERTION ORDER ID]` | Insertion Order ID (required) |
  | `dv_campaignid`       | `[REPLACE WITH CAMPAIGN ID]`        | Campaign ID (required)        |
  | `dv_creativeid`       | `[REPLACE WITH CREATIVE ID]`        | Creative ID (required)        |
  | `dv_type`             | `video`                             | Inventory Type (hardcoded)    |
</Accordion>

### Impression Pixel

DV360 does not support impression tracking pixels on Video inventory.

## Implementation Notes

* **Video requires manual IDs**: Due to Google platform limitations, YouTube/Video ads require manual ID replacement
* **Inventory type matching is critical**: Ensure Display pixels are used on Display inventory only
* **Apply tracking in Creative Details**: URL parameters and impression pixels should be added under Creative Details > Additional Details

## Verification

After setup:

1. Confirm API credentials are properly configured
2. Verify impression pixels are firing correctly
3. Validate click tracking parameters are populating
4. Check spend data appears in Rockerbox dashboard after at least one full day
5. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance