Citatra

Integrations

Analytics Connectors

Connect your analytics platforms to unify revenue attribution across every provider in one dashboard.

Overview

Analytics Connectors let you bring data from up to nine external analytics platforms into Citatra, giving you a single view of how AI-generated search results drive traffic, conversions, and revenue. Once connected, Citatra automatically pulls revenue and conversion data, reconciles numbers across platforms, and highlights discrepancies so you can trust the attribution picture.

Navigate to Analytics Connectors in the sidebar (or Settings → Integrations) to manage your connections.

ℹī¸ Info

GA4 is available on any plan with Traffic Attribution enabled. Connecting additional platforms requires the Multi-Analytics feature on the Growth plan or higher.

Supported Platforms

Citatra supports nine analytics platforms, grouped by category:

Event Tracking

| Platform | Auth Method | Revenue Source | Data Quality | |---|---|---|---| | Google Analytics 4 | Service Account / OAuth | Purchase revenue (Citatra-attributed) | High | | Mixpanel | Bearer token | Purchase events | Medium | | Amplitude | API key & secret | Purchase events | High | | PostHog | Bearer token | Purchase events | High |

Privacy-First

| Platform | Auth Method | Revenue Source | Data Quality | |---|---|---|---| | Plausible | Bearer token | Goal-based conversions (estimated AOV) | Low | | Fathom | Bearer token | Purchase events | High | | Umami | Bearer token | Purchase events | High |

CRM & E-commerce

| Platform | Auth Method | Revenue Source | Data Quality | |---|---|---|---| | HubSpot | Bearer token | Closed-won deals | High | | Shopify | Access token | Orders filtered by Citatra source | High |

💡 Tip

Privacy-first platforms like Plausible report aggregated metrics only, so revenue figures are estimated using an average order value. For exact revenue tracking, use an event-based platform such as GA4 or Amplitude.

Connecting a Provider

  1. Open Analytics Connectors from the sidebar
  2. Click Connect next to the platform you want to add
  3. Fill in the required credentials — each provider has its own fields (API key, site URL, project ID, etc.)
  4. Citatra validates your credentials automatically. If validation fails, you'll see a specific error message explaining what went wrong
  5. Once connected, the provider card shows a green status indicator and the last sync timestamp

GA4 Setup

GA4 uses a Google service account or OAuth flow:

  • Service Account — create a service account in the Google Cloud Console, grant it Viewer access to your GA4 property, and paste the JSON key into Citatra
  • OAuth — click Connect with Google and authorize Citatra to read your GA4 data

Token-Based Providers

Most other platforms use an API key or bearer token:

  1. Generate an API token in your provider's settings
  2. Paste it into the Citatra connect dialog
  3. Add any extra fields (site ID, project ID, shop domain) if prompted

Disconnecting a Provider

Click the Disconnect button on any connected provider card. This removes the stored credentials and stops all data syncing. Historical data already imported is retained.

⚠ī¸ Note

Only workspace Owners, Admins, and Editors can connect or disconnect providers. Viewers have read-only access to analytics data.

Multi-Platform Revenue Dashboard

Once two or more providers are connected, the Multi-Analytics page aggregates revenue and conversions across all platforms into a single view:

  • Total revenue — combined revenue from every connected provider
  • Platform breakdown — per-provider revenue comparison chart
  • Conversion counts — total and per-provider conversions
  • Data quality indicators — each provider shows a High, Medium, or Low quality badge based on how it reports revenue

Attribution Models

Revenue can be attributed using five models:

| Model | Description | |---|---| | First Touch | 100% credit to the first interaction | | Last Touch | 100% credit to the last interaction | | Linear | Equal credit across all touchpoints | | Time Decay | More credit to recent touchpoints | | Data-Driven | Algorithmic weighting based on conversion paths |

Select your preferred model in workspace settings. The model applies across all connected providers.

Revenue Reconciliation

When providers report different revenue figures for the same period, Citatra performs automatic reconciliation:

  • Coefficient of variation (CV) is calculated across all provider totals
  • OK (green) — CV below 10%, numbers align well
  • Warning (yellow) — CV between 10% and 30%, review recommended
  • Error (red) — CV above 30%, significant discrepancy detected

A reconciliation alert banner appears on the Multi-Analytics page when the status is Warning or Error, including specific recommendations for resolving mismatches.

💡 Tip

Common causes of discrepancies include timezone mismatches, different attribution windows, and bot traffic filtering differences between platforms.

Caching & Rate Limits

To keep the dashboard responsive and respect provider API limits, Citatra uses a two-layer caching system:

  • In-memory LRU cache — 5-minute TTL for instant dashboard loads
  • MongoDB-backed persistence — longer-term storage to reduce API calls on cold starts

Each provider has its own rate limit (e.g., GA4: 60 requests/minute, Plausible: 300/day). If you hit a limit, Citatra queues the request and retries automatically. You can also force a manual sync by clicking Sync Now on any provider card.

Security

All provider credentials are encrypted at rest using AES-256-GCM before being stored in the database. Credentials are never logged or exposed in API responses. OAuth tokens for GA4 are refreshed automatically.

Plan Limits

| Plan | GA4 | Additional Providers | |---|---|---| | Free | — | — | | Starter | 1 connection | — | | Growth | 1 connection | Up to 4 providers | | Professional | 1 connection | Up to 9 providers |

CMS ConnectorsContent Generation