Tracker Hub supports 5 affiliate trackers including Keitaro. Connect via tracker URL + API key. Sync campaigns, conversions, mappings.

Connect Keitaro via Tracker Hub

Tracker Hub supports 5 affiliate trackers: Keitaro, Voluum, RedTrack, BeMob, and Binom (Binom 2). Connect Keitaro at /trackers by providing your tracker URL + API key. Wevion authenticates to Keitaro using the Api-Key header (each tracker uses its own auth scheme — see the table below).

Who is this for

Affiliate marketers using Keitaro to route traffic + log conversions. Use Wevion's Tracker Hub to bring Keitaro data into unified analytics with your ad campaigns.

The supported trackers

Tracker Hub ships 5 connectable tracker adapters, each with its own authentication:

This article covers Keitaro setup specifically. Others follow similar patterns — switch tracker type in the setup flow. Only Binom 2 ("Next") is supported; legacy Binom 1.x is not.

TG Tracker: a tgtracker type exists in the platform, but it currently has no active adapter, so it does not appear in the Connect tracker dropdown and can't be connected yet. Treat it as planned, not available.

Before you start

• A Keitaro account running (self-hosted Keitaro instance or hosted)
• The Keitaro URL (e.g. https://your-keitaro.com)
• An API key generated in Keitaro's admin
• Wevion role: manager, admin, owner, super_admin

How to connect

Step 1: Get your API key from Keitaro

In Keitaro admin:

• Settings → API (or Tools → API depending on Keitaro version)
• Generate new API key (or copy existing)
• Note the key — Wevion will store it encrypted

Step 2: Open Tracker Hub in Wevion

In sidebar click Connect → Trackers or visit /trackers. The page lists already-connected trackers + has a Connect tracker button.

Step 3: Select Keitaro

Click Connect tracker → pick Keitaro from the type dropdown. Form expands with:

• Name (your label, e.g. "Production Keitaro" or "Client A Keitaro")
• Tracker URL (your Keitaro base URL, no trailing slash)
• API key (paste)

Step 4: Test connection

Click Test connection. Wevion makes a test API call to your Keitaro using the provided key. If success: connection valid. If error: shows what failed (auth, URL, network).

Step 5: Save configuration

Click Save. Wevion stores your tracker config with the API key encrypted (AES-256-GCM). It's then listed at /trackers.

Step 6: Initial sync

Within 15 minutes, Wevion's first sync pulls: campaigns, offers, landing pages, flows, traffic sources, click logs, conversions (last 30 days backfill).

Status badge: Syncing → Synced when done.

What you can do with a tracker

From the Tracker Hub you can:

• See the supported tracker types
• Test a tracker connection (without saving)
• List, create, and update your tracker configs
• List the tracker-side users for member mapping
• View and manage per-member access
• Run the mapping wizard, list/create mapping rules, view/update mappings, and auto-detect mapping suggestions
• View breakdowns by sub-ID, landing page, offer, and geo

What gets imported

After successful sync:

• Campaigns: Keitaro campaigns with traffic routing logic
• Offers: ad offers / products
• Landing pages: landing page configurations
• Flows: traffic flow rules
• Traffic sources: ad platforms / networks
• Click logs: clicks with attribution data (15-min cadence; full backfill on first sync)
• Conversions: conversions with revenue + status (approved / pending / rejected / hold — Keitaro states mapped to Wevion canonical ConversionStatus)
• Sub-IDs: tracking parameters (sub_1 through sub_N — most affiliates use sub_1 for click_id)

Use in:

• Wevion analytics: see which ad campaigns drive Keitaro conversions
• Per-funnel attribution: track full path from ad → click → tracker offer → conversion

Multiple Keitaro instances

Each Keitaro instance = separate tracker_config. Common for:

• Multi-account agencies (one Keitaro per client)
• Multi-environment setups (staging Keitaro vs production)

Repeat steps 2-6 per instance.

Tracker types beyond Keitaro

Same setup flow, different auth field:

• Voluum: needs Voluum URL + email/password (session token auth; 4h TTL auto-refreshed by Wevion via tokenEndpoint: /auth/access/session)
• RedTrack: API key with the Api-Key header (same pattern as Keitaro)
• Binom (v2): API key sent as the api_key query-string param on every request (not a header). Wevion appends the Binom 2 public API path (/public/api/v1) to your base URL automatically. Only Binom 2 ("Next") is supported.
• BeMob: two keys — access key as X-ACCESS-KEY plus a secret injected as X-SECRET-KEY

Security

• API key encrypted at rest via AES-GCM
• Wevion's request to Keitaro uses HTTPS
• Audit log records every Keitaro API call (admin view)
• Revoke at Keitaro admin → Settings → API → delete key

Common issues

• "Connection test failed: 401": API key wrong. Regenerate in Keitaro admin.
• "Connection test failed: ECONNREFUSED": Keitaro URL wrong or server down.
• "Connection test failed: timeout": network latency or Keitaro slow. Check Keitaro server load.
• Sync stuck > 30 min: large Keitaro instance (millions of clicks). First sync may take longer; subsequent syncs incremental.
• Wevion shows 0 conversions despite Keitaro logs: mappings not set up. Configure at /trackers/:configId/mappings.

FAQ

Which trackers does Wevion's Tracker Hub support?

Tracker Hub has 5 connectable tracker adapters: Keitaro, Voluum, RedTrack, BeMob, and Binom 2 (binom_v2). This article covers Keitaro specifically, but the others follow a similar setup at /trackers — you switch the tracker type in the setup flow. Keitaro and RedTrack use an Api-Key header, Voluum uses a session token, BeMob uses two keys (X-ACCESS-KEY + X-SECRET-KEY), and Binom 2 sends its API key as the api_key query-string parameter. A tgtracker type is declared in the platform but has no active adapter yet, so TG Tracker does not appear in the setup dropdown and can't be connected.

How does Wevion authenticate with my Keitaro instance?

Wevion authenticates to Keitaro using the Api-Key header with the API key you generate in Keitaro's admin under Settings → API. You paste your Keitaro URL and that key into the Connect tracker form at /trackers, then click Test connection so Wevion makes a test call before saving. RedTrack uses the same Api-Key header pattern; Binom 2, by contrast, sends the key as an api_key query-string parameter rather than a header.

Are my Keitaro API keys stored securely in Wevion?

Yes. Your Keitaro API key is encrypted at rest with AES-GCM before it's saved to the tracker_config row, and Wevion's requests to Keitaro use HTTPS. An audit log records every Keitaro API call for admins. You can revoke access at any time from Keitaro admin → Settings → API by deleting the key.

How far back does the first Keitaro sync pull data?

Your first Keitaro sync runs a 30-day backfill, pulling campaigns, offers, landing pages, flows, traffic sources, click logs, and conversions. It begins within 15 minutes of saving the connection, and the status badge moves from Syncing to Synced when done. Subsequent syncs are incremental on a 15-minute cadence.

Can I connect more than one Keitaro instance to Wevion?

Yes. Each Keitaro instance becomes a separate tracker_config, which is common for multi-account agencies running one Keitaro per client, or for staging-versus-production setups. Just repeat the Connect tracker flow at /trackers for each instance, giving each a distinct name like "Production Keitaro" or "Client A Keitaro."

FAQ

Which trackers does Wevion's Tracker Hub support?

Tracker Hub has 5 connectable tracker adapters: Keitaro, Voluum, RedTrack, BeMob, and Binom 2 (binomv2). This article covers Keitaro specifically, but the others follow a similar setup at /trackers — you switch the tracker type in the setup flow. Keitaro and RedTrack use an Api-Key header, Voluum uses a session token, BeMob uses two keys (X-ACCESS-KEY + X-SECRET-KEY), and Binom 2 sends its API key as the apikey query-string parameter. A tgtracker type is declared in the platform but has no active adapter yet, so TG Tracker does not appear in the setup dropdown and can't be connected.

How does Wevion authenticate with my Keitaro instance?

Wevion authenticates to Keitaro using the Api-Key header with the API key you generate in Keitaro's admin under Settings → API. You paste your Keitaro URL and that key into the Connect tracker form at /trackers, then click Test connection so Wevion makes a test call before saving. RedTrack uses the same Api-Key header pattern; Binom 2, by contrast, sends the key as an api_key query-string parameter rather than a header.

Are my Keitaro API keys stored securely in Wevion?

Yes. Your Keitaro API key is encrypted at rest with AES-GCM before it's saved to the tracker_config row, and Wevion's requests to Keitaro use HTTPS. An audit log records every Keitaro API call for admins. You can revoke access at any time from Keitaro admin → Settings → API by deleting the key.

How far back does the first Keitaro sync pull data?

Your first Keitaro sync runs a 30-day backfill, pulling campaigns, offers, landing pages, flows, traffic sources, click logs, and conversions. It begins within 15 minutes of saving the connection, and the status badge moves from Syncing to Synced when done. Subsequent syncs are incremental on a 15-minute cadence.

Can I connect more than one Keitaro instance to Wevion?

Yes. Each Keitaro instance becomes a separate tracker_config, which is common for multi-account agencies running one Keitaro per client, or for staging-versus-production setups. Just repeat the Connect tracker flow at /trackers for each instance, giving each a distinct name like "Production Keitaro" or "Client A Keitaro."

Last updated: 2026-07-02

Related articles

• Keitaro sync flow — what data, how often
• Postback (S2S) tracking overview
• All integrations — overview and use cases
• Commerce & tracker integrations — complete guide