Skip to content
ads

Track and report on your Facebook and Instagram ads in HubSpot

Last updated: January 20, 2022

Ad blockers may block some of the content on this page. To prevent this, pause your ad blocker while browsing the Knowledge Base.

Applies to:

All products and plans

You can track and report on your Facebook ad campaigns, ad sets, and ads in your HubSpot account.

When you connect your Facebook ad account to HubSpot, you can enable auto-tracking, which will automatically apply a set of UTM parameters to all supported ad types in your account.

Supported ad types

HubSpot can track most Facebook and Instagram ads, but some ad types are not supported due to API limitations.

Facebook ads

Ad type Tracking Reporting
Lead Ad
Newsfeed Ad
Promoted FB Instant Articles  
Ads using Instant Article placement
Messenger Ads  

Instagram ads

Ad type Tracking Reporting
Lead Ad  
Feed Ad  
Story Ad  

UTM parameters

HubSpot tracks Facebook ads by adding the following URL parameters to each ad:

utm_source=facebook
utm_medium=paid
utm_campaign={Name of Ad campaign}
hsa_acc={accountid}

hsa_cam={adcampaignid}
hsa_grp={adsetid}
hsa_ad={ad_id}
hsa_net=facebook

hsa_src=[SOURCE_SITE_NAME] - set to Facebook or Instagram automatically
hsa_ver=3
hsa_la={true} - for lead ads, {false} or absent otherwise
hsa_ol={true} - for organic leads from lead ads, {false} or absent otherwise

These parameters are automatically added when your Facebook Ads account is connected to HubSpot. Any changes made to the UTM parameters in Facebook Ads will not be overwritten by HubSpot. HubSpot's ads tool updates multiple times a day to ensure new ads are being tracked.

URL and engagement requirements

  • The final URL in the Facebook ad must be a full URL and not shortened by a link shortener (e.g., bit.ly, with the exception of hubs.ly). Link shorteners strip parameters from the end of the URL and prevents tracking.
  • The URL in the Facebook ad cannot redirect because HubSpot's tracking parameters are stripped during redirects. Only use the final, non-redirecting version of a URL. This includes http to https redirects.
  • Existing ads must have fewer than 20 engagements when you first connect your Facebook Ads account to HubSpot to be tracked. This prevents Facebook's ad optimization algorithm from being reset. If an ad has 20 or more engagements, you can override the limit to apply HubSpot tracking.

Please note: if you share data from your HubSpot account with Facebook as part of the HubSpot Ads integration, Facebook's ad terms will apply. When you authorize the integration, HubSpot receives a user token with permissions on the connected ad accounts and pages. HubSpot can view but does not store all the ad accounts and pages you have permission for. Facebook will share settings details (e.g., name, budget, bid strategy, creative) and performance metrics (impressions, clicks, etc.) for all campaigns, ad sets, and ads in the ad accounts you connected.

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.