Getting Started

Welcome to Zervixa, your cloud-based affiliate tracking platform. This guide will help you set up your account and launch your first campaign in minutes.

Zervixa provides everything you need to track clicks, conversions, and revenue across multiple traffic sources and offers. With our intuitive interface and powerful features, you can scale your affiliate business efficiently.

Key Features

Signing Up

Getting started with Zervixa is free and takes just a few minutes.

Create Your Account

1. Visit the Zervixa sign-up page
2. Enter your email address and create a strong password
3. Verify your email address by clicking the confirmation link
4. Complete your profile information
5. Start your free trial immediately

All Zervixa accounts start with a 14-day free trial. No credit card required to get started.

First Campaign Setup

Let's walk through setting up your first affiliate campaign in Zervixa.

Step 1: Add a Traffic Source

First, you need to define where your traffic will come from:

1. Navigate to Traffic Sources in the sidebar
2. Click Add Traffic Source
3. Enter a name (e.g., "Native Ads Network")
4. Choose the traffic source type
5. Save your unique tracking token

Step 2: Add an Offer

Next, add the offer you want to promote:

1. Go to Offers
2. Click Add Offer
3. Enter the offer name and details
4. Set up your postback URL for conversion tracking
5. Copy your offer tracking ID

Step 3: Create a Campaign

Now create your campaign to connect traffic sources with offers:

1. Go to Campaigns
2. Click Create Campaign
3. Enter a campaign name
4. Select your traffic source and offer
5. Set up flow rules if needed
6. Enable the campaign and start tracking

Dashboard

The Dashboard is your command center in Zervixa. It provides a real-time overview of your tracking data and performance metrics.

Dashboard Overview

The main dashboard displays:

• Total Clicks: The total number of clicks tracked across all your campaigns
• Total Conversions: The count of successful conversions received from offers
• Click-to-Conversion Rate: The percentage of clicks that resulted in conversions
• Total Revenue: The total earnings from all conversions
• Recent Activity: A timeline of recent clicks and conversions
• Top Campaigns: Your best performing campaigns by clicks or revenue

Navigation

The main navigation menu provides quick access to all Zervixa features:

• Campaigns - Manage your campaigns
• Offers - Add and configure offers
• Traffic Sources - Manage traffic source integrations
• Landing Pages - Upload and manage landing pages
• Domains - Configure custom tracking domains
• Reports - View detailed analytics and reports
• Click Log - View real-time click data
• Settings - Account and integration settings

Quick Stats

The dashboard shows key metrics for different time periods. You can filter by:

• Today, Yesterday, Last 7 days, Last 30 days, or custom date range
• Specific campaigns, traffic sources, or offers
• Country or device type

Campaigns

Campaigns are the core of Zervixa. A campaign connects a traffic source to an offer, allowing you to track performance and manage your affiliate funnels.

Creating a Campaign

To create a new campaign:

1. Navigate to Campaigns
2. Click Create Campaign
3. Fill in the campaign details:
   • Campaign Name: A descriptive name (e.g., "Mobile Apps - Facebook")
   • Traffic Source: Select the source generating traffic
   • Offer: Select the offer being promoted
   • Landing Page (optional): Select a landing page to use
   • Status: Enable or disable the campaign
4. Click Create

Campaign Tracking URLs

Each campaign gets a unique tracking URL. Use this URL when sending traffic from your traffic source:

The tracking URL automatically tracks clicks, applies flow rules, and redirects users to your landing page or directly to the offer.

Flow Rules

Flow rules allow you to control how traffic is routed based on various conditions.

Rule Types:

• A/B Testing: Split traffic between multiple landing pages or offers by percentage
• Geographic Routing: Route traffic differently based on country or region
• Device Targeting: Show different content based on device type (mobile, desktop, tablet)
• Time-based Rules: Apply different rules based on time of day or day of week
• Random Routing: Randomly distribute traffic among multiple targets

A/B Testing

Zervixa makes it easy to run A/B tests:

