> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Campañas Publicitarias

> Conecte Google Ads y Facebook Ads para analíticas y gestión de campañas

## Descripción General

Las integraciones de campañas publicitarias dan a sus agentes de IA acceso a datos publicitarios. Los agentes pueden analizar el rendimiento de campañas, informar sobre métricas, pausar campañas de bajo rendimiento y responder preguntas sobre la inversión publicitaria — todo mediante conversación natural.

## Plataformas Compatibles

| Plataforma       | Autenticación | Herramientas | Capacidades                                                |
| ---------------- | ------------- | ------------ | ---------------------------------------------------------- |
| **Google Ads**   | Google OAuth  | 3            | Campañas, palabras clave, pausar campañas                  |
| **Facebook Ads** | Meta OAuth    | 4            | Campañas, conjuntos de anuncios, insights, pausar campañas |

## Google Ads

### Autenticación

Usa el mismo flujo Google OAuth que Google Workspace, con requisitos adicionales:

| Campo               | Descripción                                                                     |
| ------------------- | ------------------------------------------------------------------------------- |
| **OAuth**           | Cuenta de Google con acceso a la cuenta de Ads                                  |
| **Customer ID**     | Su ID de cuenta de Google Ads (formato: `123-456-7890`)                         |
| **Developer Token** | Obtenido del [Centro de API de Google Ads](https://ads.google.com/aw/apicenter) |

### Configuración

<Steps>
  <Step title="Agregar Integración">
    Vaya a **Integraciones** → **Agregar Integración** → seleccione **Google Ads** de la categoría Publicidad.
  </Step>

  <Step title="OAuth">
    Haga clic en "Conectar con Google" y autorice el acceso a su cuenta de Google Ads.
  </Step>

  <Step title="Ingresar Detalles">
    Ingrese su Customer ID y Developer Token.
  </Step>

  <Step title="Verificar">
    Revol prueba la conexión obteniendo sus campañas.
  </Step>
</Steps>

### Herramientas del Agente

| Herramienta      | Descripción                                                                                                     |
| ---------------- | --------------------------------------------------------------------------------------------------------------- |
| `get_campaigns`  | Listar campañas con estado, presupuesto, impresiones, clics, costo y conversiones                               |
| `get_keywords`   | Datos de rendimiento de palabras clave por grupo de anuncios — impresiones, clics, costo, puntuación de calidad |
| `pause_campaign` | Pausar una campaña por su ID                                                                                    |

***

## Facebook Ads

### Autenticación

Usa Meta OAuth con el alcance `ads_management`. Soporta campañas publicitarias tanto de Facebook como de Instagram gestionadas a través de Meta Ads Manager.

| Campo             | Descripción                                                 |
| ----------------- | ----------------------------------------------------------- |
| **OAuth**         | Cuenta Meta con acceso a la cuenta publicitaria             |
| **Ad Account ID** | Formato: `act_XXXXXXXXX` (se encuentra en Meta Ads Manager) |

### Configuración

<Steps>
  <Step title="Agregar Integración">
    Vaya a **Integraciones** → **Agregar Integración** → seleccione **Facebook Ads**.
  </Step>

  <Step title="OAuth">
    Haga clic en "Conectar con Meta" y autorice el acceso a su cuenta publicitaria.
  </Step>

  <Step title="Ingresar Detalles">
    Ingrese su Ad Account ID.
  </Step>

  <Step title="Verificar">
    Revol prueba la conexión obteniendo sus campañas.
  </Step>
</Steps>

### Herramientas del Agente

| Herramienta      | Descripción                                                                                       |
| ---------------- | ------------------------------------------------------------------------------------------------- |
| `get_campaigns`  | Listar campañas con estado, presupuesto y rendimiento de 30 días (impresiones, clics, gasto, CTR) |
| `get_ad_sets`    | Listar conjuntos de anuncios dentro de una campaña con información de segmentación y programación |
| `get_insights`   | Insights de rendimiento detallados por rango de fechas personalizado                              |
| `pause_campaign` | Pausar una campaña por su ID                                                                      |

## Uso de Herramientas en Nodos del Workflow

Las herramientas de campañas publicitarias funcionan como cualquier otra herramienta del agente:

1. Conecte la plataforma publicitaria y verifique vía OAuth
2. Las herramientas aparecen en la pestaña **Herramientas** del agente
3. Agréguelas a los **nodos personalizados** en el editor de workflow
4. El LLM las invoca cuando el usuario pregunta sobre datos de campañas

**Ejemplo:** Un usuario pregunta "¿Cómo van nuestras campañas de Google Ads esta semana?" → el agente invoca `get_campaigns` con un filtro de fecha y devuelve un resumen de gasto, clics y conversiones en lenguaje natural.

## Casos de Uso

<AccordionGroup>
  <Accordion title="Informes de rendimiento">
    "¿Cuál es nuestro ROAS en Google Ads este mes?" → el agente invoca `get_campaigns` y calcula el retorno de la inversión publicitaria a partir de las métricas.
  </Accordion>

  <Accordion title="Comparación multiplataforma">
    El agente obtiene datos tanto de Google Ads como de Facebook Ads para comparar el costo por lead entre plataformas.
  </Accordion>

  <Accordion title="Gestión de campañas">
    "Pausa la campaña Promo Primavera en Facebook" → el agente invoca `pause_campaign` con el ID de la campaña.
  </Accordion>

  <Accordion title="Atribución de fuente de leads">
    Cuando un lead llega a través del widget del sitio web, el agente verifica los parámetros UTM de la sesión de seguimiento y los correlaciona con datos de campaña para identificar qué anuncio generó el lead.
  </Accordion>
</AccordionGroup>