Campaigns
Campañas de anuncios, creadas y gestionadas con IA.
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).
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.
La campaña ya está en la red y en pausa. Llama a set_ad_network_status con "status": "active" para iniciarla.
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á.