Connect Meta to Heatseeker

Heatseeker runs live experiments as real ads on your Facebook and Instagram pages. To do that, it needs access to those pages and to an ad account. On every annual plan (Base, Pro, and Enterprise) you choose how the media runs:

• Managed experiments: Heatseeker's team runs the media. You share your pages and ad accounts with Heatseeker as a partner in Meta Business Suite. Follow Share access with Heatseeker.
• Self-serve media: you run the media through your own Meta ad account. You connect it from inside Heatseeker. Follow Connect your own account.

You can use both, and switch between them later.

If you only want Heatseeker AI to read campaign performance, and not run ads, see Enable Meta ad performance data instead.

Before you start

Pick a Workspace Admin for Heatseeker. This is someone from your company who already has admin access to your Meta Business Suite. They will:

• Set up and manage the Meta integration
• Decide which pages and ad accounts are shared with Heatseeker
• Manage who is invited to your Heatseeker workspace

Everything below happens in Meta Business Suite and needs admin access to your business portfolio. If you do not have it, ask a colleague who does to add you. Meta's guide: Add people to a business portfolio and assign a business asset. If your company has no business portfolio yet, start with Create a business portfolio in Meta Business Suite.

Share access with Heatseeker

For managed experiments, where Heatseeker runs the media.

Step 1: Share your pages

Do this for every brand you want to run experiments under. The Facebook Page, and the Instagram account if you run Instagram ads, must already be in your business portfolio. Meta's guides: Add a Facebook Page to your business portfolio and Connect your Instagram account to a Facebook Page.

1. In Meta Business Suite, go to Settings.
2. Under Users, select Partners.
3. Click Add, then choose Give a partner access to your assets.
4. Enter Heatseeker's Business ID 650946533864658 and click Next.
5. Select the Facebook or Instagram Pages to share.
6. Turn on the Ads, Insights, and Leads permissions.

Make sure your Workspace Admin holds the same permissions on those pages. Meta's walkthrough of this step: Give a partner access to business assets in your business portfolio.

Step 2: Share your ad accounts

Do this if Heatseeker runs your media, or if you want your ad history used to train synthetic audiences. The ad account must already be in your business portfolio. Meta's guide: Add an ad account to your business portfolio.

1. Go to Settings, then Ad Accounts, then Partners.
2. Share the ad accounts you want Heatseeker to use, with Business ID 650946533864658.
3. Turn on these permissions:
   • Manage campaigns. Skip this if you only want synthetic audience training.
   • View performance

Make sure your Workspace Admin holds the same permissions on those ad accounts.

That's it. Tell us when the sharing is done and we will confirm the connection from our side. The same Meta walkthrough covers this step: Give a partner access to business assets in your business portfolio.

Connect your own account

For self-serve media, where you run the media through your own account. No partner setup is needed.

1. Log in to Heatseeker.
2. Go to Settings, then Integrations.
3. Click + Add Meta.
4. Follow the prompts to sign in to Meta and choose your pages and ad account.

Sign in with a Facebook login that has access to those pages and that ad account. When Meta asks which pages and ad accounts to share, include every one you plan to use and leave all permissions on. Anything you leave out will not appear in Heatseeker.

If a page or ad account is missing from the list, your login does not have access to it. Meta's guides: How do I give someone access to my Facebook Page and Ad account permission roles in Meta Ads Manager. To run Instagram placements, connect your Instagram account to the page first: Connect your Instagram account to a Facebook Page. If the ad account itself is disabled or restricted, see Troubleshoot a disabled or restricted account.

You're set. Experiments now run through your own Meta pages and ad account.