1. Create multiple landing pages or offers
2. Set up a flow rule with "A/B Testing" option
3. Configure the traffic split (e.g., 50/50, 70/30)
4. Monitor performance in Reports
5. Stop the test and scale the winning variant

Campaign Performance

From the campaign list, you can see at a glance:

• Total clicks and conversions
• Conversion rate
• Total revenue
• Average revenue per click (ARPC)
• Campaign status

Editing & Pausing Campaigns

Click on a campaign to edit its settings. You can:

• Change the traffic source or offer
• Modify flow rules
• Pause or disable the campaign
• Delete the campaign (this does not affect tracked data)

Offers

Offers are the products or services you're promoting to earn commission. In Zervixa, each offer has its own tracking and conversion setup.

Adding an Offer

To add a new offer:

1. Navigate to Offers
2. Click Add Offer
3. Fill in the offer details:
   • Offer Name: The name of the product (e.g., "Weight Loss Supplement")
   • Offer URL: The URL where users will be sent
   • Payout (optional): The commission per conversion
   • Category: Categorize your offers for easier management
   • Description (optional): Internal notes about the offer
4. Click Create Offer

Conversion Tracking with Postback URLs

To track conversions from an offer, you need to set up a postback URL. This is how the offer notifies Zervixa when a user converts.

Postback URL Format:

Available Postback Macros:

Setting Up Postbacks

To add a postback URL to your offer:

1. Open the offer for editing
2. Click Add Postback URL
3. Enter your postback URL with the required macros
4. Test the postback to ensure it's working
5. Save the offer

Managing Offers

From the Offers list, you can:

• View the total clicks and conversions for each offer
• See the conversion rate
• Edit offer details and postbacks
• Disable or archive offers
• Export offer performance data

Traffic Sources

Traffic sources represent where your users are coming from. This could be a native advertising network, social media platform, or your own publisher sites.

Adding a Traffic Source

To add a new traffic source:

1. Navigate to Traffic Sources
2. Click Add Traffic Source
3. Fill in the details:
   • Source Name: A descriptive name (e.g., "Facebook Native Ads")
   • Source Type: Choose from predefined types or create custom
   • Status: Enable or disable the source
   • Cost Tracking: Enable cost tracking if you pay for traffic
4. Click Create Source

Traffic Source Tokens

Each traffic source gets a unique token that identifies the source in your tracking URLs:

The traffic source token allows Zervixa to attribute clicks and conversions correctly to each source.

Cost Tracking

To track your advertising spend and calculate ROI:

1. Enable cost tracking when creating the source, or edit the source later
2. Set the cost per click (CPC) or use the cost import feature
3. Import daily costs via API or CSV
4. View ROI calculations in your Reports

Cost Import Format

If importing costs via API, use this format:

Source Parameters

Use these optional parameters in your traffic source URLs to track additional information:

• utm_source - The traffic source
• utm_medium - The medium (cpc, cpa, etc.)
• utm_campaign - The campaign name
• utm_content - Ad creative or placement
• sub_id - Custom tracking parameter

Landing Pages

Landing pages are the pages your users see after clicking your campaign links. Zervixa makes it easy to manage and rotate multiple landing pages.

Adding a Landing Page

To add a new landing page:

1. Navigate to Landing Pages
2. Click Add Landing Page
3. Choose your upload method:
   • Upload HTML File: Upload a pre-built landing page
   • External URL: Link to a page hosted elsewhere
   • Clone Existing: Duplicate a previous landing page
4. Give your landing page a name
5. Click Save

Landing Page Optimization

Tips for optimizing your landing pages:

• Clear Messaging: The value proposition should be immediately obvious
• Strong Call-to-Action: Use clear, compelling CTA buttons
• Mobile Responsive: Ensure your page works on all devices
• Fast Load Times: Optimize images and code for quick loading
• Minimal Distractions: Remove navigation and exit intent popups
• Trust Signals: Include testimonials, guarantees, or security badges

Landing Page Rotation

Use landing page rotation to test multiple creatives and find your winners:

1. Create multiple landing page variations
2. In your campaign, set up a flow rule with "Landing Page Rotation"
3. Select the landing pages and configure the traffic split
4. Monitor performance in Reports
5. Once you have a clear winner, scale that landing page

