The analytics dashboard shows how your content is performing across connected platforms. Use it to understand what works and adjust your strategy.Documentation Index
Fetch the complete documentation index at: https://docs.socializioz.com/llms.txt
Use this file to discover all available pages before exploring further.
Key metrics
The dashboard displays six KPI cards at the top of the page:- Reach — how many unique people see your content
- Likes — engagement through likes or reactions
- Comments — replies and comments on your posts
- Shares — how often your content is shared or reposted
- Video views — play counts on video content
- Engagement rate — calculated as (likes + comments + shares) / reach, expressed as a percentage
Understanding your metrics
Use these benchmarks to interpret what your KPI numbers mean and where to focus your effort.| Metric | What “good” looks like | What to do if it’s low |
|---|---|---|
| Reach | Steady or growing week-over-week. A sudden drop may mean fewer posts or a platform algorithm change. | Increase posting frequency, try new content types (Reels, Stories), or post at different times. Check best posting times for optimal windows. |
| Likes | Consistently above 2–5% of reach for most platforms. | Experiment with more visual content, ask questions in captions, or use AI-generated captions with a Friendly or Casual tone. |
| Comments | Even a few comments per post indicates strong engagement. Comments are harder to earn than likes. | End captions with a question, use AI reply assist on the comments page to keep conversations going, and reply within the first hour. |
| Shares | Any shares are valuable — they extend reach organically. | Create content that educates, inspires, or entertains. “How to” posts and industry tips tend to get shared more. |
| Video views | Compare to reach — a views-to-reach ratio above 50% means your thumbnails and hooks are working. | Improve your opening frame, use text overlays in the first 3 seconds, and keep videos under 60 seconds for better completion rates. |
| Engagement rate | 1–3% is typical for business accounts. Above 5% is strong. Below 1% may indicate a content-audience mismatch. | Review your brand profile audience settings, test different tones and content types, and check that you are posting to the right platforms. |
Date range
Use the date range selector at the top of the dashboard to choose the time period for all charts and metrics. Available presets are 7 days, 30 days, and 90 days. On mobile, pull down from the top of the analytics page to refresh data.At-a-glance insights
At the top of the dashboard, an insight strip gives you a quick summary without scrolling:- Top post — the post with the highest engagement
- Best platform — the connected platform generating the most engagement
- Engagement trend — whether your overall engagement is rising or falling
Platform cards
Each connected platform gets its own analytics card showing:- Total posts — how many posts were published to that platform
- Success rate — the percentage of posts that published without errors, shown as a progress bar
- A visual bar comparing published and failed post counts
- Engagement rate — shown to two decimal places for platform-level cards
When a platform does not report reach data, the dashboard falls back to impressions. Reach counts unique viewers while impressions count total views, so these numbers may differ.
Top performing content
Below the platform cards, a ranked list shows your best-performing published posts sorted by engagement. Each entry includes:- A rank number (gold, silver, and bronze highlights for the top three)
- A thumbnail preview
- The caption and publish date
- Impression, like, and comment counts
- A link to open the original post on the platform (greyed out with “Link not available” if the platform did not return a URL)
Trend charts
Below the KPI cards, two charts help you spot patterns over time:- Reach and likes — an area chart showing reach and like trends. The chart displays the most recent 14 data points from your workspace metrics.
- Posts by platform — a bar chart comparing published and failed post counts per platform
Audience demographics
On Professional and Enterprise plans, the analytics dashboard includes audience demographics with three views:- Platform distribution — a donut chart showing how your content activity is split across connected platforms. Each segment displays a percentage and the legend shows platform names with color coding.
- Best posting times — a line chart showing average engagement by time-of-day bucket (00—06, 06—09, 09—12, 12—15, 15—18, 18—21, 21—24). The chart highlights your best time slot in green. Requires at least three published posts with engagement data across more than one time bucket.
- Audience overview — a full-width panel showing three summary stats (total followers across all accounts, number of connected accounts, and active platforms) plus a breakdown of up to six individual account badges with follower counts.
Follower counts are formatted with shorthand (for example, 1.5K, 2.3M). If a platform does not report follower data, that account shows a dash instead of a number.
AI insights
The AI insights panel generates personalized recommendations based on your real analytics data. The panel analyzes your total reach, average likes and comments per post, engagement rate, top posting hours, and per-platform follower counts to produce actionable advice. Click Generate to receive three tailored tips:| Insight | What it covers |
|---|---|
| Engagement | A suggestion to improve likes, comments, and shares based on your current metrics |
| Content type | Advice on which content formats are working best for you |
| Optimal timing | A recommended posting window based on when your past posts received the most engagement. If specific time slots are identified, they appear as badges below the tip. |
AI campaign planner
The AI campaign planner generates a full content calendar tailored to your goals, audience, and preferred platforms. You can open it from the analytics page or from the AI chat assistant. Campaign results are tracked on the campaigns page.Set your campaign goal
Enter your primary objective, such as “Increase brand awareness” or “Drive website traffic.” This field is required.
Define your audience and context
Optionally fill in Target Audience (for example, “Young adults 18-35”), Location (for example, “Dubai, UAE”), and Industry (for example, “Car rental”) to help the AI tailor its recommendations.
Select platforms
Toggle the platforms you want posts planned for: Instagram, Facebook, TikTok, or LinkedIn. You can select multiple.
Set content mix
Toggle which content types to include in the plan: Reels/Short Videos, Stories, Carousels, and Static Images.
- Day number and platform — when and where to post
- Content type — Reel, Story, Static, or Carousel
- Post idea — a suggested topic or angle
- Caption — ready-to-use text with a Copy button
- Media prompt — a description you can use with AI image or video generation
- Hashtags — up to five relevant tags
Evidence mode
Evidence mode is an administrative panel that provides a transparent audit trail for Meta App Review. It shows which permissions, API endpoints, and accounts the application is using, and over what timeframe. When visible, the panel displays:| Section | What it shows |
|---|---|
| Token type | The type of access token in use |
| Granted scopes | Permissions that have been approved, shown as green badges |
| Missing scopes | Permissions that are missing, shown as red badges |
| Endpoints called | API endpoints the application has accessed |
| Accounts queried | Which accounts were included in data requests |
| Period | The date range covered by the evidence |
Evidence mode is primarily used during Meta platform reviews and is not part of everyday analytics usage.
Permission health
The permission health banner monitors whether your connected accounts have the scopes needed for full analytics data. It has three states:| Banner | What it means | What to do |
|---|---|---|
| Amber (missing scopes) | One or more permissions are not granted. The banner lists the specific missing scopes using friendly names (for example, “Insights”, “Engagement”, “Pages List”). | Click Reconnect to re-authorize the account with the correct permissions on the connections page. |
| Blue (data populating) | All permissions are in place, but metrics are still being fetched from the platform. | Click Refresh to check for the latest data. |
| No banner | Everything is healthy — permissions are granted and data is available. | No action needed. |
read_insights, pages_read_engagement) for troubleshooting.
Analytics setup
If your analytics dashboard is missing data for some platforms, an Analytics setup card appears with suggested next actions. Click View details to open a per-platform readiness summary showing each account’s status:| Status | Meaning |
|---|---|
| Available | Analytics data is ready |
| No data | No published posts with metrics yet |
| Missing permissions | The account needs to be reconnected with additional scopes |
| Provider limitation | The platform does not provide certain metrics through its API |
| Error | An unexpected issue occurred while fetching data |
Exporting analytics
You can export your analytics data as a CSV spreadsheet or a formatted PDF report. Exports are available on Professional and Enterprise plans.Export a report
Open the analytics dashboard
Navigate to Analytics from the sidebar or the workspace overview command center.
Set your date range
Use the date range selector at the top of the page to choose 7 days, 30 days, or 90 days. The export uses whichever range you select.
Filter by account (optional)
If you only want data for a specific connected account, apply that filter before exporting.
CSV export
CSV exports let you download raw data as a spreadsheet. You can export two types of data:| Export type | What it includes |
|---|---|
| Metrics | Date, platform, post ID, impressions, reach, likes, comments, shares, saves, clicks, video views, and engagement rate |
| Posts | Post ID, title, platform, published date, media presence, total engagement, total reach, likes, comments, and shares |
PDF report
PDF exports generate a formatted report suitable for sharing with your team or clients. Each report includes:- Performance summary — total posts, reach, engagement, engagement rate, likes, comments, shares, and video views for the selected period
- Platform breakdown — post count, reach, and engagement per connected platform
- Top five posts — your best-performing posts ranked by total engagement
ROI reporting
ROI reporting is available on Professional and Enterprise plans. It combines your engagement data with content output to help you measure the business impact of your social media activity. ROI metrics build on the data already visible in the analytics dashboard:- Content effort — how many posts you published during the selected period and which platforms received the most activity
- Engagement return — total engagement (likes, comments, shares) relative to content volume, showing which platforms and content types deliver the most value per post
- Engagement rate trend — how your engagement rate is changing over time, highlighting whether your content strategy is improving
ROI reporting uses the same metrics collected from platform APIs. The accuracy of ROI data depends on the permissions granted to your connected accounts. If metrics are missing, check the permission health banner.
Weekly analytics review
Use this workflow at the end of each week to assess your content performance and plan improvements.Set the date range to 7 days
Open the analytics dashboard and select 7 days from the date range selector. This gives you a focused view of the past week’s performance.
Check your KPI cards
Compare this week’s reach, likes, comments, and engagement rate to your usual numbers. Look for any significant increases or drops. Use the metric interpretation guide above for context on what the numbers mean.
Review top performing content
Scroll to the Top performing content section. Note which posts earned the gold and silver ranks — what content type were they? What tone? What time were they posted? Use these patterns to guide next week’s content.
Check platform cards
Review the success rate and engagement rate for each connected platform. If one platform has a significantly lower success rate, check the schedule for failed posts and the troubleshooting page for common fixes.
Generate AI insights
Click Generate in the AI insights panel to get fresh recommendations based on your latest data. The three tips (engagement, content type, optimal timing) give you actionable next steps for the coming week.
Analytics by plan
| Plan | Analytics level |
|---|---|
| Free | Basic (KPIs, trend charts, platform cards) |
| Starter | Basic |
| Professional | Advanced (includes audience demographics, AI insights, ROI reporting, top content, and export) |
| Enterprise | Advanced |
Features
- Workspace scoping — analytics data is filtered to your currently active workspace. Switch workspaces using the workspace selector in the sidebar to view different data.
- Timezone-aware — all data is displayed in your configured timezone
- Pull-to-refresh — on mobile (touch devices only), swipe down from the top of the analytics page to reload data. Desktop users can switch the date range selector to trigger a refresh.
- Bilingual support — the dashboard is available in both English and Arabic with full RTL layout support
Empty states
If you have not connected any social accounts yet, the dashboard shows a prompt to visit the connections page. If you have connected accounts but no published posts, a prompt suggests creating your first post in the composer.You need at least one connected account with published posts to see analytics data.
Data freshness and retention
Analytics data is cached for two minutes. If you publish a post and immediately check the dashboard, the new post may not appear until the cache refreshes. On mobile, pull to refresh to force an update. On desktop, switching the date range triggers a fresh data fetch. Any metric that is unavailable or still loading displays a dash (”---”) as a placeholder. The date range selector limits dashboard views to the most recent 7, 30, or 90 days. Metrics outside the selected window are not shown on the dashboard but remain available if you switch to a longer range. Export your data regularly if you need to preserve historical records beyond what the dashboard displays.Platform APIs may stop returning engagement data for very old posts. If metrics for older content show dashes, the platform has likely stopped reporting those numbers rather than Socializioz discarding them.
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| Dashboard shows “Connect your accounts first” | No social accounts are linked to this workspace | Go to the connections page and link at least one account |
| Dashboard shows “No data yet” | Accounts are connected but no posts have been published | Create and publish a post from the composer |
| Amber banner warns about missing permissions | The connected account was authorized without the scopes needed for analytics (for example, read_insights or pages_read_engagement) | Click Reconnect on the banner to re-authorize the account with the required permissions |
| Blue banner says “Data is populating” | Permissions are correct but metrics have not been fetched yet | Click Refresh or wait a few minutes for the platform to return data |
| Metrics show zero for a recent post | Platforms can take several minutes to calculate engagement numbers after a post goes live | Pull to refresh on mobile or click the refresh icon. If metrics remain at zero after an hour, check the analytics setup card for platform-specific issues |
| Audience demographics section is missing | Demographics are available on Professional and Enterprise plans only | Upgrade your plan to access audience demographics and AI insights |
| AI insights button is greyed out | You need at least one published post with metrics before insights can be generated | Publish content and wait for metrics to populate, then try again |
| Export button is missing | Export is available on Professional and Enterprise plans | Upgrade your plan to unlock CSV and PDF exports |
| Analytics setup card shows “Missing permissions” for a platform | The account needs to be reconnected with additional OAuth scopes | Go to connections, disconnect the account, and reconnect it to grant the required scopes |
| Analytics setup card shows “Provider limitation” | The platform API does not expose certain metrics | This is a platform restriction and cannot be resolved. Available metrics vary by platform. |
| Dashboard shows data but all metrics are zero or dashes | A network error may have occurred while fetching data, causing the dashboard to display empty results | Try refreshing the page. If the issue persists, check the system status page. |
| ”Failed to generate insights” error | The AI service was temporarily unavailable | Wait a moment and click Generate or Refresh Insights again. If the error persists, check system status. |
| ”Failed to generate plan” error | The AI campaign planner could not complete the request | Make sure you have entered a campaign goal (required). Try again with simpler inputs if the error repeats. |
| Best posting times chart is not showing | You need at least three published posts with engagement data spread across more than one time-of-day bucket | Publish more content at different times of day to unlock this chart. |
| Recently published post not appearing in analytics | Analytics data is cached for two minutes | Wait two minutes or force a refresh (pull to refresh on mobile, or switch date ranges on desktop). |
Related
- Published posts — browse published content with per-post engagement metrics
- Campaigns — view analytics scoped to specific campaigns
- Connections — manage account health and permissions that affect analytics data
- AI chat assistant — ask the AI to summarize analytics or export reports
- Plans and billing — audience demographics and exports require Professional or Enterprise plan