> ## 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 Ads (Manual Tracking)

> Learn how to manually apply Rockerbox tracking parameters to Google Ads campaigns

## Overview

If your Google Ads campaigns do not meet the requirements for [auto-append](/supported-integrations/marketing/paid-search/google-ads), you can apply Rockerbox tracking parameters manually. To confirm where tracking is missing, visit the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/tracking/adwords) page.

<Warning>Modifying ad URLs can cause ads to enter a re-learning phase. Plan accordingly when applying tracking parameters to active campaigns.</Warning>

## Applying Parameters (Campaign Level)

1. In Google Ads, select a campaign
2. Click **Settings** in the left sidebar
3. Choose the dropdown for **Additional Settings** (for Shopping, this is below the Shopping Campaign Settings section)
4. Expand the section for **Campaign URL Options**
5. Append the correct tracking parameters below to any existing parameters in the **Final URL Suffix**
6. Replace `ACCOUNT_ID` with your account ID and `CAMPAIGN_NAME` with the campaign name (use underscores in place of spaces)

## Search and Display Campaigns

### Example Parameter String

```text wrap theme={null}
g_acctid=ACCOUNT_ID&g_campaign=CAMPAIGN_NAME&g_campaignid={campaignid}&g_adgroupid={adgroupid}&g_adid={creative}&g_keyword={keyword}&g_keywordid={targetid}&g_network={network}&g_device={device}&g_type=search
```

<Accordion title="Parameter Details">
  | Parameter      | Macro           | Description                                           |
  | -------------- | --------------- | ----------------------------------------------------- |
  | `g_acctid`     | `ACCOUNT_ID`    | Your Google Ads account ID (hardcoded)                |
  | `g_campaign`   | `CAMPAIGN_NAME` | Campaign name with underscores for spaces (hardcoded) |
  | `g_campaignid` | `{campaignid}`  | Campaign ID (required)                                |
  | `g_adgroupid`  | `{adgroupid}`   | Ad Group ID (required)                                |
  | `g_adid`       | `{creative}`    | Creative/Ad ID                                        |
  | `g_keyword`    | `{keyword}`     | Search keyword (required)                             |
  | `g_keywordid`  | `{targetid}`    | Target ID (required)                                  |
  | `g_network`    | `{network}`     | Network type (required)                               |
  | `g_device`     | `{device}`      | Device type                                           |
  | `g_type`       | `search`        | Set to `search` for Search, `display` for Display     |
</Accordion>

## Performance Max Campaigns

Performance Max campaigns use asset groups instead of ad groups and do not support keyword or network macros. Only the following ValueTrack parameters are available.

### Example Parameter String

```text wrap theme={null}
g_acctid=ACCOUNT_ID&g_campaign=CAMPAIGN_NAME&g_campaignid={campaignid}&g_assetgroupid={assetgroupid}&g_device={device}&g_locinterest={loc_interest_ms}&g_locphysical={loc_physical_ms}&g_type=pmax
```

<Accordion title="Parameter Details">
  | Parameter        | Macro               | Description                                           |
  | ---------------- | ------------------- | ----------------------------------------------------- |
  | `g_acctid`       | `ACCOUNT_ID`        | Your Google Ads account ID (hardcoded)                |
  | `g_campaign`     | `CAMPAIGN_NAME`     | Campaign name with underscores for spaces (hardcoded) |
  | `g_campaignid`   | `{campaignid}`      | Campaign ID (required)                                |
  | `g_assetgroupid` | `{assetgroupid}`    | Asset Group ID (required)                             |
  | `g_device`       | `{device}`          | Device type                                           |
  | `g_locinterest`  | `{loc_interest_ms}` | Location interest                                     |
  | `g_locphysical`  | `{loc_physical_ms}` | Physical location                                     |
  | `g_type`         | `pmax`              | Fixed value (required)                                |
</Accordion>

**Note:** PMax campaigns with a Shopping feed also support `{merchant_id}`, `{product_channel}`, `{product_id}`, and `{adtype}`.

## Demand Gen Campaigns

Demand Gen (formerly Discovery) campaigns support ad group and creative macros but do not support keyword, network, or placement macros.

### Example Parameter String

