Saltar al contenido

Campaigns

Campañas de anuncios, creadas y gestionadas con IA.

Abrir Campaigns
Comprobado con el panel el 18 de noviembre de 2026

Siete métodos están abiertos a una clave de API de la cuenta. Funcionan sobre una campaña que ya existe: creas y pagas una campaña en el dashboard, donde están la tarjeta y los términos, y desde código puedes redactar su texto, enviarla a sus redes, pausarla o reanudarla y leer cómo va. Crear una campaña y pagarla no está disponible hoy desde código.

Cada llamada es un POST a https://xuda.ai/cpi/<method> con tu clave y un objeto data. Las respuestas vuelven como { "code": 1, "data": ... }; un code negativo es un rechazo, con el motivo en data.

De un resumen a una campaña en marcha

Encuentra tus campañas

get_account_advertising lista las campañas de tu cuenta. Cada una tiene un id: ese es el app_id que toman los demás métodos.

Mira qué redes están activas

get_advertise_platforms devuelve cada red y su estado, pendiente, en proceso o activa. Las credenciales nunca forman parte de la respuesta.

Escribe o reescribe el texto

generate_ad_creative redacta un titular, un texto principal, una descripción y un botón para una campaña y una red, con el tono que elijas: Professional, Friendly, Bold, Playful, Urgent o Luxury (Friendly si lo omites). Funciona con tus créditos de IA. Cuando no quedan, o no se puede leer la página, recibes en su lugar un borrador genérico y la respuesta indica cuál de los dos casos es. Google Ads tiene su propia plantilla; las demás redes comparten una plantilla de feed.

Envíala a una red

launch_ad_campaign crea la campaña en una red, siempre en pausa. slug es google-ads o meta; sin él es google-ads, y cualquier otro valor se rechaza. Una segunda llamada para la misma red actualiza la campaña que ya está, así que es seguro repetirla. En Google, una cuenta sin cuenta de cliente de Google Ads recibe una creada bajo la cuenta de administrador de Xuda la primera vez.

Actívala o desactívala

set_ad_network_status pausa o reanuda las campañas en vivo de cada red a la que se envió la campaña. Es lo que hace el interruptor Activa del dashboard para las redes. Pasa status como active o paused.

Lee cómo va

get_ad_campaign_report obtiene las cifras diarias de cada red a la que se envió la campaña, de los últimos 1 a 30 días (14 si lo omites).

Solo Google Ads y Meta Ads están conectadas

Una campaña se ejecuta en Google Ads, Meta Ads o ambas. Las demás redes que lista el creador están marcadas como próximamente y no se puede lanzar en ellas.

curl -s https://xuda.ai/cpi/launch_ad_campaign \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","data":{"app_id":"YOUR_CAMPAIGN_APP_ID","slug":"google-ads"}}'
const res = await fetch('https://xuda.ai/cpi/launch_ad_campaign', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    data: { app_id: 'YOUR_CAMPAIGN_APP_ID', slug: 'google-ads' },
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/launch_ad_campaign',
    json={'api_key': 'YOUR_API_KEY', 'data': {'app_id': 'YOUR_CAMPAIGN_APP_ID', 'slug': 'google-ads'}},
)

La campaña ya está en la red y en pausa. Llama a set_ad_network_status con "status": "active" para iniciarla.

curl -s https://xuda.ai/cpi/get_ad_campaign_report \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","data":{"app_id":"YOUR_CAMPAIGN_APP_ID","days":7}}'
const res = await fetch('https://xuda.ai/cpi/get_ad_campaign_report', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', data: { app_id: 'YOUR_CAMPAIGN_APP_ID', days: 7 } }),
});
const { data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_ad_campaign_report',
    json={'api_key': 'YOUR_API_KEY', 'data': {'app_id': 'YOUR_CAMPAIGN_APP_ID', 'days': 7}},
)

Estas son las cifras que dibuja el Resumen, y son solo las de tu propia campaña: una llamada para una campaña que no es tuya se rechaza.

Métodos

get_account_advertising, que lista las campañas de la cuenta, pertenece al microservicio Account. Consulta Sitios web estáticos para ver la tabla de Account junto a la que está.

¿Qué te parece esta guía?

Última actualización: 16 de noviembre de 2026