What Meta Ad Widgets Are
Meta Ad Widgets are ready-made reporting widgets that pull metrics from a connected Meta ad account into Kyrios. You can add Meta Ad Widgets to:
Dashboards
Custom Reports
These widgets help users compare paid traffic performance with CRM, pipeline, funnel, and revenue data in the same workspace.
Key Benefits of Meta Ad Widgets
Meta Ad Widgets help teams monitor ad performance without switching between Kyrios and Meta Ads Manager. Key benefits include:
View Meta ad metrics beside sales and CRM data
Track spend, reach, clicks, purchases, and conversions
Identify rising costs or declining performance
Compare campaigns using table widgets
Build visual dashboards for internal teams
Build scheduled reports for clients or stakeholders
Prerequisites and Access
Before using Meta Ad Widgets, confirm that the Meta ad account is connected.
Requirements:
A Meta ad account must be connected in Kyrios.
LeadConnector permissions must allow access to the correct Business Manager, ad account, and pages.
The user must have permission to view or edit dashboards.
The user must have permission to create or schedule reports when using Custom Reports.
Meta Ad Performance Metrics
Meta Ad Widgets include common advertising metrics used to evaluate campaign performance.
Metric | Definition |
Website Purchases | Purchases completed on your website from Meta ad traffic. |
Conversions | Actions attributed to Meta ads based on your Meta setup. |
Meta Ad Clicks | Total clicks on Meta ads. |
Amount Spent | Total ad spend for the selected date range. |
Average CPC | Average cost per click. |
Cost Per Conversion | Average cost for each conversion. |
Ad Impressions | Total number of times ads were shown. |
Reach | Unique users who saw the ads. |
Average CPM | Average cost per 1,000 impressions. |
CTR | Percentage of impressions that resulted in a click. |
Top Campaign Widgets
Top Campaign widgets rank campaigns by a selected performance metric.
Widget | Definition |
Top Campaigns by Ad Spend | Campaigns ranked by highest ad spend. |
Top Campaigns by Conversions | Campaigns ranked by total conversions. |
Top Campaigns by Website Purchases | Campaigns ranked by website purchases. |
Top Campaigns by Ad Clicks | Campaigns ranked by ad clicks. |
Top Campaigns by Impressions | Campaigns ranked by impressions. |
Top Campaigns by Reach | Campaigns ranked by unique reach. |
Dashboard Widgets vs. Custom Report Widgets
Dashboards are best for daily monitoring. Use Dashboard widgets when users need quick, at-a-glance performance visibility during the day. Custom Reports are best for packaged reporting. Use Custom Reports when users need to build a report layout, send test emails, or schedule report delivery.
Add Meta Ad Widgets to a Dashboard
Use this workflow to add Meta Ad Widgets to a Kyrios Dashboard.
Go to Dashboard.
Click Edit dashboard.
3. Click Add widget.
4. In the Add New Widget panel, choose a chart type.
5. Open the Meta Ads widget category.
6. Select the Meta metric or Top Campaign widget you want to add.
7. Configure the widget settings.
8. Choose the chart type, title, metric, date property, date range, and comparison date range.
9. Click Save.
Add Meta Ad Widgets to a Custom Report
Use this workflow to add Meta Ad Widgets to a Custom Report.
Go to Reporting.
Select Custom Reports.
Click New Report.
4. Choose a report source.
5. Select Create a blank report, From template library, or import from an existing dashboard.
6. In the report builder, click the + icon.
7. Select Widgets.
8. Open the Meta Ads widget category.
9. Add the Meta widgets you want to include in the report.
10. Configure each widget.
11. Choose the chart type, title, metric, date property, date range, and comparison date range.
12. Click Save.
Schedule a Custom Report
Use report scheduling when stakeholders need to receive the report automatically by email.
Open the Custom Report.
Click Send or Schedule.
Select the schedule frequency.
Choose the send time.
Select the report date range.
Select the comparison date range.
Add recipients.
Add an optional message.
Send a test email when needed.
Common Issues and Fixes
The widget is blank
A Meta Ad Widget may appear blank when the date range is too narrow, filters are too restrictive, or the connected Meta account does not have matching data. Widen the date range, remove filters, and confirm that the correct Meta ad account is connected.
The Meta Ads category is not visible
The Meta Ads category may not appear if the Meta connection is missing or the user does not have the right reporting permissions. Confirm the Meta integration and user permissions.
The report does not show the expected data
Check the widget’s date range, comparison range, filters, and selected metric.
Also confirm that the Meta ad account has data for the selected period.
FAQ
Do I need a separate Meta connection for every account?
Yes. Each account pulls data from the Meta ad account connected inside that account.
How often do Meta Ad Widgets refresh?
Meta Ad Widgets update automatically. No manual export is required.
Why is my widget blank after I add it?
Common causes include a narrow date range, restrictive filters, no eligible ad account, or missing LeadConnector permissions.
Which users can connect to Meta and add widgets?
Users need permission to manage ad connections and permission to edit dashboards or create reports.
Can I combine Google Ads and Meta Ads metrics on the same dashboard?
Yes. Add widgets from both reporting libraries to compare channels side by side.
Can I schedule a Meta-only report for clients?
Yes. Build a Custom Report using only Meta Ad Widgets, then schedule email delivery.
Will disabling the Meta integration affect existing widgets?
Yes. Widgets stop showing data until an eligible Meta ad account is reconnected. The widget layout and settings remain in place.