💡 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
Para obtener un token de API, vaya a la página “API” en el menú de la izquierda y haga clic en “Generate new token”. También puede acceder a la documentación de API desde esa página y ver todos los tokens que ha usado antes.
❗ Por favor tenga en cuenta que solo puede haber un token válido a la vez. Entonces, una vez que genere un nuevo token, debe hacer un cambio en todas las solicitudes de API que haya realizado.
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.