Comment connecter Keitaro et HilltopAds
Étape 1 : Obtenir une licence Keitaro
Avant d’utiliser Keitaro, vous devez disposer d’une licence active.
Rendez-vous sur le site officiel de Keitaro et créez un compte.
Choisissez un plan de licence adapté à votre volume de trafic.
Après l’achat, vous recevrez votre clé de licence (License Key) par e-mail.
Conservez cette clé : elle est nécessaire lors de la configuration.
Étape 2 : Configurer un serveur pour Keitaro
Keitaro est un tracker auto-hébergé (self-hosted) et nécessite donc un serveur.
Configuration minimale requise :
Système d’exploitation : CentOS 8 Stream ou CentOS 9 Stream
Virtualisation : KVM
Stockage : minimum 20 Go en SSD
Capacité du serveur selon le volume de trafic :
Clics par jour | RAM | CPU |
Jusqu’à 10 000 | 2 Go | 1 cœur |
10 000 – 100 000 | 4 Go | 2 cœurs |
100 000 – 500 000 | 8 Go | 4 cœurs |
500 000 – 1 000 000 | 16 Go | 4 cœurs |
1 000 000+ | 32 Go+ | 4–8 cœurs |
Rendez-vous sur FriendHosting et sélectionnez un serveur adapté à vos besoins.
Une fois le serveur prêt, procédez à l’installation de Keitaro.
Étape 3 : Configuration initiale de Keitaro
Ouvrez le panneau d’administration Keitaro via le lien fourni après l’installation.
Renseignez les paramètres suivants :
clé de licence
devise du système
langue par défaut
fuseau horaire
Créez un compte administrateur (nom d’utilisateur et mot de passe).
Enregistrez les paramètres.
Keitaro est maintenant prêt à être utilisé.
Étape 4 : Copier l’URL de postback HilltopAds
Connectez-vous à votre compte HilltopAds.
Accédez à la section Trackers.
Copiez votre URL de postback unique.
Copiez également votre Advertiser ID, requis pour le tracking postback.
Étape 5 : Ajouter HilltopAds comme source de trafic dans Keitaro
Depuis le tableau de bord Keitaro, allez dans Traffic Sources.
Cliquez sur Create.
Recherchez HilltopAds et sélectionnez le template correspondant.
Vérifiez et ajustez les paramètres si nécessaire.
Cliquez sur Save.
⚠️ Assurez-vous que le paramètre advertiserID est correctement renseigné avec votre Advertiser ID HilltopAds.
Paramètres HilltopAds pris en charge
Les paramètres suivants peuvent être transmis dans les postbacks :
{{geo}}– Code pays{{adid}}– Identifiant de la publicité ou de la bannière{{zoneid}}– Identifiant de la source de trafic{{campaignid}}– Identifiant de la campagne{{lang}}– Langue de l’utilisateur{{category}}– Mainstream / Adult{{cpmbid}}– Enchère CPM{{price}}– Prix de l’impression ou du clic{{browsername}}– Nom du navigateur
Paramètres obligatoires pour les postbacks :
{{token}}– Identifiant de la conversion{{price}}– Coût de la conversion{{currency}}– Devise de la conversion{{
advertiserID}} – Identifiant de l’annonceur
Étape 6 : Ajouter un domaine à Keitaro
Pour lancer des campagnes, vous devez connecter un domaine.
Enregistrez un domaine auprès de n’importe quel registrar (ex. NameCheap).
Dans les paramètres DNS du domaine, ajoutez :
A-record
Host : @
Value : l’adresse IP de votre serveur
TTL : la valeur la plus basse disponible
Dans Keitaro, allez dans Domains → Add.
Entrez le nom de domaine et cliquez sur Save.
Étape 7 : Créer une campagne dans Keitaro
Allez dans Campaigns et cliquez sur Create Flow.
Configurez :
le nom de la campagne
la source de trafic : HilltopAds
la destination du flow : offer, landing page ou les deux
Configurez le postback S2S en utilisant l’URL de postback HilltopAds.
Enregistrez la campagne.
Copiez l’URL de campagne (Campaign URL) générée.
Étape 8 : Lier la campagne Keitaro à HilltopAds
Connectez-vous à votre compte HilltopAds.
Allez dans Manage Campaigns → Add Campaign.
Configurez la campagne :
format publicitaire
canal de trafic
nom de la campagne
paramètres supplémentaires si nécessaire
Collez l’URL de la campagne Keitaro dans le champ Final Destination URL.
Cliquez sur Save.
Configuration terminée
Keitaro est maintenant intégré avec succès à HilltopAds.
Vous pouvez suivre les installations, les événements et les performances en temps réel. Si vous avez besoin d’aide pour la configuration ou l’optimisation, contactez votre gestionnaire de compte personnel.