With the AgencyAnalytics Meta Ads integration, you can track and display Meta Ads metrics on your clients' dashboards and reports. Multiple Meta Ads accounts are supported per integration. See Understanding Accounts Per Integration

Click here to view all available Meta Ads metrics and learn what's possible with the Meta Ads integration.

To avoid a failed connection or error when integrating Meta Ads with a Client, the person connecting must have at least Employee permissions.

Step 1: Open the Client where you'd like to connect Meta Ads, then click the Data Sources tab at the top.

Step 2: Click the blue Connect Data Source button in the upper right corner of the page.

Step 3: Search for Meta Ads in the search bar at the top, then click the Meta Ads card.

Step 4: Click the + Connect New Account at the bottom to open the authorization window, then follow the prompts to verify and finalize the connection.

Step 5: Select the account you want to connect from the connection list, then click Save in the lower left.

The integration is then complete, and your client's Meta Ads metrics are available for inclusion in dashboards and reports.

If your Meta Ads metrics in AgencyAnalytics seem incorrect or are missing, it's usually due to Meta's attribution settings blocking some data, not an issue with the integration itself.

AgencyAnalytics data should match what you see in Meta Business Manager. If it doesn't, the filters below will usually fix it.

As of April 2021, Apple iOS users can block Meta Ads tracking, which causes some Meta Ads data to be incomplete. This data is incomplete in Meta Business Manager and in every other platform that pulls Meta Ads data, including AgencyAnalytics.

If you're not seeing the data you expect in AgencyAnalytics, check Meta Business Manager directly using the exact same date range and filters first. It's very likely Meta is blocking your access to that same data in Business Manager, too.

Meta Ads data is usually missing or incomplete when you're looking at ad campaigns (or ad sets) that use multiple different attribution windows. In these situations, Meta Business Manager refuses to provide sum totals and will tell you that your data "may not include" some users or that "statistical modeling may be used" on your data.

Since AgencyAnalytics can't access this data from Meta any more than Business Manager can, our widgets show the same missing data. Similar to how Meta Business Manager reports "-" when it refuses to provide some data, AgencyAnalytics widgets will also show missing data when Meta refuses to provide it.

Even though Meta is blocking your data, you can often access it using two AgencyAnalytics filters: the unified attribution setting type and the attribution window filter.

The "Unified" attribution setting type is enabled by default. It lets you access data that includes Apple iOS users. Alternatively, you can choose the "Account" attribution setting type, but this can cause Meta to show lower numbers for conversion-related metrics because Apple users are excluded from that data.

To access this setting on your Ads > Meta Ads dashboard, click the settings button at the top right, then select Filters.

The unified attribution setting is also available in Meta Ads widgets on reports and custom dashboards. Open the widget's settings (see How to Filter Widgets on Reports and Dashboards), then go to the Data tab to access it.

When you use Meta's unified attribution setting type, Meta may not allow you to view aggregate (sum) totals for some metrics, including app installs, purchases, and certain engagements. For example, an AgencyAnalytics stat widget, which shows sum totals, may not align with what's shown in a table widget, because Meta reports these two figures differently or blocks some of the data. This is the exact same data that's blocked in Meta Business Manager. Attribution window filtering, covered next, will usually let you get around this.

AgencyAnalytics also lets you filter for ad campaigns (or ad sets) that use one specific attribution window. Meta refuses to give you access to data when you're looking at multiple different attribution windows at once, so to get around this, choose one specific attribution window from the filter.

This filter is available via the settings button at the top right of your Meta Ads dashboard, or when editing a report or custom dashboard widget.

Once you've chosen the attribution window for your ad campaign or campaigns, Meta provides sum totals for all metrics. If you're running ad campaigns with different attribution windows, report on each window separately.

To quickly see which attribution window is being used for your ad campaigns, enable the "attribution setting" metric on your Ads > Meta Ads dashboard. The table then shows the exact attribution window used for each ad campaign or ad set.

We recommend configuring the filters above by going to Ads > Meta Ads in your Client's left navigation menu, then using the settings button at the top right to apply them.

Once configured, quickly add exactly what you see to a report using the "add to report" option under the Export button at the top right (see Add Any Dashboard to a Report). You can also add any widget to a custom dashboard via the "add to dashboard" option, found under the ellipsis (...) on any widget. Widgets added this way keep the exact same filtering you applied to the Ads > Meta Ads dashboard.

If you've tried the above and still can't get AgencyAnalytics to match what you see in Meta Business Manager, contact our support team and include full-screen images from Meta Business Manager. That helps us understand precisely what you're expecting to see.

Check your Meta Ads permissions in your Ads Manager Settings, under Ad account roles. Click here for detailed steps from Meta.

This is a non-standard configuration and isn't recommended by Meta's best practices guidelines. Our dashboard isn't designed to work with this setup and can't differentiate between campaigns within a single Meta Ads account if they aren't split by customer. If this is the case for you, we recommend re-creating your Meta Ads campaigns within the Meta Business Manager interface, split out by client.

If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help.