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

# Facebook / Meta (Manual Append)

> Learn how to manually apply Rockerbox tracking parameters to Facebook and Instagram ads

## Overview

If your Facebook / Meta ads do not meet the requirements for [auto-append](/supported-integrations/marketing/paid-social/facebook), you can apply Rockerbox tracking parameters manually.

**Note:** Instagram Collection (Instant Experience) ads do not support dynamic URL parameters. Contact your Rockerbox representative if you are running this format.

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

## URL Parameters

Append the following parameters to the **URL Tags** field in Facebook Ads Manager. Do not add a `?` — Facebook adds this automatically. If you have existing parameters, separate them with `&`.

### Example Parameter String

```text wrap theme={null}
fb_campaignname={{campaign.name}}&fb_campaignid={{campaign.id}}&fb_adsetname={{adset.name}}&fb_adsetid={{adset.id}}&fb_adid={{ad.id}}&fb_adname={{ad.name}}
```

<Accordion title="Parameter Details">
  | Parameter         | Macro               | Description              |
  | ----------------- | ------------------- | ------------------------ |
  | `fb_campaignname` | `{{campaign.name}}` | Campaign Name (required) |
  | `fb_campaignid`   | `{{campaign.id}}`   | Campaign ID (required)   |
  | `fb_adsetname`    | `{{adset.name}}`    | Ad Set Name (required)   |
  | `fb_adsetid`      | `{{adset.id}}`      | Ad Set ID (required)     |
  | `fb_adid`         | `{{ad.id}}`         | Ad ID (required)         |
  | `fb_adname`       | `{{ad.name}}`       | Ad Name (required)       |
</Accordion>

These parameter values use macros and do not need to be manually replaced. Their values will be dynamically filled by Facebook when the ad is served.

## Bulk Upload Method

1. Go to the Ads tab in Facebook Ads Manager
2. Select all active ads (exclude historical campaigns you do not plan to reactivate)
3. Click the Export icon and choose **Selected**
4. Append the Rockerbox parameters to the **URL Tags** column. If existing parameters are present, separate them with `&`
5. Choose **Import**, then **Ads**, and upload the file

Removing historical campaigns from your export is optional but strongly recommended. Some older campaigns include deprecated fields that can cause errors when uploading updates to the URL tags.

## Individual Ad Method

1. Go to the Ads tab in Facebook Ads Manager
2. Select the ad to apply tracking to
3. In the **URL Tags** field, append the Rockerbox URL parameters

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