💡 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 es de 1200 peticiones por minuto y por usuario. Además, cada respuesta de la API 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.