Getting Started

Welcome to BotzLy! This guide will walk you through setting up your first campaign in 5 steps.

Step 1: Create Your Organization

After signing in, go to Organizations and click New Organization.

Your organization is your workspace — it holds all your advertisers, campaigns, affiliates, and tracking data. Choose a clear name (e.g., your agency name) and your preferred currency.

Tip: You can invite team members later from Organization > Team.

Step 2: Add an Advertiser

Navigate to your organization, then go to Advertisers > New.

An advertiser is your client — the company whose products or services you’ll be promoting. Fill in their details:

• Company name
• Contact email
• Website URL
• Any relevant notes

You’ll later attach campaigns and invoices to this advertiser.

Step 3: Create a Campaign

Go to Campaigns > New and fill in the campaign details:

• Name: A descriptive campaign name (e.g., “Summer Sale 2026”)
• Advertiser: Select the advertiser this campaign belongs to
• Landing URL: The destination where visitors will be redirected. You can use variables like {click_id}, {affiliate_id}, {source}, and {sub_id} that will be dynamically replaced.
• Status: Start with “Draft”, switch to “Active” when ready to track

Remunerations

Set up how affiliates get paid for this campaign:

• Fixed: A set amount per click/conversion (e.g., 0.50 EUR per click)
• Percentage: A percentage of the revenue (e.g., 30% per conversion)

Assign remunerations to affiliates to give them their specific payout terms.

Step 4: Generate Tracking Links

Once your campaign is active, go to Campaigns > Your Campaign and create tracked links.

Each tracking link is unique to an affiliate and campaign. When someone clicks it, the system:

1. Records the click (IP, timestamp, user-agent)
2. Validates against your campaign rules
3. Redirects to your landing URL with variables replaced
4. Caches the click for conversion matching

Share the tracking link with your affiliate. The format is:

https://yourdomain.com/t/{token}?source=email&sub_id=123

Step 5: Track Conversions

Conversions can be tracked via server-to-server (S2S) postbacks. When a conversion happens on the advertiser’s side, they call:

https://yourdomain.com/c/{click_id}

The system will:

1. Match the click_id to the original click
2. Validate the conversion (duplicate check, timing, IP)
3. Record revenue and payout amounts
4. Fire any configured postback webhooks

Setting Up Postbacks

Go to Postbacks > New to configure webhook notifications. When a conversion is approved, the platform can notify external systems with the conversion details.

Payload template variables:

• {click_id} — Original click identifier
• {conversion_id} — Conversion identifier
• {revenue} — Revenue amount
• {payout} — Payout amount
• {status} — Conversion status

What’s Next?

• Statistics: View real-time performance in Stats
• Invoices: Generate invoices for advertisers in Invoices
• Payout Calls: Process affiliate payouts in Payout Calls
• API: Integrate programmatically with our REST API
• Webhooks: Set up event-driven notifications in Webhooks
• IP Blocklist: Block fraudulent IPs in Blocked IPs

Need Help?

Contact our support team at contact@cyberbotz.fr.