> ## Documentation Index
> Fetch the complete documentation index at: https://docs.innkeepr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta

<Card title="Connection Info">
  * The Meta Ads Connection is an **Audience Signal, Conversion Signal** and **Cloud Object connection**. This means that it sends information (traits) about a thing that exists and persists over time, such as a campaign or ad set, and which can be updated over time. Data from this connection can only be exported directly to a warehouse, but it can then be used for further analysis.
</Card>

Meta is one of the most efficient ways to advertise online. Take your company’s analysis to the next level by adding [Meta Ads](https://business.facebook.com/latest/ad_center/ads_summary) as a Connection to Innkeepr.

## Getting Started

1. From your workspace’s page, click **Connections** and then **Browse**.
2. Choose **Facebook Ads**.
3. Click **Connect** and then Connect to OAuth into Facebook.
4. Select which accounts you would like to sync.
5. Enter your **Pixel ID**(s). If you have multiple pixels, separate them with a semicolon.
6. Enter your **Ad ID** parameter — this is the URL parameter name you're using to capture `ad.id` in your Meta tracking template.
7. Click **Save**.

## URL Parameter

Innkeepr needs the Meta `ad.id` to be passed as a URL parameter so it can correctly match website visits to individual ads. You choose the parameter name yourself — just make sure it matches what you entered as Ad ID parameter during the connection setup.

<Warning> Editing URL parameters triggers a new ad review and may restart the learning phase. We recommend making these changes at night or during a less busy time. </Warning> <Warning> Do not use `#` in your naming convention — it causes a cutoff of all following URL parameters. </Warning>

**Parameters**

Add the following to the **URL parameters** field on your Meta ads, replacing `your_parameter` with the parameter name you configured in Innkeepr:

`your_parameter={{ad.id}}`

If you already have existing **URL parameters**, append the Innkeepr parameter at the end using `&`:

`&your_parameter={{ad.id}}`

If you are not using any **URL parameters** yet and want a complete setup including UTMs:

`utm_source=meta&utm_medium=paid&utm_campaign={{campaign.name}}&utm_term={{adset.name}}&utm_content={{ad.name}}&your_parameter={{ad.id}}`

**Implementation**

You can bulk edit up to 200 ads at once using Meta's bulk editing feature:

1. Select all of your campaigns.
2. Navigate to the **ad level**.
3. Select all ads.
4. Press the dropdown next to the "**Edit**" button and choose "**URL parameters**".
5. Add the parameter into the "**Edit all selected ads**" row.
6. Click "**Save to draft**".
7. If you have more than 200 ads, go to the next page and repeat the steps above.
8. Once all ads are edited, publish your changes.

<Info> Advantage+ Shopping Campaigns cannot be edited together with regular campaigns. Make sure to edit them separately. </Info>

**Best Practices**

* **Messenger Ads**: The "URL parameters" field does not work for Messenger Ads. Filter them out before starting the bulk editing process.
* **Active & recent ads**: If you have a large number of ads, you can filter for active or recently active ads. But make sure you don't leave out any ads that might be turned on or duplicated in the future.
* **Verification**: Add the "**URL parameters**" column to your column preset to quickly check if the correct parameters are applied. Go to **Columns → Customize Columns...** to add it.
* **Preserve engagement**: If you don't want to lose existing engagement on your best-performing ads, consider duplicating the ad with updated parameters instead of editing the original.

## Permissions

To connect Meta Ads as a connection, the Facebook user authenticating the connection needs the following permissions:

**Ad Account Access**

The user needs **Admin** or **Advertiser** role on the Ad Account in Meta Business Manager. This is required to:

* Read campaign, ad set, and ad configurations (including targeting options)
* Upload and manage Custom Audiences
* Modify audience targeting on ad sets

**Pixel Access**

The user needs **Full Access** to each Pixel you want to connect. This allows Innkeepr to send conversion events to your Pixel via the Conversions API.

**How to verify your permissions**

1. Go to [Meta Business Settings → People](https://business.facebook.com/settings/people)
2. Select your user
3. Under **Ad Accounts**, verify you have **Admin** or **Advertiser** access
4. Under **Data Sources → Pixels**, verify you have full access to the relevant Pixel(s)

<Warning> **Analyst** level access is not sufficient — Innkeepr needs write access to upload audiences and send Pixel events. </Warning>