Routy

Traffic Source — Integrations

The Integrations tab connects this traffic source to external platforms — ad networks and analytics tools — so data flows between them and Routy automatically.

What an integration does

Where a webhook pushes single conversion events to any URL, an integration is a managed, two-way connection with a specific provider. Once connected, Routy can:

  • Pull campaign metrics from the provider (impressions, clicks, cost, spend breakdowns by campaign / ad group / ad / keyword).
  • Push conversions back to the provider so its optimisation has your real results.

Typical providers include Google Ads, Facebook Ads, and Google Analytics 4. The list of available providers is shown as cards.

Connecting an integration

Each provider card shows its logo, a short description, and a status. To connect:

  1. Click Connect on the card.
  2. You're sent to the provider to authorise Routy (OAuth).
  3. Back in Routy, select which ad account to link.

Once linked, the card switches to Settings and starts syncing.

Google Analytics 4 is set up manually instead of OAuth — you enter a Measurement ID (G-XXXXXXXXXX) and an API Secret from your GA4 data stream.

Managing a connected integration

Open Settings on a connected card to see and control:

  • Connection — Active or Paused, plus health (last successful sync, consecutive failures). Test Connection checks it live.
  • Sync — direction (pull / push / bidirectional) and schedule. Sync Now triggers an immediate sync; Force Full Sync re-pulls everything.
  • Sync History — every sync attempt with status, type, record counts, and errors.
  • Conversion Mappings — choose which Routy conversion events get pushed to the provider, and which provider conversion action each maps to.
  • Metrics — the campaign performance data pulled in, with summaries and breakdowns.

Actions

  • Pause / Resume — temporarily stop or restart syncing without disconnecting.
  • Refresh Auth / Reconnect — if authorisation expires you'll see a Reconnection Required notice; reconnect to resume.
  • Disconnect — removes the integration and stops all syncing.

Statuses

Status Meaning
Not Connected No connection yet — the card shows Connect.
Pending account selection Authorised, but you still need to pick an ad account.
Connected / Active Working and syncing on schedule.
Paused Connected but syncing is stopped.
Error / Needs attention Authorisation or sync is failing — refresh auth or reconnect.

Common questions

"What's the difference between an integration and a webhook?"

A webhook pushes individual conversion events to any URL you choose. An integration is a full managed connection to a specific provider that both pulls metrics and pushes conversions, with its own sync schedule and history.

"It says Reconnection Required"

The provider's authorisation expired or was revoked. Open the integration and use Refresh Auth / Reconnect to restore it — syncing resumes once it's valid again.

"Conversions aren't reaching the provider"

Check the integration is Active (not Paused), then open Conversion Mappings — only mapped, enabled conversion types are pushed. Push History shows what was sent and any errors.