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

# Google Display Network (GDN)

> Learn how to set up GDN integration with Rockerbox for 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. Click tracking is applied automatically by Rockerbox. No manual URL parameter setup is required
3. To enable impression tracking, submit a pixel implementation request to Google using the instructions below
4. Connect your Google Ads account in Rockerbox to enable API spend ingestion (see API Spend section below)
5. Allow at least one full day of data collection after launch, then let Rockerbox know you have launched so they can QA your tracking

### Impression Tracking

Impression tracking for GDN cannot be applied manually. You must submit a request to Google to have impression pixels implemented on your behalf. Contact your Google representative and reference [Google's documentation](https://support.google.com/google-ads/answer/6161966?hl=en) for the submission process.

**This process must be repeated each time you launch new GDN campaigns or ad groups.** Impression tracking is not permitted by Google for Discovery campaigns.

**Base Pixel:**

```text wrap theme={null}
https://metrics.getrockerbox.com/track/gdn?source=[SOURCE]&tier_one=gdn
```

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

**Required Additional Pixel Parameters:**

```text wrap theme={null}
&tier_two=[Campaign_ID]&tier_three=[Ad_Group_ID]&auction_id=%%CACHEBUSTER%%
```

The complete pixel for each campaign and ad group combination should look like:

```text wrap theme={null}
https://metrics.getrockerbox.com/track/gdn?source=[SOURCE]&tier_one=gdn&tier_two=123456789&tier_three=987654321&auction_id=%%CACHEBUSTER%%
```

Replace `[Campaign_ID]` and `[Ad_Group_ID]` with actual values, including removing the brackets.

<Accordion title="Parameter Details">
  | Parameter    | Macro             | Description                                       |
  | ------------ | ----------------- | ------------------------------------------------- |
  | `tier_one`   | `gdn`             | Platform identifier (hardcoded)                   |
  | `tier_two`   | `[Campaign_ID]`   | Campaign ID (required, replace with actual value) |
  | `tier_three` | `[Ad_Group_ID]`   | Ad Group ID (required, replace with actual value) |
  | `auction_id` | `%%CACHEBUSTER%%` | Cache buster for deduplication                    |
</Accordion>

#### Option 1: Using Google's Template

1. Download Google's Excel template for a 1x1 pixel from [Google's documentation](https://support.google.com/google-ads/answer/6161966?hl=en) and go to the second tab
2. In cell A3, select **Ad Group ID**
3. In cell B3, select **equals**
4. In cell C3, input your Ad Group ID. Keep these values unique — Google will reject requests with duplicate values
5. In cell D3, select **Campaign ID**
6. In cell E3, select **equals**
7. In cell F3, input your Campaign ID
8. In column J, paste the complete pixel URL with the Campaign ID and Ad Group ID values filled in (replace `[Campaign_ID]` and `[Ad_Group_ID]` including the brackets)
9. Repeat for all Campaign and Ad Group combinations
10. Submit the completed file to Google

#### Option 2: Creating Your Own Template

1. Create an Excel or Google Sheets file with these headers in Row 1:

| Campaign ID | Ad Group ID | Base Pixel | Impression Tracking Pixel |
| ----------- | ----------- | ---------- | ------------------------- |

2. Paste your base pixel (everything before `&tier_two=`) into the **Base Pixel** column in Row 2
3. Paste the formula below into the **Impression Tracking Pixel** column in Row 2:

```
=if(A2<>"",CONCATENATE(C2,"&tier_two=",A2,"&tier_three=",B2,"&auction_id=%%CACHEBUSTER%%"),"")
```

4. Paste all of your Ad Group IDs and their parent Campaign IDs in the first two columns. Keep these values unique — Google will reject requests with duplicates
5. Drag down the **Base Pixel** and **Impression Tracking Pixel** columns to generate pixels for each row
6. Submit the completed file to Google

## API Spend

Rockerbox pulls spend data directly from Google Ads via API.

1. In Rockerbox, navigate to the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page
2. Select Google from the list and click "Connect"
3. Complete the Google Ads authentication process to enable daily spend ingestion

## Verification

After setup:

1. Verify impression pixels have been implemented by Google
2. Validate click tracking is populating automatically
3. Confirm spend data appears in Rockerbox within 24-48 hours
4. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance