Features Pricing Sign Up 中文

Documentation

Everything you need to track, optimize, and stop losing money on refunds.

Getting Started

Converge tracks clicks and conversions, then dual-fires them to Meta & TikTok via server-side CAPI -- recovering the 15-30% of conversions browser pixels miss.

  1. Sign up (free, no card) → get your workspace
  2. Create a campaign and add your offer
  3. Connect a traffic source, grab the tracking link
  4. Add your Meta/TikTok CAPI token (see below)
  5. Drive traffic -- conversions auto-fire to CAPI
CAPI and refund write-back are included on the free plan. No add-on fees.

Tracking Setup

Point your traffic source to the Converge click URL. Converge redirects to your offer and records the click.

https://your-domain/click.php?campaign={campaign_id}&source={source}&sub1={sub1}

On conversion, your affiliate network fires a postback to:

https://your-domain/postback.php?click_id={click_id}&payout={payout}&txid={txid}

Meta CAPI -- 15 Parameters

Unlike RedTrack (5 params) or BeMob (3), Converge sends all 15 Meta Advanced Matching parameters -- hashed with SHA-256 for privacy:

em, ph, fn, ln, db, ge, ct, st, zp, country,
external_id, client_ip_address, client_user_agent, fbc, fbp

Setup

  1. In Meta Events Manager → Settings → generate a Conversions API token
  2. In Converge → Campaign → Meta CAPI → paste Pixel ID + token
  3. event_id is shared with the browser Pixel for 24h dedup
Higher Event Match Quality (EMQ) = lower CPA. The full 15-param payload typically lifts EMQ 2-4 points over 5-param trackers.

TikTok CAPI

Same dual-fire model. Server-side events to TikTok Events API with event_id dedup against the browser Pixel.

  1. TikTok Events Manager → generate Access Token
  2. Converge → Campaign → TikTok CAPI → paste Pixel Code + token

Refund Write-Back

When a customer refunds, fire a negative-value event to offset the original conversion. The ad algorithm stops optimizing toward refunders. No other major tracker automates this.

POST /api-refund-conversion.php
{
  "conversion_id": 12345,
  "amount": 49.00,
  "reason": "customer_refund",
  "type": "refund"
}

This generates a refund adjustment record AND auto-writes the negative event back to Meta/TikTok CAPI.

Postback / S2S

Inbound: your affiliate network → Converge. Outbound: Converge → traffic source + CAPI.

# Inbound conversion from network
GET /postback.php?click_id={ldelim}click_id{rdelim}&payout={ldelim}payout{rdelim}&txid={ldelim}txid{rdelim}
Traffic-source postbacks always fire (core tracking). CAPI is subject to plan limits on the free tier.

API Reference

Session-authenticated JSON endpoints. Responses use the envelope {ok, data, error}.

MethodEndpointDescriptionParams
GET /api/live-stats.php Dashboard realtime stats —
GET /api/attention/roi-alerts.php ROI alerts —
POST /api/bot-mode.php Bot detection mode toggle mode=shadow|block|off
Billing webhooks (/api-billing-webhook.php) are signature-verified (Stripe HMAC-SHA256 / Cryptomus md5) -- inbound only, not for manual calls.

Self-Hosting

Converge runs on PHP 8.2+ / MySQL 8. Deploy on your own server for full data ownership -- no per-event fees, unlimited volume.

git clone <repo> && cd converge
composer install
# configure config/config.php (DB + APP_KEY)
# point web root to /public

See saas-deployment.md for production setup (Nginx + PHP-FPM + MySQL).

Questions? hello@converge.io · ← Back to home