> ## Documentation Index
> Fetch the complete documentation index at: https://elarislabs-87.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Insights

> Understand which ad creatives drive results across Meta, TikTok, and Snapchat — with cross-channel comparison, attribute breakdowns, AI recommendations, and predictive creative scoring.

Insights is Elaris's paid social analytics hub. It helps you figure out **what creatives are working** across your ad accounts so you can spend confidently and create more of what converts.

## Which ad platforms does Insights cover?

Insights connects to your paid ad accounts on **Meta (Facebook & Instagram), TikTok, and Snapchat**. Connect these during brand onboarding or later in **Brand Identity → Info → Ad Accounts**.

## What's in each Insights tab?

> [tab] Overview
>
> High-level KPIs across all connected ad accounts. Use this as your daily performance dashboard — spend, impressions, reach, clicks, and conversions at a glance.
>
> > [!TIP]
> >
> > Set a consistent date range before comparing periods. The Overview respects the global date filter in the top bar.

> [tab] Creatives
>
> Asset-level performance breakdown. See which individual videos, images, and carousels are driving results — and which are draining budget.
>
> Each creative row shows:
>
> * Spend, impressions, clicks, and CTR
> * Platform distribution
> * Creative score (if scored via Elaris)

> [tab] Attributes
>
> Dimension breakdowns that explain *why* certain creatives perform. Filter by:
>
> * **Placement** — Feed, Stories, Reels, Explore, etc.
> * **Audience signals** — age, gender, interest buckets
> * **Ad format** — single image, video, carousel
>
> Use Attributes to identify which placement or audience combination is pulling the most value.

> [tab] Cross-channel
>
> Side-by-side comparison across Meta, TikTok, and Snapchat. Understand where your budget is most efficient and how the same creative performs differently by platform.
>
> > [!NOTE]
> >
> > Cross-channel data is normalized to common metrics (impressions, clicks, spend) since each platform uses different native naming.

> [tab] Recommendations
>
> AI-powered suggested next actions based on your current performance data. Recommendations surface budget reallocation opportunities, underperforming creatives to pause, and high-performing variants to scale.

## How does predictive creative scoring work?

Score a creative **before you spend on it** to estimate its likely performance. You can score from two places:

> [card] In-app scoring
>
> Open any creative in the Insights → Creatives view or during campaign setup and click **Score**. Results appear in seconds.

> [card] MCP scoring
>
> Call `score_creative` via the Elaris MCP. Pass the asset reference and target platform to get a score you can act on programmatically.

Use scores to **prioritize variants** — when Studio or Campaigns produces multiple versions, score them all and put budget behind the top performers first.

## How do I connect my ad accounts?

**1. Go to brand onboarding or settings**

During brand setup, you'll be prompted to connect ad accounts. You can also do this any time from **Brand Identity → Info → Ad Accounts**.

**2. Select a platform**

Choose Meta, TikTok, or Snapchat and authorize via the platform's OAuth flow.

**3. Select the ad account**

After authorization, pick the specific ad account(s) you want to pull data from.

**4. Data starts flowing**

Historical data (up to 90 days, platform-dependent) loads automatically. New data refreshes on a regular sync cadence.

## Frequently asked questions

> [accordion] How is Insights different from Scheduler Analytics?
>
> Scheduler Analytics covers **organic posts** published through Elaris Scheduler. Insights covers **paid ad campaigns** running on Meta, TikTok, and Snapchat. Use both for a complete picture of your paid and organic performance.

> [accordion] How current is the data?
>
> Data sync frequency depends on the platform's API limits. Most platforms refresh multiple times per day. The last sync timestamp is shown in the top right of the Insights dashboard.

> [accordion] Can I export Insights data?
>
> Data export is available on select plans. Check your workspace plan details for export capabilities.

## Next steps

> [card] [Brand onboarding](https://elarislabs-87.mintlify.site/brands/onboarding.md)
>
> Connect ad accounts during brand setup

> [card] [Campaigns](https://elarislabs-87.mintlify.site/campaigns/overview.md)
>
> Create campaigns whose creatives you'll track in Insights

> [card] [Scheduler analytics](https://elarislabs-87.mintlify.site/scheduler/analytics.md)
>
> View organic post performance


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.