Landing Page Analytics

Track how users interact with your landing pages:

• Page views and unique visitors
• Click-through rate to offers
• Bounce rate
• Time on page
• Conversion rate from that page

Domains & Tracking

Custom tracking domains improve user trust and avoid ad network filters. Zervixa makes domain management simple with automatic SSL and DNS configuration.

Why Use Custom Domains

• Trust: Users see your domain, not a third-party tracker
• Better Delivery: Avoid ad network filters and content filters
• Branding: Maintain control of your brand perception
• SEO: Domain authority is built on your domain, not a shared tracker
• Data Privacy: First-party cookies are more reliable and private

Adding a Custom Domain

To add a custom domain to Zervixa:

1. Navigate to Domains
2. Click Add Domain
3. Enter your domain name (e.g., track.yourbrand.com)
4. Click Next
5. Zervixa will generate DNS records you need to add

DNS Configuration

After creating the domain, you'll see the DNS records to add:

Add these records to your domain registrar (GoDaddy, Namecheap, etc.):

1. Log into your domain registrar
2. Go to DNS settings
3. Add the records provided by Zervixa
4. Save and wait for DNS propagation (typically 24-48 hours)

SSL Certificates

Zervixa automatically provisions and renews SSL certificates for your domains. This ensures:

• All traffic is encrypted (HTTPS)
• Browsers show your domain as secure
• No additional configuration needed on your end

Domain Verification

Once you've added the DNS records, Zervixa will automatically verify the domain. This usually takes 24-48 hours. You can check the status in the Domains list:

• Pending - DNS records added, verification in progress
• Active - Domain verified and ready to use
• Error - DNS records not found or incorrect

Using Your Domain

Once your domain is active, use it in your campaign tracking URLs:

Domain Rotation

To avoid detection and filtering, rotate between multiple tracking domains:

1. Add 2-3 tracking domains
2. Set up flow rules to rotate between domains
3. Monitor for any domain blocks
4. Swap out blocked domains quickly

Reports & Analytics

Zervixa's reporting tools give you deep insight into your affiliate performance. Analyze data by campaign, offer, traffic source, and more.

Report Types

Campaign Report

See performance metrics for each campaign:

• Total clicks and conversions
• Conversion rate and ARPC
• Revenue and ROI (if cost tracking enabled)
• Compare multiple campaigns side-by-side

Offer Report

Analyze which offers are converting best:

• Clicks and conversions per offer
• EPC (earnings per click)
• Top offers by revenue
• Trends over time

Traffic Source Report

Understand your traffic quality from each source:

• Clicks from each source
• Click quality and conversion rates
• Cost per conversion (if cost tracking enabled)
• ROI analysis

Geographic Report

See which countries are converting best:

• Clicks and conversions by country
• Regional conversion rates
• Identify your best performing geos

Device Report

Analyze performance by device type:

• Mobile vs. desktop conversion rates
• Device-specific revenue metrics
• Optimize for your best performing devices

Filtering & Grouping

Customize your reports with flexible filtering:

• Date Range: Today, yesterday, last 7/30/90 days, or custom
• Campaign: Single campaign or multiple campaigns
• Offer: Filter by offer
• Traffic Source: Filter by source
• Country: Single country or multiple countries
• Device Type: Mobile, desktop, tablet, or all

Group your data by:

• Campaign, offer, or traffic source
• Day, week, or month
• Country or device type
• Multiple dimensions at once

Exporting Reports

Export your reports for external analysis:

1. Build your report with desired filters and grouping
2. Click Export
3. Choose export format: CSV, Excel, or PDF
4. Save and open in your preferred tool

Report Scheduling

Schedule automatic report delivery:

1. Create your report with desired settings
2. Click Schedule Report
3. Choose frequency: daily, weekly, or monthly
4. Enter email recipient(s)
5. Save schedule

Key Metrics Explained

Click Log

The Click Log shows you real-time click data with detailed information about each user click. This is valuable for debugging campaigns and spotting suspicious activity.

