Come collegare Keitaro e HilltopAds
Step 1: Ottenere una licenza Keitaro
Prima di utilizzare Keitaro, è necessario disporre di una licenza attiva.
Scegli il piano di licenza più adatto al tuo volume di traffico.
Dopo l’acquisto, riceverai la License Key via email.
Conserva la License Key: sarà richiesta durante la configurazione.
Step 2: Configurare un server per Keitaro
Keitaro è un tracker self-hosted, quindi richiede un server dedicato.
Requisiti minimi del server:
Sistema operativo: CentOS 8 Stream o CentOS 9 Stream
Virtualizzazione: KVM
Spazio disco: minimo 20 GB SSD
Capacità del server in base al volume di traffico:
Click giornalieri | RAM | CPU |
fino a 10.000 | 2 GB | 1 core |
10.000–100.000 | 4 GB | 2 core |
100.000–500.000 | 8 GB | 4 core |
500.000–1.000.000 | 16 GB | 4 core |
oltre 1.000.000 | 32 GB+ | 4–8 core |
Visita FriendHosting e seleziona il pacchetto server più adatto alle tue esigenze.
Una volta che il server è pronto, procedi con l’installazione di Keitaro.
Step 3: Configurazione iniziale di Keitaro
Apri il pannello di amministrazione di Keitaro tramite il link fornito dopo l’installazione.
Inserisci le seguenti impostazioni:
License Key
Valuta di sistema
Lingua predefinita
Fuso orario
Crea un account amministratore (username e password).
Salva le impostazioni.
Keitaro è ora pronto per l’uso.
Step 4: Copiare la Postback URL di HilltopAds
Accedi al tuo account HilltopAds.
Vai alla sezione Trackers.
Copia la tua Postback URL univoca.
Copia anche il tuo Advertiser ID, necessario per il tracking postback.
Step 5: Aggiungere HilltopAds come Traffic Source in Keitaro
Dalla dashboard di Keitaro, vai alla sezione Traffic Sources.
Clicca su Create.
Cerca HilltopAds e seleziona il template.
Controlla e modifica i parametri se necessario.
Clicca su Save per salvare la fonte di traffico.
⚠️ Assicurati che il parametro advertiserID sia compilato correttamente con il tuo Advertiser ID di HilltopAds.
Parametri HilltopAds supportati
I seguenti parametri possono essere inviati nei postback:
{{geo}}– Codice paese{{adid}}– ID annuncio o banner{{zoneid}}– ID sorgente di traffico{{campaignid}}– ID campagna{{lang}}– Lingua dell’utente{{category}}– Mainstream / Adult{{cpmbid}}– Offerta CPM{{price}}– Prezzo per impression o clic{{browsername}}– Nome del browser
Parametri obbligatori per i postback:
{{token}}– ID conversione{{price}}– Costo della conversione{{currency}}– Valuta della conversione{{
advertiserID}} – ID inserzionista
Step 6: Aggiungere un dominio a Keitaro
Per avviare le campagne, è necessario collegare un dominio.
Registra un dominio tramite qualsiasi registrar (ad es. NameCheap).
Nelle impostazioni DNS del dominio, aggiungi:
Record A
Host: @
Value: IP del tuo server
TTL: valore più basso disponibile
In Keitaro, vai su Domains → Add.
Inserisci il nome del dominio e clicca su Save.
Step 7: Creare una campagna in Keitaro
Vai alla sezione Campaigns e clicca su Create Flow.
Configura:
nome della campagna
traffic source: HilltopAds
flow destination: offer, landing page o entrambi
Configura il postback S2S utilizzando la Postback URL di HilltopAds.
Salva la campagna.
Copia la Campaign URL generata.
Step 8: Collegare la campagna Keitaro a HilltopAds
Accedi al tuo account HilltopAds.
Vai su Manage Campaigns → Add Campaign.
Configura la campagna:
formato dell’annuncio
canale di traffico
nome della campagna
impostazioni aggiuntive se necessarie
Incolla la Keitaro Campaign URL nel campo Final Destination URL.
Clicca su Save.
Operazione completata
Keitaro è ora integrato correttamente con HilltopAds.
Puoi monitorare installazioni, eventi e performance in tempo reale.
Se hai bisogno di aiuto con la configurazione o l’ottimizzazione, contatta il tuo personal account manager.