Skip to main content

Source Info

  • The Meta Ads Source is an Audience Signal, Conversion Signal and Cloud Object source. 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 source can only be exported directly to a warehouse, but it can then be used for further analysis.
Meta is one of the most efficient ways to advertise online. Take your company’s analysis to the next level by adding Meta Ads as a Source to Innkeepr.

​
Getting Started

  1. From your workspace’s page, click Sources 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 source setup.
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.
Do not use # in your naming convention — it causes a cutoff of all following URL parameters.
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.
Advantage+ Shopping Campaigns cannot be edited together with regular campaigns. Make sure to edit them separately.
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 source, 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
  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)
Analyst level access is not sufficient — Innkeepr needs write access to upload audiences and send Pixel events.