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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.