Como conectar o Keitaro à HilltopAds
Etapa 1: Obter uma licença do Keitaro
Antes de utilizar o Keitaro, é necessário ter uma licença ativa.
Acesse o site oficial do Keitaro e registre uma conta.
Escolha um plano de licença adequado ao seu volume de tráfego.
Após a compra, você receberá a License Key por e-mail.
Guarde a License Key, pois ela será necessária durante a configuração.
Etapa 2: Configurar um servidor para o Keitaro
O Keitaro é um tracker self-hosted, portanto requer um servidor próprio.
Requisitos mínimos do servidor:
Sistema operacional: CentOS 8 Stream ou CentOS 9 Stream
Virtualização: KVM
Armazenamento: mínimo de 20 GB SSD
Capacidade do servidor conforme o volume de tráfego:
Cliques por dia | RAM | CPU |
até 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 |
Acesse FriendHosting e escolha o pacote de servidor mais adequado às suas necessidades.
Após o servidor estar pronto, prossiga com a instalação do Keitaro.
Etapa 3: Configuração inicial do Keitaro
Abra o painel administrativo do Keitaro através do link fornecido após a instalação.
Insira as seguintes configurações:
License Key
Moeda do sistema
Idioma padrão
Fuso horário
Crie uma conta de administrador (usuário e senha).
Salve as configurações.
O Keitaro está pronto para uso.
Etapa 4: Copiar a Postback URL da HilltopAds
Faça login na sua conta HilltopAds.
Vá até a seção Trackers.
Copie sua Postback URL exclusiva.
Copie também o Advertiser ID, que é obrigatório para o tracking por postback.
Etapa 5: Adicionar a HilltopAds como Traffic Source no Keitaro
No dashboard do Keitaro, acesse Traffic Sources.
Clique em Create.
Procure por HilltopAds e selecione o template.
Verifique e ajuste os parâmetros, se necessário.
Clique em Save.
⚠️ Certifique-se de que o parâmetro advertiserID esteja preenchido corretamente com o Advertiser ID da sua conta HilltopAds.
Parâmetros suportados pela HilltopAds
Os seguintes parâmetros podem ser enviados nos postbacks:
{{geo}}– Código do país{{adid}}– ID do anúncio ou banner{{zoneid}}– ID da fonte de tráfego{{campaignid}}– ID da campanha{{lang}}– Idioma do usuário{{category}}– Mainstream / Adult{{cpmbid}}– Lance CPM{{price}}– Preço da impressão ou clique{{browsername}}– Nome do navegador
Parâmetros obrigatórios no postback:
{{token}}– ID da conversão{{price}}– Custo da conversão{{currency}}– Moeda da conversão{{
advertiserID}} – ID do anunciante
Etapa 6: Adicionar um domínio ao Keitaro
Para executar campanhas, é necessário conectar um domínio.
Registre um domínio em qualquer registrador (ex.: NameCheap).
Nas configurações de DNS do domínio, adicione:
A-record
Host: @
Value: IP do seu servidor
TTL: menor valor disponível
No Keitaro, vá até Domains → Add.
Insira o nome do domínio e clique em Save.
Etapa 7: Criar uma campanha no Keitaro
Acesse Campaigns e clique em Create Flow.
Configure:
Nome da campanha
Traffic Source: HilltopAds
Flow Destination: offer, landing page ou ambos
Configure o postback S2S utilizando a Postback URL da HilltopAds.
Salve a campanha.
Copie a Campaign URL gerada.
Etapa 8: Vincular a campanha Keitaro à HilltopAds
Faça login na sua conta HilltopAds.
Vá em Manage Campaigns → Add Campaign.
Configure a campanha:
formato do anúncio
canal de tráfego
nome da campanha
configurações adicionais, se necessário
Cole a Keitaro Campaign URL no campo Final Destination URL.
Clique em Save.
Concluído
O Keitaro foi integrado com sucesso à HilltopAds.
Você pode acompanhar instalações, eventos e desempenho em tempo real.
Se precisar de ajuda com configuração ou otimização, entre em contato com seu gerente de conta pessoal.