Overview

Rockerbox’s Facebook Ads integration allows you to automatically import spend data from your Facebook Ads accounts, including Instagram ads.

Setup Process

  1. Visit the Advertising Platforms page in your Rockerbox account
  2. Find Facebook in the list of platforms
  3. Click “Connect” and follow the authentication steps

URL Parameters

Auto-Params Feature

Facebook supports Rockerbox’s auto-params feature, which automatically appends tracking parameters to your ad URLs. This means:
  • No manual parameter configuration required
  • Parameters are automatically added through the Facebook Ads API
  • Existing UTMs and custom parameters are preserved

Available Dynamic Macros

Facebook automatically populates these values:
  • {{campaign.id}} - Campaign ID
  • {{adset.id}} - Ad Set ID
  • {{ad.id}} - Ad ID
  • {{site_source_name}} - Platform (facebook or instagram)

Special Ad Formats

Dynamic Product Ads (DPA)

For DPA campaigns:
  1. Parameters are automatically added to the product feed URL
  2. No additional configuration needed
  3. Works with both single product and carousel formats

Lead Generation Forms

  • Lead gen forms don’t support URL parameters as they keep users within Facebook
  • Track these through the Facebook Lead Gen integration instead

Authentication Notes

  • If prompted to “Continue as [Yourself]” with your personal Facebook account, this is normal and expected
  • Rockerbox only requests permission to access your brand’s Facebook Ads account data
  • Your personal Facebook account must have appropriate access to the Facebook Ads accounts you want to connect

Multiple Accounts

If you manage multiple Facebook Ads accounts:
  • You’ll need to authenticate each account separately
  • Make sure to complete the “Add Authorization” steps for each account
  • Auto-params will be enabled for all connected accounts

Maintaining the Integration

  • Rockerbox automatically pulls spend data daily
  • You may receive alerts (in the UI and via email) if re-authentication is required
  • If authentication lapses, simply reconnect your account through the Advertising Platforms page

Troubleshooting

If you encounter any issues:
  • Check that your Facebook account has the necessary permissions
  • Verify auto-params are being applied by checking ad URLs
  • Ensure your authentication is current
  • Contact support@rockerbox.com if you need additional assistance