Artigos de ajudaReferência da API
Comece aqui
ComeçandoFAQPlanos e preços
Preços e planosAnunciantes
Executando campanhasEditores
Adicionar um site e tag de anúncioDinheiro
Depósitos e pagamentosConta
Segurança da contaDesenvolvedores
Referência da APILegal
Termos de ServiçoPolítica de PrivacidadeA API REST da Adgora permite consultar estatísticas, listar e pausar campanhas, verificar saldos e listar zonas de forma programática. URL base: https://api.adgora.net. Todas as respostas estão em JSON.
Autenticação
Crie um par de chaves no seu perfil (a chave secreta é mostrada apenas uma vez). Envie-o em cada /v1 pedido:
Authorization: Bearer {public_key}:{secret}Os pedidos estão limitados a 120 por minuto por conta; acima do limite, é devolvido 429 com um Retry-After cabeçalho. As chaves têm âmbitos de autorização (stats, campaigns, balance, zones); se faltar um âmbito necessário, é devolvido 403.
Endpoints
| Método & caminho | Âmbito | Resposta |
|---|---|---|
GET /v1/balance | balance | saldos em USD de anunciantes & publishers |
GET /v1/stats?days=7 | stats | dados diários (adicione role=publisher para a vista do publisher) |
GET /v1/campaigns | campaigns | as suas campanhas |
POST /v1/campaigns/{id}/pause | campaigns | pausa uma campanha |
POST /v1/campaigns/{id}/resume | campaigns | retoma uma campanha |
GET /v1/zones | zones | as suas zonas de publisher |
Exemplo
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
"https://api.adgora.net/v1/stats?days=30"Postback S2S de conversões
Para acompanhar conversões CPA, chame o URL de postback a partir do servidor do anunciante quando ocorrer uma conversão. A {clickid} macro é enviada para a sua página de destino no URL do clique — capture-a e envie-a de volta:
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123status pode ser confirmed, delivered, rejected ou returned; order_ref é o identificador opcional da sua encomenda. Encontre a chave secreta da oferta na página da oferta.
Macros do URL de destino
Adicione estas macros ao URL de destino de uma criatividade — a Adgora substitui-as no momento do clique:
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}Construa uma solicitação
Escolha um endpoint e parâmetros — o comando é atualizado conforme você avança. As chaves permanecem como marcadores: nunca cole um segredo em uma página da web.
https://api.adgora.net/v1/balancecurl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET é um espaço reservado. Crie uma chave no seu perfil e mantenha o segredo no seu servidor.
