← Back to Documentation

Binom Integration

Complete guide to integrate BackNova with Binom tracker for conversion tracking.

Step 1: Configure Binom Campaign

1.1 Add BackNova as "Affiliate Network"

In Binom: Aff. Networks → Create

• Name: BackNova
• Postback URL:

https://api.backnova.xyz/api/postback?api_key=YOUR_API_KEY&click_id={subid}&status={status}&payout={payout}

Note: Binom uses {subid} or custom parameter to receive click ID from offers.

1.2 Create Your Offer

In Binom: Offers → Create

• URL: https://your-landing.com/?click_id={clickid}

The {clickid} macro passes Binom's click ID to your landing page.

Step 2: Landing Page Setup

2.1 Install tracker.js

Add to your landing page:

<script src="https://backnova.xyz/cdn/sdk.js" data-key="YOUR_API_KEY"></script>

2.2 Capture click_id

<form id="leadForm">
  <input type="hidden" name="click_id" id="click_id">
  <!-- other fields -->
</form>

<script>
  const urlParams = new URLSearchParams(window.location.search);
  document.getElementById('click_id').value = urlParams.get('click_id') || '';
</script>

Or automatically:

BackNovaTracker.attachToForm('#leadForm');

Step 3: Send Lead to BackNova

const response = await fetch('https://api.backnova.xyz/api/v1/decision', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    email: formData.email,
    phone: formData.phone,
    name: formData.name,
    source: 'binom_campaign_1',
    geo: 'US',
    click_id: formData.click_id,  // ← Binom's clickid
    ...BackNovaTracker.getData()
  })
});

const result = await response.json();
// result.event_id - BackNova's internal ID (for reference)
// Route lead to result.route_url

Step 4: Configure Postback Forward in BackNova

In BackNova Dashboard → API → Tracker Postback Forward:

For Binom, use this URL format:

https://YOUR_BINOM_DOMAIN/click.php?cnv_id={click_id}&cnv_status={status}&payout={payout}

Replace YOUR_BINOM_DOMAIN with your Binom tracker domain.

Available Tokens

Token	Description
{click_id}	Original Binom clickid
{event_id}	BackNova event ID
{status}	Conversion status
{payout}	Payout amount

Binom Status Mapping

Binom accepts these statuses in cnv_status:

• lead - for pending conversions
• sale - for approved conversions
• rejected - for rejected leads

Step 5: PP Sends Postback to BackNova

Configure your PP to send postbacks to:

https://api.backnova.xyz/api/postback?api_key=YOUR_API_KEY&click_id={CLICK_ID}&status={STATUS}&payout={PAYOUT}

Complete Flow Example

1. User clicks ad → Binom assigns clickid=abc123
2. User lands on page → URL: landing.com/?click_id=abc123
3. User submits form → Send to BackNova with click_id: abc123
4. BackNova returns → routes to PP with click_id: abc123
5. PP converts → Sends postback to BackNova
6. BackNova forwards → ?cnv_id=abc123&cnv_status=sale&payout=50
7. Binom records → Conversion in Binom stats!

Troubleshooting

Conversions not in Binom

1. Check click_id - Verify click_id is captured from URL
2. Check Binom logs - Stats → Conversions → check for errors
3. Verify postback URL - Test manually in browser
4. Check cnv_id format - Must match original clickid exactly

Currency

Add &cnv_currency=USD to postback if your payout is in different currency than Binom settings.