Overview
Affnook empowers partners to track and analyze performance marketing data across brands, products, and affiliates in real time. This knowledge base article walks you through every step required to integrate your system with Affnook's APIs and ensure a seamless, reliable data flow.
Resources
● Website: https://affnook.com
● API Documentation: https://admin-api-docs.affnook.com
● Help Center: Available within the Affnook platform
Integration Flow Summary
The integration is structured as 8 sequential phases. Complete each step in order before proceeding to the next.
Step | Phase | Description | Reference |
1 | Basic Setup | Configure brands, products, affiliates, and campaigns | Manage → Brands / Affiliates / Campaigns |
2 | Revenue Setup | Verify GGR/NGR calculation formulas in Tracking Settings | Tracking → Settings |
3 | Tracking Setup | Generate and test affiliate tracking links | Generate Tracking Link Guide |
4 | Customer Registration | Capture registration events with tracking token or promo code | /api/admin/v2/customers |
5 | Activity Data Push | Send post-registration activity data (bets, wins, deposits, etc.) | /api/admin/v2/activities |
6 | Automation & Security | Manage API keys, IP whitelisting, and enable Anti-Fraud | Automation Panel |
7 | Team Setup | Add your team and assign role-based permissions | Team Management |
8 | Testing & Go Live | Validate sequence, data, and reporting | — |
Step 1- Basic Setup
The first step establishes the foundational entities in your Affnook account that all subsequent tracking and reporting depend on.
Add Brands
A brand represents the primary business entity being tracked. Every campaign and affiliate must be associated with a brand.
How to add a brand:
● Navigate to: Manage → Brands
● Click Add Brand and provide the brand name, URL, and any required identifiers.
● Save the brand to generate a unique Brand ID used in API calls.
Refer to the Brand Creation article available in the Help Center for field-level details.
Add Products (optional)
Products allow you to track performance at a game or product level within a brand. This is particularly useful for operators managing multiple verticals.
● Navigate to: Manage → Products
● Link each product to the relevant brand.
Add affiliates
Affiliates are the partners driving traffic to your platform. Affnook supports three methods for adding them:
● Manual Entry — add affiliates one at a time via the UI.
● Bulk CSV Upload — upload a formatted CSV file for multiple affiliates at once.
● API Integration — programmatically add affiliates via the Affnook Admin API.
Refer to the Affiliate Management Guide available in the Help Center for field-level details.
Create Campaign
Campaigns define the tracking rules, payout models, and targeting parameters for your affiliate partnerships.
● Navigate to: Manage → Campaigns
● Configure targeting (GEO, device, traffic type), payout structure (CPA, RevShare, Hybrid), and tracking parameters.
Refer to the Campaign Setup Guide in the Help Center for advanced configuration options.
Step 2: Revenue Set-up: GGR and NGR formula verification
Accurate revenue reporting depends on correctly configured GGR (Gross Gaming Revenue) and NGR (Net Gaming Revenue) formulas. Affnook provides predefined formulas that you can use out of the box or customise to match your internal financial model.
Navigate to: Tracking → Settings
Refer to the GGR/NGR Setup article in the Help Center for advanced configuration options.
Default Formula
● GGR = Bets − Wins
● NGR = GGR − Bonuses − Fees − Chargebacks
Custom Formula
To use a custom formula, enable the "Use custom GGR formula" or "Use custom NGR formula" toggle in Tracking → Settings, then define the variables that apply to your business model.
Note: Verify your formulas before going live. Incorrect formulas will affect all historical and future performance reports for your affiliates.
Step 3: Generate Tracking links
Each affiliate is assigned a unique tracking link tied to a specific campaign. When a user clicks the link, a unique tracking token is appended to the redirect URL.
How tracking links work:
● User clicks the affiliate tracking link.
● User is redirected to your designated landing page.
● A unique tracking token is generated and appended to the redirect URL.
● Your backend must capture and store this token — it is required when pushing customer registration data to Affnook.
Navigate to the Generate Tracking Link section in your Affnook panel and test each link end-to-end before sharing with affiliates.
Step 4 - Customer Data Integration
After a user registers on your platform, push their details to Affnook using the Customer API. This links the registered user to the originating affiliate and campaign.
API Endpoint:
Payload Example:
{ "customerId": "cust-008", "customerName": "new cust", "timestamp": 1698663196, "date": "2023-10-29", "currency": "USD", "brandId": "3", "productId": "1", "trackingToken": "649951f273a2009887761033", "country": "US", "promocode": "newcode009" }
Mandatory Fields:
● Either trackingToken OR promoCode (at least one is required)
● Either date OR timestamp (at least one is required)
API Key Location:
Configuration → Automation → API Tab
Step 5 - Activity Data Integration
After a customer is registered, push their ongoing activity data (bets, wins, deposits, withdrawals, etc.) to Affnook using the Activities API. This data powers the GGR/NGR calculations and affiliate performance reports.
API Endpoint:
Payload Example:
{ "customerId": "cust-001", "currency": "INR", "date": "2023-10-31", "timestamp": 1698734393, "productId": "64fa1e4f342c8ae7f315609b", "brandId": "64fafd43342c8ae7f315609b", "bets": 0, "wins": 0, "deposits": 0, "adjustments": 0, "chargebacks": 0, "fees": 0, "bonuses": 0, "withdrawls": 0, "transactionId": "Sdfr83j" }
Where to view activity data:
● Customer Report — in the Engagements section of your panel
● Activity Report — via the Platform Dashboard
Step 6- Automation & Security
Configure API security and enable fraud protection to ensure clean, reliable data across your integrations.
API Keys
● Navigate to: Configuration → Automation → API Tab
● Copy your API Key and include it in the Authorization header of every API request.
Note: After adding a new whitelisted IP, allow up to 10 minutes for the update to take effect.
IP Whitelisting
● Add the server IPs that will be sending API requests to Affnook.
● Only whitelisted IPs are permitted to call the Customer and Activity endpoints.
API Logs
● Navigate to: Automation → API Logs to review all POST requests.
● Use logs for debugging integration issues — each entry shows the endpoint, payload, HTTP status, error status, IP, and timestamp.
Step 7 - Anti-Fraud Rule Setup
Affnook's Anti-Fraud module automatically detects and blocks suspicious or low-quality traffic before it enters your reporting pipeline, ensuring only legitimate conversions are recorded.
How to enable Anti-Fraud:
● Go to: Configuration → Automation → Anti-Fraud Rule
● Toggle the rule to Enabled.
● Configure the validation policy as per your traffic quality requirements.
Note: Keeping Anti-Fraud active ensures your campaigns only record valid conversions and clean traffic sources, which protects affiliate payouts from inflated or fraudulent data.
Note: The anti-fraud tool operates only at the click level.
Step 8 - Team Setup
Invite your internal team members and assign role-based access controls to ensure each user only has access to the data and features relevant to their role.
● Navigate to: Team Management in your Affnook panel.
● Invite users via email and assign a predefined role (Admin, Analyst, Affiliate Manager, etc.).
● Roles control access to reporting, API configuration, campaign management, and more.
Refer to the Team member setup article in the Help Center for advanced configuration options.
Step 9 - Validation & Go-Live Checklist
Before going live, validate every component of your integration end-to-end. Use the checklist below to confirm each step has been completed successfully.
# | Checklist Item | Status |
1 | Brand(s) Created | Y/N |
2 | Product(s) Created | Y/N |
3 | GGR/NGR Formula Verified | Y/N |
4 | Affiliates Added | Y/N |
5 | Campaigns Configured | Y/N |
6 | Tracking Token Tested | Y/N |
7 | Customer Data Pushed via API | Y/N |
8 | Activity Data Pushed via API | Y/N |
9 | Anti-Fraud Enabled | Y/N |
10 | Roles & Permissions Configured | Y/N |
11 | Go Live ✅ | Y/N |
Once you have completed the setup, pushed the test data, and successfully tested the API, you are ready to go live by creating your live campaigns and onboarding your affiliates onto the panel.
Support
If you encounter any issues during integration or have feature requests, the Affnook team is available to assist.
● 📧 Email: [email protected]
● 💬 In-platform Help Center: accessible via the Affnook panel
● Your dedicated Customer Success Manager can also be contacted directly for priority support.
We are delighted to have assembled a world-class team of experienced professionals who are ready to take care of your queries and answer any questions you may have. Feel free to reach out to us at anytime by emailing us at [email protected] or by using the in-platform chat feature. We'd love to hear from you!
