PluggzyDocs

Anuncios

Tus cuentas publicitarias de nueve redes, en cualquier app de IA. Pregunta cómo les fue a tus anuncios, qué campaña desperdicia dinero, o pide promocionar una publicación: tu app de IA encuentra la operación, lee las cifras y hace el cambio. Todo lo que puede gastar dinero espera tu aprobación.

9redes publicitarias, cada una con su propio inicio de sesión
3herramientas, las mismas en cada red
336operaciones, de campañas a métricas
Tu aprobaciónantes de todo lo que gaste o dé acceso

Cuentas publicitarias

Una cuenta publicitaria es una cuenta conectada como cualquier otra, pensada para anuncios.

Qué esTu cuenta publicitaria en una red, conectada a Pluggzy. Meta Ads cubre tus anuncios de Facebook e Instagram. Tu app de IA lee sus campañas y cifras, y las cambia cuando se lo pides.
En tu planUna cuenta conectada, como cualquier otra. Un inicio de sesión de Meta Ads que da acceso a varias cuentas publicitarias cuenta una sola vez.
Gasto publicitarioLo factura cada red a tu propia cuenta publicitaria. Pluggzy no paga los anuncios.
Su propia claveCada cuenta publicitaria recibe una clave de acceso que llega a esa cuenta y a ninguna otra.
Solo anunciosSin mensajes ni mensajes directos: una cuenta publicitaria gestiona anuncios. Los chats siguen en los canales de mensajería.

Conectar

El inicio de sesión propio de cada red, desde tu panel de Pluggzy. ChatGPT Ads usa una clave de API en su lugar.

RedInicio de sesión conEstructura
Meta AdsAnuncios de Facebook e InstagramInicio de sesiónFacebook Login for BusinessEstructuraCampaña › Conjunto de anuncios › Anuncio
Google AdsInicio de sesiónInicio de sesión de GoogleEstructuraCampaña › Grupo de anuncios › Anuncio
LinkedIn AdsInicio de sesiónInicio de sesión de LinkedInEstructuraGrupo de campañas › Campaña › Creatividad
TikTok AdsInicio de sesiónInicio de sesión de TikTokEstructuraCampaña › Grupo de anuncios › Anuncio
Pinterest AdsInicio de sesiónInicio de sesión de PinterestEstructuraCampaña › Grupo de anuncios › Pin promocionado
X AdsInicio de sesiónDos inicios de sesión: tu cuenta de X y luego sus anunciosEstructuraCampaña › Line item › Publicación promocionada
Reddit AdsInicio de sesiónInicio de sesión de RedditEstructuraCampaña › Grupo de anuncios › Anuncio
Microsoft AdsCampañas de búsquedaInicio de sesiónInicio de sesión de MicrosoftEstructuraCampaña › Grupo de anuncios › Anuncio
ChatGPT AdsInicio de sesiónUna clave de API de ChatGPT Ads Manager (Settings), pegada en la página de conexión de PluggzyEstructuraCampaña › Grupo de anuncios › Tarjeta de chat
  • Pega la clave de ChatGPT Ads en la página de conexión de Pluggzy, nunca en un chat.
  • X Ads lo pide dos veces: primero tu cuenta de X, luego el acceso a sus anuncios.

Tres herramientas

Las mismas tres en cada red. Tu app de IA elige la correcta; tú solo pides.

ads_operationsLecturaPrimero, para saber qué puede hacer: 336 operaciones sobre campañas, conjuntos de anuncios, anuncios, presupuestos, promociones, pujas, segmentación, audiencias, conversiones, creatividades, catálogos de productos, formularios de clientes potenciales, reglas, automatizaciones y métricas, cada una con sus parámetros.query: "pause campaign"groupoperation
ads_readLecturaPara consultar: gasto, resultados, métricas diarias, el árbol de campañas, mejores anuncios, alertas, audiencias, clientes potenciales, vistas previas y estimaciones de alcance. No cambia nada.get_ads_timelineget_ad_treelist_ads_alerts
ads_writeEscrituraPara cambiar: crear campañas, conjuntos de anuncios y anuncios, promocionar una publicación, pausar y reactivar, presupuestos, pujas, segmentación, audiencias, eliminaciones. Todo lo que puede gastar o dar acceso espera tu aprobación.boost_postupdate_ad_campaign_statusupdate_ad_set

Nada se gasta sin tu aprobación.

Integrado en las herramientas, en cada red y en cada app de IA.

Gasto o accesoTu aprobación
Todo lo que puede gastar dinero o dar acceso a alguien solo se ejecuta después de que digas que sí en el chat. Entonces tu app de IA envía user_confirmed: true.
PausarSiempre
Pausar nunca necesita aprobación. Detener el gasto siempre está permitido, en cada red.
Anuncios nuevosEn pausa
Tu app de IA tiene instrucciones de crear los anuncios nuevos en pausa, salvo que pidas lanzarlos.

Cuando falta la aprobación

