Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tagada.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Binom

Binom is a self-hosted click-id-based ad attribution tracker. Because Binom runs on your own server, the “tracking domain” you give TagadaPay is the domain of your Binom installation.

​
Setup

1

Find your Binom installation domain

Binom is self-hosted, so the tracking domain is whatever URL you use to access your Binom panel (e.g. track.yourdomain.com). It’s the same hostname your campaigns redirect through — you’ll see it in Binom under Sites & Domains.
2

Enable Binom in TagadaPay

Dashboard → Settings → Integrations → Binom → Connect. Paste your Binom hostname (no https://), save.No API key required — Binom’s /click.php endpoint authenticates entirely via the click_id.
3

Forward the Binom clickid through your offer URL

Binom’s clickid token is {clickid}. Your campaign’s offer URL should be:
https://yourstore.com/checkout?clickid={clickid}
TagadaPay also reads click_id and the _binom cookie as fallbacks.
4

Test with a real conversion

Place a test order. The conversion should appear in Binom’s Reports within ~60s.

​
What TagadaPay Fires

Per Binom’s official postback URL spec: 
https://{trackingDomain}/click.php?cnv_id={clickId}&payout={payout}&cnv_status={conversionType}&cnv_currency={currency}
Parameter mapping:
Binom paramSourceNotes
cnv_idClick_id captured on landerRequired. Binom’s S2S conversion-id parameter.
payoutOrder’s paid amount in major unitsOptional override available.
cnv_statusConversion type from integration form (default: 1)Binom uses numeric statuses: 1 = approved, 2 = pending, 3 = trash, etc. Customise per offer if you need a non-approved status.
cnv_currencyOrder’s currencyForwarded so Binom can correctly report multi-currency revenue.

​
How TagadaPay Identifies the Click

In priority order:
  1. URL parameter clickid (Binom’s canonical name)
  2. URL parameter click_id (fallback)
  3. Cookie _binom
  4. Cookie binom

​
Optional Settings

  • Conversion type — sent as cnv_status. Defaults to 1 (approved). Set to 2 if you want conversions to land in Binom as pending for manual review.
  • Fixed payout — overrides the order amount if set. Useful for fixed-CPA reporting.

​
Troubleshooting

  1. Check the Sites & Domains allowlist in Binom — postbacks from unknown domains can be silently rejected.
  2. Confirm the tracking domain in TagadaPay matches the exact hostname Binom is reachable on (no www. mismatch).
  3. Open the Binom server logs — the request will show with the cnv_id value. Compare to the click_id captured in TagadaPay’s customer metadata.
The cnv_status parameter is set to 3 (trash) somewhere — check the Conversion type field in the TagadaPay integration form. Default is 1.

​
References