Welcome to the Voonix Get Started Guide! This guide will walk you through the initial setup to get your data seamlessly integrated into Voonix. By adding your brands, accounts, and deals, Voonix will automatically import your data and campaigns/trackers for streamlined data management.
What You’ll Need:
Let’s get started! Check out the video below for a quick overview, or follow the detailed steps outlined further down:
Choose the brands you want to add to Voonix. The search bar can help you quickly find a specific operator or brand.
You can always edit brands in the following steps
In this step, you’ll add your accounts by providing the required information. You can add multiple accounts and each account’s data will be displayed separately.
Click Create new login:
A pop-up box will appear where you can enter the account and deal information:
Enter the required information marked with bold and an asterisk (*). Optional fields can be filled in if needed. You will only see the fields relevant to your setup, along with optional fields you may choose to fill in.
Account information
Deal information
Click Save to proceed, and add additional accounts if necessary.
Manage brands:You can manage and edit brands under each operator as needed. Simply click on a brand name in the header row to make changes, delete a brand, or create a new one.
Before finalizing the brand and account integration, you can initiate the import queue for your accounts. This allows data to be imported in the background, saving you from completing these steps later.
You can enable the Import Schedule toggle for each operator and select a start month for the import queue. After selecting the start month, click Save. In this example, all accounts under Ivy Affiliates will have their data imported from January 2025 up to the current month.
Once you have added all the desired brands and accounts, click Create and Review at the top.
Voonix will provide a summary of the operators, brands, accounts, and scheduled imports before finalizing. If there are any issues, an error message will appear, allowing you to go back and make corrections. If everything looks good, click Create, and you’re all set!
Once you’ve successfully integrated all your brands and accounts into Voonix, you’re ready to view your data. If you scheduled data imports during the integration process, Voonix will automatically import the data in the background. You can proceed directly to the reports section to view your data:
1. Navigating to the Advertiser Earnings Report
Note: If the data does not appear as expected, click the Clear Cache button in the top-right corner to refresh the page.
2. Understanding Report Levels
The Advertiser Earnings report is structured into multiple levels:
Voonix automatically handles data imports for the current month, but you also have the option to manually import data, including historical data. This allows you to backfill old data into Voonix
1. Automatic Data Imports
Voonix automatically imports data multiple times a day between 8:00 AM and 11:00 PM, with imports occurring approximately every two hours. You can view the exact import schedule by navigating to Import → Import Schedule.
Additionally, Voonix imports data from the previous month twice a day from the 1st to the 3rd of each month and once a day from the 4th to the 12th.
All imports will be added to the queue and processed one month at a time.
Once the import is complete, you can view the status for each import and click the calendar icon in the Period column to access and review the imported data in your reports.
Import status definitions:
Once you have integrated all your brands and accounts into Voonix and the data imports have run, your data should be visible. However, errors can sometimes occur. Here are the most common issues and how to resolve them:
If your data in Voonix doesn’t seem correct, there may be an issue with your deal settings or report matching.
Is the deal in Voonix set correctly?
Make sure you have entered the correct revenue share percentage. In most cases, this should be set to 100%, unless your account is using one of the following systems: 888, SoftSwiss, GVC Affiliates, PrimePartners, Drake Affiliates, BetFlag.it, Silverplay Affilites, Number1 Affiliates and Netrefer API. If your account is with one of these, enter the actual revenue share percentage. Also, check that your CPA deal is correctly configured
Do you have multiple deals in your account?
If you have multiple deals, you need to add them in Voonix to ensure accurate reporting. You can do this by adding Campaign Deals:
Are you matching with the correct report?
Voonix pulls data from specific reports within different affiliate systems, and the data can vary between reports. Ensure you are comparing the correct reports. You can use the Data Validation module to verify which reports Voonix pulls data from and the specific data types retrieved for each account. To access this module, navigate to Import → Data Validation in the menu.
If unsure, contact us to confirm which reports we use.
The report is correct, but data is till not matching
Please reach out to support, and we will help you.
Has the import run for the month you’re checking?
Voonix automatically imports data for the current month only. If you’re looking at data from previous months, you need to manually import it, as decribed in the Import data section above or during the integration process. You can track your manual imports under Import → Import Queue and Import Status.
You can also try to click Clear cache in the report.
If you have entered the correct Brand ID?
Brand IDs can vary between accounts, even within the same affiliate system. If the Brand ID is incorrect or misspelled, Voonix won’t be able to retrieve data. If a Brand ID is used, it's worth to double-check that the Brand ID matches what is in your affiliate account.
Use the Brand Integration guide to locate Brand IDs in different affiliate systems.
Only some data is missing
If some columns display zero stats while others show data, this could be due to one of two reasons:
You can use the Data Validation module to verify which specific data types are retrieved for each account, and we normally get it or not. To access this module, navigate to Import → Data Validation in the menu.
Do you have any account issues?
Missing data can be due to an import error. See the next section for account-related issues.
Voonix will notify you of account issues by displaying a count in the Advertiser Logins menu. If an issue occurs, it means the import is not functioning correctly, and your data is not updating. Below are common account issues and how to resolve them.
Invalid credentials:
Invalid or missing API key:
Requires Whitelisting:
Terms and conditions:
Unknown import error: