How to connect Keitaro and HilltopAds
Step 1. Obtain a Keitaro License
Before using Keitaro, you need an active license.
Go to the official Keitaro website and register an account.
Choose a license plan suitable for your traffic volume.
After purchase, you will receive a license key by email.
Keep the license key, it is required during setup.
Step 2. Set Up a Server for Keitaro
Keitaro is a self-hosted tracker and requires a server.
Minimum server requirements
Operating system: CentOS 8 Stream or CentOS 9 Stream
Virtualization: KVM
Disk: minimum 20 GB SSD
Server capacity depends on traffic volume:
Clicks per day | RAM | CPU |
up to 10,000 | 2 GB | 1 core |
10,000–100,000 | 4 GB | 2 cores |
100,000–500,000 | 8 GB | 4 cores |
500,000–1,000,000 | 16 GB | 4 cores |
1,000,000+ | 32 GB+ | 4–8 cores |
Visit FriendHosting and select a server package that suits your needs.
Here are the necessary server settings that you need to choose.
After the server is ready, proceed with Keitaro installation.
Step 3. Initial Keitaro Configuration
Open the Keitaro admin panel using the link provided after installation.
Enter the following settings:
License key
System currency
Default language
Timezone
Create an admin account (username and password).
Save the settings.
Keitaro is now ready to use.
Step 4. Copy Your HilltopAds Postback URL
Log in to your HilltopAds account.
Go to the Trackers section.
Copy your unique Postback URL.
Copy your Advertiser ID: it is required for postback tracking.
Step 5. Add HilltopAds as a Traffic Source in Keitaro
In the Keitaro dashboard, go to Traffic Sources.
Click Create.
Search for HilltopAds and select the template.
Check and adjust parameters if needed.
Save the traffic source.
⚠️ Make sure the advertiserID parameter is correctly filled using your HilltopAds Advertiser ID.
Supported HilltopAds Parameters
You can use the following parameters in Keitaro tracking:
{{geo}}— country code{{adid}}— ad or banner ID{{zoneid}}— traffic source ID{{campaignid}}— campaign ID{{lang}}— visitor language{{category}}— Mainstream / Adult{{cpmbid}}— CPM bid{{price}}— impression or click price{{browsername}}— browser name
Required postback parameters:
{{token}}— conversion ID{{price}}— conversion cost{{currency}}— conversion currencyadvertiserID— advertiser ID
Step 6. Add a Domain to Keitaro
To run campaigns, you must connect a domain.
Register a domain with any domain registrar (e.g. NameCheap).
In your domain DNS settings, add:
A-record
Host:
@Value: your server IP
TTL: lowest available
In Keitaro, go to Domains → Add.
Enter the domain name and save.
Step 7. Create a Campaign in Keitaro
Go to Campaigns and click Create Flow.
Configure:
Campaign name
Traffic source: HilltopAds
Flow destination: offer, landing page, or both
Set up S2S postback using the HilltopAds Postback URL.
Save the campaign.
Copy the generated Campaign URL.
Step 8. Link Keitaro Campaign to HilltopAds
Log in to your HilltopAds account.
Go to Manage Campaigns → Add Campaign.
Configure the campaign:
ad format
traffic channel
campaign name
additional settings if required
Paste the Keitaro Campaign URL into the Final Destination URL field.
Save the campaign.
Done!
Keitaro is now successfully integrated with HilltopAds.
You can track conversions, analyze traffic quality, and optimize campaigns in real time.
If you need help with setup or optimization, contact your personal account manager.