Nada se ejecuta ni se reintenta a tus espaldas: la herramienta responde con un código que tu app de IA entiende.

confirmation_requiredPuede gastar dinero o dar acceso. Tu app de IA te dice qué se va a ejecutar y vuelve a llamar cuando estés de acuerdo.
unsupportedEsa operación no existe en esta red, como promocionar en Microsoft Ads.
invalid_requestLa red rechazó un valor; fields dice cuál.
rate_limitedLa propia red pidió ir más despacio. retry_after_seconds es exactamente la espera que pidió.
Ejemplo de rechazo
isError
{
  "error": "boost_post can spend money or grant access. Tell the user exactly what it will do, then call again with user_confirmed: true once they agree.",
  "code": "confirmation_required"
}

Límites

Pluggzy no añade límites propios a una cuenta publicitaria: ni límite diario, ni por minuto, ni separación. Un cambio sale en cuanto tu app de IA lo pide. Solo se aplican los límites de uso de cada red.

AcciónLímite propio de PluggzyHerramientas
Lecturasgasto, resultados, métricas, clientes potencialesNingunose aplican los límites de uso de la redads_read
Cambios con gastoanuncios nuevos, promociones, presupuestos, pujas, reactivacionesNingunose aplican los límites de uso de la redads_write
Otros cambiospausas, audiencias, creatividades, palabras clave, conversionesNingunose aplican los límites de uso de la redads_write
Eliminacionescampañas, conjuntos de anuncios, anuncios, audienciasNingunose aplican los límites de uso de la redads_write
LecturasNinguno
gasto, resultados, métricas, clientes potenciales
se aplican los límites de uso de la red
ads_read
Cambios con gastoNinguno
anuncios nuevos, promociones, presupuestos, pujas, reactivaciones
se aplican los límites de uso de la red
ads_write
Otros cambiosNinguno
pausas, audiencias, creatividades, palabras clave, conversiones
se aplican los límites de uso de la red
ads_write
EliminacionesNinguno
campañas, conjuntos de anuncios, anuncios, audiencias
se aplican los límites de uso de la red
ads_write
  • Cuando una red pide ir más despacio, Pluggzy espera exactamente el tiempo que pide, al segundo, y responde rate_limited con retry_after_seconds. Tu app de IA vuelve a llamar después. Nada se pone en cola a tus espaldas.
  • Tu aprobación sigue siendo lo primero: todo lo que puede gastar dinero o dar acceso la espera en el chat.
  • Pausar se considera un cambio, nunca un gasto: nunca espera aprobación.

Dinero y cifras

Qué son los números que lee tu app de IA y de dónde vienen.

En la moneda de tu cuenta.

El gasto, los presupuestos, el costo por resultado y el valor de compra vienen en la moneda de la cuenta publicitaria.

De la propia red.

Las cifras son las que reporta cada red: gasto, impresiones, alcance, clics, conversiones y demás.

90 días de Meta al conectar.

Meta Ads trae los últimos 90 días cuando se conecta una cuenta. El historial más antiguo se completa después.

Recortado si hace falta, y lo dice.

Una respuesta muy larga vuelve recortada con truncated: true. Acótala: fechas, un límite, una campaña.

Cómo pregunta tu IA

No tienes que nombrar operaciones. Pregunta como le preguntarías a un colega; tu app de IA lo convierte en llamadas.

“¿Cómo les fue a mis anuncios de Meta esta semana comparado con la anterior?”ads_read({ operation: "get_ads_timeline", params: { compare: true } })
El gasto y los resultados diarios de la semana, junto a la semana anterior, en la moneda de la cuenta.
“¿Qué campaña de Google Ads tiene el peor costo por conversión? Páusala.”ads_write({ operation: "update_ad_campaign_status", body: { status: "paused" } })
Primero lee las campañas y luego pausa la peor. Pausar no necesita aprobación.
“Promociona mi última publicación de Instagram con 10 € al día durante 5 días para personas en España de 25 a 40 años.”ads_write({ operation: "boost_post", …, user_confirmed: true })
Tu app de IA indica el presupuesto, las fechas y la audiencia, espera tu aprobación y luego la crea en pausa o activa, como hayas dicho.
“Sube un 20 % el presupuesto de mi mejor grupo de anuncios de TikTok.”ads_write({ operation: "update_ad_set", …, user_confirmed: true })
Subir un presupuesto puede gastar más, así que primero pregunta.
“Muéstrame los clientes potenciales de mi formulario de LinkedIn de este mes.”ads_read({ operation: "list_leads", … })
Los clientes potenciales que recogió tu formulario, solo lectura.
“¿Cuál de mis anuncios tiene una alerta o fue rechazado?”ads_read({ operation: "list_ads_alerts" })
Los anuncios que necesitan atención, en toda la cuenta.
Cada entrada y salidaads_operations, ads_read y ads_write, con sus rechazos, en la referencia.
Herramientas de anuncios
Generado desde pluggzy.com/api/docs · 42 herramientas¿Algo no está claro? Escribe a soporte · Estado del servicio