```text wrap theme={null}
g_acctid=ACCOUNT_ID&g_campaign=CAMPAIGN_NAME&g_campaignid={campaignid}&g_adgroupid={adgroupid}&g_adid={creative}&g_device={device}&g_locinterest={loc_interest_ms}&g_locphysical={loc_physical_ms}&g_type=demand_gen
```

<Accordion title="Parameter Details">
  | Parameter       | Macro               | Description                                           |
  | --------------- | ------------------- | ----------------------------------------------------- |
  | `g_acctid`      | `ACCOUNT_ID`        | Your Google Ads account ID (hardcoded)                |
  | `g_campaign`    | `CAMPAIGN_NAME`     | Campaign name with underscores for spaces (hardcoded) |
  | `g_campaignid`  | `{campaignid}`      | Campaign ID (required)                                |
  | `g_adgroupid`   | `{adgroupid}`       | Ad Group ID (required)                                |
  | `g_adid`        | `{creative}`        | Creative/Ad ID                                        |
  | `g_device`      | `{device}`          | Device type                                           |
  | `g_locinterest` | `{loc_interest_ms}` | Location interest                                     |
  | `g_locphysical` | `{loc_physical_ms}` | Physical location                                     |
  | `g_type`        | `demand_gen`        | Fixed value (required)                                |
</Accordion>

## Shopping Campaigns

Shopping campaigns include additional product-specific macros.

### Example Parameter String

```text wrap theme={null}
g_acctid=ACCOUNT_ID&g_campaign=CAMPAIGN_NAME&g_campaignid={campaignid}&g_adgroupid={adgroupid}&g_adid={creative}&g_keyword={keyword}&g_keywordid={targetid}&g_adtype={adtype}&g_merchantid={merchant_id}&g_productchannel={product_channel}&g_productid={product_id}&g_partition={product_partition_id}&g_network={network}&g_ifproduct={ifshoppingproduct:product}&g_ifcreative={ifshoppingcreative:creative}&g_type=shopping
```

<Accordion title="Parameter Details">
  | Parameter          | Macro                           | Description                              |
  | ------------------ | ------------------------------- | ---------------------------------------- |
  | `g_adtype`         | `{adtype}`                      | Ad type                                  |
  | `g_merchantid`     | `{merchant_id}`                 | Merchant Center ID (required)            |
  | `g_productchannel` | `{product_channel}`             | Product channel (required)               |
  | `g_productid`      | `{product_id}`                  | Product ID (required)                    |
  | `g_partition`      | `{product_partition_id}`        | Product partition ID (required)          |
  | `g_ifproduct`      | `{ifshoppingproduct:product}`   | Shopping product conditional (required)  |
  | `g_ifcreative`     | `{ifshoppingcreative:creative}` | Shopping creative conditional (required) |
  | `g_type`           | `shopping`                      | Fixed value (required)                   |

  All other parameters from the Search/Display table also apply.
</Accordion>

## Video / YouTube Campaigns

Video parameters are applied at the **Ad Group level**, not campaign level.

1. Select a video campaign and modify columns by selecting **Columns > Modify Columns**
2. Under **Attributes**, check **Final URL Suffix**
3. In the ad set view, scroll right and click the pencil icon to modify the Final URL Suffix for each ad set

### Example Parameter String

```text wrap theme={null}
g_acctid=ACCOUNT_ID&g_campaign=CAMPAIGN_NAME&g_campaignid={campaignid}&g_adgroupid={adgroupid}&g_adid={creative}&g_keyword={keyword}&g_keywordid={targetid}&g_locinterest={loc_interest_ms}&g_locphysical={loc_physical_ms}&g_placement={placement}&g_source={sourceid}&g_network={network}
```

<Accordion title="Parameter Details">
  | Parameter       | Macro               | Description                  |
  | --------------- | ------------------- | ---------------------------- |
  | `g_locinterest` | `{loc_interest_ms}` | Location interest (required) |
  | `g_locphysical` | `{loc_physical_ms}` | Physical location (required) |
  | `g_placement`   | `{placement}`       | Placement (required)         |
  | `g_source`      | `{sourceid}`        | Source ID                    |

  All other parameters from the Search/Display table also apply.
</Accordion>

**Important:** For video campaigns, replace spaces in `CAMPAIGN_NAME` with `%20` (not underscores) and include hyphens in `ACCOUNT_ID`.

## Verification

After setup:

1. Confirm tracking is applied on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page
2. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance