📘 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". A manual method via sole proprietor bank details in Georgia is temporarily available (see FAQ). After the transfer, the balance is updated manually within 1-2 business days. Automatic payment is under development.

4. Getting an API Token

In your personal account, open the "API Access" tab. You will find your personal API token there.

5. Sending Conversions via API

To track leads, registrations, and purchases, integrate your website or bot with our API.

Endpoint: POST https://bis.cx/api/stats/campaigns/{campaign_id}/stats

Headers:

Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

Request Body:

{
  "user_id": 12345,
  "action_type": "lead",
  "action_time": "2025-04-27T12:00:00Z",
  "external_id": "550e8400-e29b-41d4-a716-446655440000",
  "is_valid": true
}

Parameters:

user_id — User ID on your side
action_type — click, lead, registration, purchase
action_time — ISO 8601 format (2025-04-27T12:00:00Z)
external_id — Unique event identifier (prevents duplicates)
is_valid — Always true for valid conversions

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. Bot Registration

In your personal account, go to "My Bots" → "Add Bot". Provide:

Bot Name (e.g., "My Super Bot")
Bot Username (e.g., @my_bot)
Bot Token (get from @BotFather)
Niche (your bot's topic — optional)

After registration, you will receive an API Key. Save it — it is shown only once.

2. Getting Ads

To get active campaigns for display:

GET https://bis.cx/api/bot/ads
X-API-Key: your_api_key

Response:

[
  {
    "campaign_id": 123,
    "title": "Campaign Name",
    "target_url": "https://t.me/channel",
    "cost_per_action": 0.05
  }
]

3. Sending Statistics

Regularly send impression and click data:

POST https://bis.cx/api/bots/bot/stats
X-API-Key: your_api_key
Content-Type: application/json

Request Format (array):

[
  {
    "campaign_id": 123,
    "impressions": 500,
    "clicks": 10,
    "date": "2025-04-02"
  }
]

4. Python Example

import requests
import time

API_KEY = "your_api_key"
URL = "https://bis.cx/api/bots/bot/stats"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json"
}

while True:
    stats = [
        {
            "campaign_id": 123,
            "impressions": 500,
            "clicks": 10,
            "date": "2025-04-02"
        }
    ]
    response = requests.post(URL, json=stats, headers=headers)
    print(f"Status: {response.status_code}, Response: {response.text}")
    time.sleep(300)  # 5 minutes

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

Payouts are made manually upon request to support@bis.cx (automatic payouts are under development). Minimum payout amount: $50.

6. Support

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