Meta Insights Quick Start Guide

Prerequisites

Before you begin, ensure you have the following:

1. Facebook Business Manager account with an active Meta Ads account

2. Ad account permissions - The person authenticating must have ads_management permission to the ad account you want to connect. Without this permission, audience syncing will fail.

3. Active ad campaigns - The integration pulls data from your running or completed campaigns

Note for agency-managed accounts: If your Meta ad account is managed by an agency, you may need to coordinate with them to grant the appropriate permissions before authenticating.

Getting Started

1. Get Your Ad Account ID

   - Navigate to https://business.facebook.com/settings - Click Ad Accounts in the left sidebar - Select the ad account you want to connect - Locate your Ad Account ID from the top of the page (numeric ID like 1429010052379)

2. Create the Meta Insights Destination in Freshpaint

   - In Freshpaint, navigate to your Integrations page and search for Meta Insights - Click "Ad Account ID" to connect your Account ID - Click "Access Permission" to grant permission to link to your Meta account

3. Enable Destination

   - Click on the "Enable" button at the top of the configuration settings

Configuring Attribution Parameters

To accurately attribute conversions to specific Meta ads, you need to add URL parameters to your ads. These parameters allow Freshpaint to track which campaigns, ad sets, and ads are driving results.

Required URL Parameters

Add the following parameters to all Meta ads:

campaign_id={{campaign.id}}&adset_id={{adset.id}}&ad_id={{ad.id}}

Adding Parameters to Existing Ads

1. Open https://adsmanager.facebook.com and select your ad account

2. Navigate to the Campaigns section

3. Click Ads (without selecting any campaigns or ad sets) to view all ads

4. Click the checkbox at the top to select all ads

5. Click Edit to modify all ads at once

6. If prompted about inactive ads, click Deselect all invalid ads

7. Scroll to the URL parameters section at the bottom

8. Paste the parameter string: campaign_id={{campaign.id}}&adset_id={{adset.id}}&ad_id={{ad.id}}

9. Wait for the "All edits saved" confirmation, then click Close

10. If prompted about unpublished ads, click Close to save without publishing

Adding Parameters to New Ads

When creating a new ad, add the URL parameters at the ad level:

1. In Meta Ads Manager, create your ad as usual

2. When setting up the ad creative, scroll to the Tracking section

3. In the URL parameters field, paste: campaign_id={{campaign.id}}&adset_id={{adset.id}}&ad_id={{ad.id}}

4. Complete the rest of your ad setup and publish

You must add these URL parameters to all new ads going forward. To easily identify ads missing parameters, add "URL parameters" as a custom column in your Ads Manager list view.