Artículos de ayudaReferencia de API
Comienza aquí
EmpezandoPreguntas frecuentesPlanes y precios
Precios y planesAnunciantes
Ejecutando campañasEditores
Añadir un sitio y etiqueta de anuncioDinero
Depósitos y pagosCuenta
Seguridad de la cuentaDesarrolladores
Referencia de APILegal
Términos de ServicioPolítica de PrivacidadLa API REST de Adgora permite consultar estadísticas, listar y pausar campañas, comprobar saldos y listar zonas mediante programación. URL base: https://api.adgora.net. Todas las respuestas son JSON.
Autenticación
Cree un par de claves en su perfil (la clave secreta se muestra una sola vez). Envíelo en cada /v1 solicitud:
Authorization: Bearer {public_key}:{secret}Las solicitudes están limitadas a 120 por minuto y por cuenta; si supera el límite, se devuelve 429 con un Retry-After encabezado. Las claves tienen ámbitos de permiso (stats, campaigns, balance, zones); si falta un ámbito necesario, se devuelve 403.
Puntos de acceso
| Método & ruta | Ámbito | Respuesta |
|---|---|---|
GET /v1/balance | balance | saldos en USD de anunciantes & editores |
GET /v1/stats?days=7 | stats | registros diarios (añada role=publisher para la vista del editor) |
GET /v1/campaigns | campaigns | sus campañas |
POST /v1/campaigns/{id}/pause | campaigns | pausa una campaña |
POST /v1/campaigns/{id}/resume | campaigns | reanuda una campaña |
GET /v1/zones | zones | sus zonas de editor |
Ejemplo
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
"https://api.adgora.net/v1/stats?days=30"Postback S2S de conversiones
Para registrar conversiones CPA, llame a la URL de postback desde el servidor del anunciante cuando se produzca una conversión. La {clickid} macro se envía a su página de destino mediante la URL del clic — guárdela y devuélvala:
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123status puede ser confirmed, delivered, rejected o returned; order_ref es el identificador opcional de su pedido. Encontrará la clave secreta de la oferta en la página de la oferta.
Macros de la URL de destino
Añada estas macros a la URL de destino de una creatividad — Adgora las sustituye al hacer clic:
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}Construir una solicitud
Elige un endpoint y parámetros — el comando se actualiza a medida que avanzas. Las claves permanecen como marcadores: nunca pegues un secreto en una página web.
https://api.adgora.net/v1/balancecurl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET es un marcador de posición. Crea una clave en tu perfil y guarda el secreto en tu servidor.
