For the complete documentation index, see llms.txt. This page is also available as Markdown.

API para desarrolladores

Con la API de la plataforma es posible automatizar todas las funciones que se encuentran en el Panel de Administración.

1. ¿Qué pueden automatizar los anunciantes?
  • Campañas/grupos, variaciones, ofertas y formatos de anuncios

  • Segmentación/bloqueo de opciones de segmentación, categorías

  • Objetivos

  • Obtener estadísticas, incluidos los datos de usuarios de adblock

  • Presupuesto diario, financiación de la cuenta, tipos de pago

  • Nombre de la página de destino, URL y algoritmo de reparto de tráfico

2. ¿Qué pueden automatizar los editores?
  • Formatos de anuncios y zonas de anuncios

  • Sitios, verificaciones de URL

  • Bloquear tipos de anuncios y categorías de productos

  • Obtener todas las estadísticas, incluidos los datos de usuarios de adblock

  • Precios de puja por formato de anuncio/GEO, modelos de precios

  • Tipos de pago

3. Cómo usar la API
  • La interfaz de la API es rápida y fácil de usar

  • Simplemente selecciona un parámetro y pulsa el botón Probarlo para generar código automáticamente

4. Descargar documentación técnica

Cómo usar la API de la plataforma

Acabamos de actualizar nuestra API de la plataforma a la versión 2. Esta última versión te permite automatizar absolutamente todas las funciones dentro del Panel de Administración. Puedes usar la API para procesos sencillos, como automatizar tareas repetitivas para ahorrar tiempo, hasta proyectos más complejos, como cambiar creatividades de banners sobre la marcha.

Funciones

Tanto editores como anunciantes tienen a su disposición una amplia variedad de funciones. Aquí tienes un resumen de lo que se puede automatizar:

Anunciantes

  • Campañas individuales/grupales, variaciones, ofertas, formatos de anuncios.

  • Segmentación/bloqueo de opciones de segmentación, categorías, franjas horarias.

  • Objetivos.

  • Obtener estadísticas, incluidos los datos de usuarios de adblock.

  • Presupuesto diario, financiación de la cuenta, tipos de pago.

  • Nombre de la página de destino, URL y algoritmo de reparto de tráfico.

Editores

  • Formatos de anuncios y zonas de anuncios.

  • Sitios, verificaciones de URL.

  • Bloquear tipos de anuncios y categorías de productos.

  • Obtener todas las estadísticas, incluidos los datos de usuarios de adblock.

  • Precios de puja por formato de anuncio/GEO, modelos de precios.

  • Tipos de pago.

Antes de empezar

La interfaz de la API muestra una lista de títulos de grupos. Haz clic en un grupo y se desplegarán todas las opciones disponibles.

lista de API

Verbos HTTP

La API admite el siguiente subconjunto de verbos HTTP. Ten en cuenta que no todas las funciones admitirán todos los verbos.

Usos de la API

¡Empecemos!

Configuración

Para acceder a las solicitudes restringidas de la API, debe haber un token de sesión configurado. Para establecer un token, debes tener una cuenta válida.

La creación del token de API está disponible en tu Mi perfil menú. Selecciona Tokens de API.

mi perfil

Haz clic en Nuevo token de API.

tokens de api

Escribe el nombre del token; para este tutorial hemos llamado al nuestro «testToken» y luego haz clic en Guardar.

Se ha creado el ID del token.

id del token

Iniciar sesión en la API

En la interfaz de la API, haz clic en el botón Iniciar sesión en la parte superior derecha de la pantalla e introduce tu nombre de usuario y contraseña o proporciona un token de API. Haz clic en Enviar y se enviará una solicitud de inicio de sesión a la API para recuperar un token de sesión válido. Este token se utilizará luego para validar todas las solicitudes de API que desees realizar durante la sesión.

inicio de sesión en api
inicio de sesión en api

Cómo hacer una solicitud a la API

Tomemos el ejemplo del grupo Campaigns; haz clic en él y el grupo se desplegará para mostrar las solicitudes disponibles:

Haz clic en la solicitud que quieras automatizar; en este ejemplo solicitaremos datos para el CID 1923724 usando:

obtener campaña

Haz clic en Obtener campaña lo que despliega la ventana. Introduce el número de ID de la campaña en el campo:

id de campaña

Luego haz clic en el botón Pruébalo ahora El cuerpo de la respuesta generará el código automáticamente.

cuerpo de la respuesta

Un código de respuesta de 200 significa que está bien usarlo.

Cómo pausar una campaña

Aquí tienes otro ejemplo. Primero selecciona la función correcta del grupo Campaigns:

pausar campaña

Haz clic en Pausar para una o más campañas. Una vez abierto, haz clic en el Valor de ejemplo y luego en el recuadro amarillo; esto pegará automáticamente la estructura json en el cuadro del cuerpo.

pausar

Ahora el valor actual es cero, así que cambia el cero por el CID que quieras poner en pausa. Luego haz clic en el botón Probarlo para generar el código necesario.

id de campaña

Cómo actualizar los precios de una campaña

Selecciona la función correcta:

id de campaña

Haz clic en Actualizar una campaña, para abrir la ventana. Añade el CID en el campo de id de campaña y luego haz clic en Valor de ejemplo; haz clic en el recuadro amarillo, que copiará la estructura json en el cuadro del cuerpo.

Este código contiene algunas funciones diferentes, pero queremos el código de precios de la campaña, así que borra la parte del código que no se necesita dejando el código de precios de la campaña en el cuadro, como se muestra abajo:

id de campaña

Ahora necesitamos cambiar dos cosas en el cuadro del cuerpo: el modelo (abajo hay una lista de los valores relacionados con el modelo de precios).

Vamos a quedarnos con CPC, así que dejaremos el modelo en 1

Ahora necesitamos cambiar el precio de cero al precio que queremos. Vamos a cambiarlo a 200, lo que significa que el nuevo precio será de 200 céntimos o dos euros.

id de campaña

Luego simplemente haz clic en el botón Probarlo para generar el código. ¡Fácil!

Como puedes ver, la API está repleta de funciones para automatizar; el único límite es tu imaginación para desbloquear el poder de la automatización.

Por último, asegúrate de suscribirte a nuestro boletín de la API, que encontrarás en la parte inferior de la interfaz de la API, para que puedas recibir las últimas noticias y actualizaciones.

¿Te fue útil?