Click Log Information

For each click, the log displays:

• Click ID: Unique identifier for this click
• Timestamp: When the click occurred
• Campaign: Which campaign generated the click
• Traffic Source: Where the user came from
• IP Address: User's IP address (partially masked)
• Country: Geo-location
• Device: Device type (mobile, desktop, tablet)
• Browser: Browser and OS
• Conversion Status: Pending, converted, or rejected
• Landing Page: Which landing page was shown
• Offer: Which offer received the click

Filtering Clicks

Use filters to find specific clicks:

• Campaign, traffic source, or offer
• Date/time range
• Country or device type
• Conversion status
• IP address or user agent

Fraud Detection

Look for suspicious patterns in your click log:

• Repeated IPs: Multiple clicks from the same IP
• Identical Parameters: Clicks with identical user agent and referer
• Unusual Timing: Unnatural click patterns (e.g., 100 clicks in 1 second)
• Conversions: Track which clicks convert vs. which don't

Click Log Export

Export click logs for external analysis:

1. Apply your desired filters
2. Click Export
3. Choose CSV or JSON format
4. Save the file

Real-Time Monitoring

The click log updates in real-time. Use it to:

• Monitor campaign performance as it happens
• Debug issues immediately
• Identify sudden spikes or drops in traffic
• Verify new campaigns are tracking correctly

API Reference

The Zervixa API allows you to programmatically integrate tracking into your applications and automate your affiliate management workflows.

API Basics

The Zervixa API is a RESTful API that uses JSON for request and response data.

• Base URL: https://your-instance.zervixa.com/api/v1
• Authentication: Bearer token in Authorization header
• Response Format: JSON
• Rate Limit: 1000 requests per minute

Authentication

To use the API, you need an API token. Get your token from Settings > API Tokens.

Include the token in every request:

Recording Clicks

Record a click programmatically:

Response:

Recording Conversions

Record a conversion via API:

Listing Campaigns

Get a list of all campaigns:

Query Parameters:

• status - Filter by status (active, paused, archived)
• limit - Number of results (default 50, max 250)
• offset - Pagination offset

Creating a Campaign

Create a new campaign via API:

Retrieving Reports

Get report data:

Full API Documentation

For complete API documentation with all endpoints and examples, visit API Documentation.

Billing & Plans

Zervixa offers flexible pricing plans to fit your needs, whether you're just starting out or running large-scale campaigns.

Our Plans

Free Trial (14 Days)

• All features included for 14 days
• No credit card required
• Unlimited campaigns, offers, and traffic sources
• Perfect for testing the platform

Starter Plan

• $29 per month
• Up to 50,000 clicks per month
• Basic reporting and analytics
• 1 custom tracking domain included
• Email support

Professional Plan

• $99 per month
• Up to 500,000 clicks per month
• Advanced reporting with custom grouping
• 5 custom tracking domains
• API access
• Priority support

Enterprise Plan

• Custom pricing
• Unlimited clicks
• All features included
• Unlimited domains and landing pages
• Dedicated account manager
• Custom integrations
• Priority support

Upgrading Your Plan

To upgrade your plan:

1. Go to Settings > Billing
2. Click Upgrade Plan
3. Select your desired plan
4. Add your payment method (Stripe)
5. Confirm and upgrade

Payment Methods

We accept the following payment methods:

• Credit cards (Visa, Mastercard, American Express)
• Wire transfers (enterprise only)
• Annual billing (10% discount)

Billing & Invoices

View and download your invoices:

1. Go to Settings > Billing > Invoices
2. Find your invoice in the list
3. Click to view or download as PDF

Refund Policy

We offer a 30-day money-back guarantee on all plans. If you're not satisfied with Zervixa for any reason, contact our support team within 30 days of your first charge for a full refund.

Overage Charges

If you exceed your plan's click limit, you'll be charged for overage at $0.01 per 1000 additional clicks. You can set overage limits or upgrade your plan in Settings.

Need Help?

Have questions about billing? Our support team is here to help. Visit Settings > Support to contact us.