— Documentation
How Adams Analytics Works
Complete technical documentation on how Adams Analytics processes your marketing data and delivers AI-powered insights.
●Last updated · August 2026
🏗️Platform Architecture
Infrastructure: Built on Next.js 15 with App Router for server-side rendering and optimal performance. MySQL database (via Prisma ORM) on OVH VPS infrastructure in France. Dedicated background sync pipeline for Meta API data. Report generation engine for on-demand and scheduled PDF exports.
🔗Connecting Your Meta Account
When you connect your Meta account via OAuth 2.0, our system: authenticates securely using read-only permissions (ads_read, pages_read_engagement, instagram_basic), discovers all your linked ad accounts and pages, and initiates your first full data sync — typically completing in under 5 minutes. From there, your data is automatically refreshed on a regular schedule so your dashboard is always current.
📊Report Types Available
Ads Performance Report: Campaign, ad set, and ad-level breakdowns with spend, reach, impressions, clicks, CPM, CPC, and conversions.
Website Purchase Funnel: Tracks the full purchase funnel from ad click to completed purchase, with conversion value and ROAS.
Facebook Page Report: Page reach, post performance, engagement trends, and follower growth.
Instagram Profile Report: Profile visits, reel performance, follower insights, audience breakdown, and top posts.
All reports are exportable as branded PDF files in Arabic or English.
Website Purchase Funnel: Tracks the full purchase funnel from ad click to completed purchase, with conversion value and ROAS.
Facebook Page Report: Page reach, post performance, engagement trends, and follower growth.
Instagram Profile Report: Profile visits, reel performance, follower insights, audience breakdown, and top posts.
All reports are exportable as branded PDF files in Arabic or English.
🔄Data Sync & Freshness
Adams Analytics syncs your Meta data automatically. The sync pipeline pulls the latest metrics from the Meta Marketing API and Page Insights API and stores them in your account. Data is updated regularly — the dashboard always reflects your most recent available metrics. You can also trigger a manual refresh from within the dashboard at any time.
📄PDF Report Generation
Reports are generated server-side as high-fidelity PDF files. Each report includes your brand logo, a cover page, executive summary, section-by-section metric breakdowns, and comparison periods where applicable. Arabic reports use correct right-to-left layout. Reports can be downloaded instantly or re-downloaded from your Reports archive at any time.
🔐Security & Privacy
All traffic is served over HTTPS with TLS encryption. Passwords are hashed with bcrypt and never stored in plaintext. Sessions are managed with signed JWT tokens via NextAuth.js. We request only read-only Meta API permissions and never modify your campaigns, budgets, or ad accounts. OAuth access tokens are stored encrypted server-side and are never exposed to the browser. Your data is hosted on OVH VPS infrastructure in France and is never sold or shared with third parties.
🚀Getting Started
Step 1: Create your free account — free trial, no credit card required.
Step 2: Connect your Meta ad accounts with one-click OAuth in under a minute.
Step 3: Your dashboard populates with your campaign data within minutes.
Step 4: Go to Reports, select your date range and report type, and export your first professional PDF.
Step 2: Connect your Meta ad accounts with one-click OAuth in under a minute.
Step 3: Your dashboard populates with your campaign data within minutes.
Step 4: Go to Reports, select your date range and report type, and export your first professional PDF.