# 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

{% hint style="info" %}
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.
{% endhint %}

### 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](https://app.freshpaint.io/destinations/overview) 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

{% hint style="info" %}
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.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/meta-insights/meta-insights-quick-start-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.