AlterCPA Lite — the recommended tracker

AlterCPA Lite is the tracker we build for, and the one we recommend. Its lead statuses are identical to ours (wait / hold / approve / cancel / trash), so postbacks line up perfectly — and the whole setup takes one click.

  1. Open Profile in the AlterCPA TOP dashboard and click Connect tracker. (You can also do this from Settings → Connect tracker in the Telegram bot.)
  2. Pick a preset host — altercpa.red or altercpa.one — or type your tracker’s domain.
  3. Paste your tracker API key. You’ll find it in the tracker’s Profile → API key section. The format is {user_id}-{api_key}.
  4. Click Connect.

We validate the credentials, read your tracker’s postback token, and write all five global postback templates for you. That’s it — every campaign will now report conversions to Lite automatically.

The “Create flow” button

After setting up a campaign you’ll see a Create flow button next to the deep link. Clicking it creates a Lite flow pre-configured with your campaign’s deep link and returns the ready-to-share flow URL. No manual flow setup in the tracker needed.

What the wizard writes (for reference)

If you prefer to set the postbacks by hand, here are the five templates the wizard uses. Replace {domain} with your tracker’s domain and {token} with your postback token (found in the tracker’s Flows or Profile settings):

wait:    https://{domain}/postbacks/{token}?click={click}&uid={lead}&name={username}&status=wait
hold:    https://{domain}/postbacks/{token}?click={click}&uid={lead}&name={username}&status=hold
approve: https://{domain}/postbacks/{token}?click={click}&uid={lead}&name={username}&status=approve
cancel:  https://{domain}/postbacks/{token}?click={click}&uid={lead}&name={username}&status=cancel
trash:   https://{domain}/postbacks/{token}?click={click}&uid={lead}&name={username}&status=trash
  • click={click} — the click id from the deep link; Lite matches this to its click record.
  • uid={lead} — our internal lead id; Lite uses it to de-duplicate.
  • name={username} — subscriber’s Telegram @username when available.
  • status=... — a fixed value per template, matching Lite’s lead statuses exactly.

One-template shortcut

Because Lite’s statuses are identical to ours, you can use a single URL for all five events and pass {status} dynamically:

https://{domain}/postbacks/{token}?click={click}&uid={lead}&name={username}&status={status}

Set this as all five templates on your profile or campaign. The {status} macro carries the correct value for each event.

Finding your tracker API key and postback token

What you needWhere to find it in AlterCPA Lite
API keyProfile → API key (format {user_id}-{api_key})
Postback tokenFlows → (any flow) → Postback token, or returned by status.json after auth

You only need the API key for the one-click wizard — we fetch the postback token automatically.

In your AlterCPA Lite campaign’s traffic source, set the click id parameter to pass into the {click} placeholder of the deep link. Lite uses {click} as its own macro name, so the deep link stays clean:

t.me/YourBot?start=CAMPAIGNCODE-{click}

Replace CAMPAIGNCODE with your campaign’s code from AlterCPA TOP.