📘 Instructions for Advertisers and Publishers

📢 For Advertisers

1. Registration and Login

Go to the home page and click "Register". Provide your email and password. After registration, log in to your personal account.

2. Creating an Advertising Campaign

In the "Campaigns" section, click "Create Campaign".
Specify the name, target URL, action type (click, lead, registration, purchase).
Set the cost per action and budget.
Select billing type: CPC (pay per click) or CPM (pay per 1000 impressions).
Select start and end dates (optional).

After creation, the campaign will have "Active" status (if budget > 0 and dates are current).

3. Balance Top-Up

Go to "Profile" → "Top Up Balance", enter the amount, and select an available cryptocurrency. BIS CX creates a secure invoice through NOWPayments and opens the payment page. After the provider confirms the payment, your balance is updated automatically.

4. Getting an API Token

In your personal account, open the "API Access" tab and create a personal API token. The secret value is shown only once, so store it securely. The same secret cannot be retrieved again after reloading the page. Rotating the token creates a new credential and immediately invalidates the previous one; revoking it disables this API access completely.

5. Sending Conversions via API

When a user follows an advertising link, BIS CX adds the bcx_tracking_id parameter to the destination URL. Store this value on your side and send it back with the conversion to associate the event with the original advertising click.

Endpoint: POST https://bis.cx/api/advertiser/postbacks

Headers:

Authorization: Bearer YOUR_PERSONAL_API_TOKEN
Content-Type: application/json

Request Example:

{
  "campaign_id": 123,
  "tracking_id": "bcx_tracking_id_value",
  "event_type": "lead",
  "external_event_id": "lead-550e8400-e29b-41d4-a716-446655440000",
  "external_user_id": "12345",
  "event_time": "2026-08-29T09:00:00Z"
}

Main Parameters:

campaign_id — your campaign ID
tracking_id — the bcx_tracking_id value received on the advertising click
event_type — conversion type, for example lead
external_event_id — unique event ID on your side; resending the same event does not create a duplicate
external_user_id — your user ID (optional)
event_time — event time in ISO 8601 format (optional)
amount, currency, and metadata — optional event data

The API token identifies the advertiser. BIS CX verifies that the campaign belongs to that advertiser and that the supplied tracking_id belongs to the specified campaign.

6. Analytics

In the "Analytics" section, you will see charts and tables with impressions, clicks, CPC, leads, CPL, registrations, CPR, purchases, CPP, costs, payouts to publishers, and ROI. You can download reports in PDF, Excel, PNG, or Markdown.

7. Campaign Management

You can pause, resume, or delete a campaign. Deleted campaigns are not displayed in the general list, but their data is preserved.

🤖 For Publishers (Telegram Bot Owners)

1. Commercial Publisher Connection

Commercial publisher integrations use a Publisher Source. BIS CX activates the source and provides its Source API Key. Store this key securely and do not expose it in public client-side code.

2. Requesting an Ad Placement

Request an available placement for your connected publisher source:

POST https://bis.cx/api/publisher/placements
X-Source-API-Key: your_source_api_key
Content-Type: application/json

{
  "external_placement_id": "placement-123",
  "external_user_id": "user-456",
  "context": {
    "placement": "telegram_bot"
  }
}

The response contains the placement status and, when an ad is available, the campaign_id, tracking_id, creative and click_url. Use the returned click_url for the advertising action so BIS CX can preserve tracking and attribution.

3. Sending Publisher Events

Send individual events supported by your Publisher Source:

POST https://bis.cx/api/publisher/events
X-Source-API-Key: your_source_api_key
Content-Type: application/json

{
  "campaign_id": 123,
  "event_type": "click",
  "external_event_id": "click-789",
  "external_user_id": "user-456",
  "metadata": {
    "placement": "telegram_bot"
  }
}

external_event_id must uniquely identify the event. Accepted event types depend on the capabilities enabled for your Publisher Source and its active campaign mapping.

4. Integration Notes

Authenticate commercial publisher requests with X-Source-API-Key.
Use a unique external_placement_id for each placement request.
Use the click_url returned by BIS CX instead of constructing tracking links yourself.
Do not expose the Source API Key in browser or other public client-side code.

5. Earnings and Payouts

You receive 90% of the cost of each target action (click, lead, registration, purchase).

Advertiser pays $0.01 per click → you receive: $0.009
Advertiser pays $10.00 per lead → you receive: $9.00

To receive payouts, set a USDT wallet address on the BSC (BEP-20) network in the "Payouts" section. Payouts are made automatically on the 1st of each month when the balance is at least $50 and are processed through NOWPayments. Status is available in payout history.

6. Support

If you have any questions, contact us on Telegram: @bis_cx_support or email support@bis.cx.