💡 Si está en el proceso de deshacerse de las hojas de cálculo o ya tiene un sistema de análisis adecuado, puede usar nuestra API para obtener los datos que necesite automáticamente, sin tener que importar un archivo CSV de vez en cuando.
💡 Por favor tenga en cuenta que nuestra API solo admite el método GET. Eso significa que no podrá eliminar ni agregar dominios o formatos de anuncios mediante la API.
Cómo obtener un token de API
El límite de solicitudes (Rate Limit) es de 1200 solicitudes por minuto por usuario. Además, puedes enviar hasta 5 solicitudes de estadísticas al mismo tiempo; si superas este límite, recibirás un error que te pedirá que lo intentes de nuevo más tarde. Cada respuesta de la API también se almacena en caché durante 60 segundos.
Para obtener un token de API, ve a la página Configuración (pestaña API) desde el menú lateral izquierdo y haz clic en "Generate API token":
❗️ Ten en cuenta que el token solo puede visualizarse y copiarse en el momento de su generación. Después de eso, ya no estará disponible.
En la página de la API también podrás ver:
El número de tokens activos que tienes actualmente; puedes tener hasta 5 tokens de API activos al mismo tiempo;
Un enlace clicable a la documentación de la API;
Información sobre todos tus tokens activos, incluyendo:
Nombre
Estado
Fecha de expiración (cada token permanece activo durante 1 año)
Fecha de creación
Fecha y hora del último uso
Dirección IP
País
Una opción para renombrar o eliminar cada token individual:
Recibirás una notificación por correo electrónico cuando alguno de tus tokens esté próximo a expirar.
Instale el token en este parámetro de encabezado llamado x-api-key:
Endpoints y URI disponibles
Todas las solicitudes se realizan al siguiente URI:
<https://api3.adsterratools.com/publisher/>
A continuación, encontrará la lista de endpoints disponibles:
/domains/{format}: devuelve los sitios web que ha agregado a Adsterra, incluso sus nombres e ID únicos./domain/{domain_id}/placements.{format}: sus placements en el dominio especificado; tenga en cuenta que primero necesitará recuperar el domain_id a través de la solicitud /domains/ {format}/placements.{format}: devuelve la lista completa de sus placements./stats.{format}: un informe que incluye impresiones, clics, CTR, CPM e ingresos por fecha. Puede especificar domain_id, placement_id, fechas de inicio y finalización, así como un GEO específico.
Se puede recuperar los datos en JSON, XML y CSV. Asegúrese de especificar el formato de datos que necesite en el URI:
<https://api3.adsterratools.com/publisher/domains.json>
Los ejemplos de solicitudes para obtener estadísticas de Adsterra a través de API
Le guiaremos a través de unas solicitudes utilizando Postman, una herramienta de prueba de API popular. Puede usarla para tener la idea de cómo formateamos los datos y para probar las solicitudes que planea realizar.
Primero, necesitamos obtener los IDs de nuestros dominios del siguiente URI:
<https://api3.adsterratools.com/publisher/domains.json>
En el cuerpo de respuesta, podemos ver lo siguiente:
Busquemos las placement_id's del primer sitio web (domain_id 1385226):
Ahora, podemos usar domain_id y placement_id para obtener las estadísticas de esta placement:
La respuesta:
Los errores posibles y formas de solucionarlos
401: el token es incorrecto. Por favor utilice el token disponible en su tablero de instrumentos.
403: el token ya no es válido. Por favor genere un token nuevo.
404: no encontrado. Asegúrese de que el URI sea correcto.
429: demasiadas solicitudes simultáneas. Significa que has enviado más de 5 solicitudes de estadísticas al mismo tiempo. Espera a que se completen las solicitudes en curso y vuelve a intentarlo.