> ## 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.

# Werbekampagnen

> Verbinden Sie Google Ads und Facebook Ads fuer Kampagnenanalyse und -verwaltung

## Ueberblick

Werbekampagnen-Integrationen geben Ihren KI-Agenten Zugriff auf Werbedaten. Agenten koennen die Kampagnen-Performance analysieren, ueber Metriken berichten, leistungsschwache Kampagnen pausieren und Fragen zu Werbeausgaben beantworten — alles ueber natuerliche Konversation.

## Unterstuetzte Plattformen

| Plattform        | Authentifizierung | Tools | Funktionen                                                |
| ---------------- | ----------------- | ----- | --------------------------------------------------------- |
| **Google Ads**   | Google OAuth      | 3     | Kampagnen, Keywords, Kampagnen pausieren                  |
| **Facebook Ads** | Meta OAuth        | 4     | Kampagnen, Anzeigengruppen, Insights, Kampagnen pausieren |

## Google Ads

### Authentifizierung

Verwendet denselben Google OAuth-Flow wie Google Workspace, mit zusaetzlichen Anforderungen:

| Feld                 | Beschreibung                                                                       |
| -------------------- | ---------------------------------------------------------------------------------- |
| **OAuth**            | Google-Konto mit Zugriff auf das Ads-Konto                                         |
| **Kunden-ID**        | Ihre Google Ads-Konto-ID (Format: `123-456-7890`)                                  |
| **Entwickler-Token** | Erhaeltlich ueber das [Google Ads API Center](https://ads.google.com/aw/apicenter) |

### Einrichtung

<Steps>
  <Step title="Integration hinzufuegen">
    Gehen Sie zu **Integrationen** → **Integration hinzufuegen** → waehlen Sie **Google Ads** aus der Kategorie Werbung.
  </Step>

  <Step title="OAuth">
    Klicken Sie auf "Mit Google verbinden" und autorisieren Sie den Zugriff auf Ihr Google Ads-Konto.
  </Step>

  <Step title="Details eingeben">
    Geben Sie Ihre Kunden-ID und Ihr Entwickler-Token ein.
  </Step>

  <Step title="Verifizieren">
    Revol testet die Verbindung, indem es Ihre Kampagnen abruft.
  </Step>
</Steps>

### Agenten-Tools

| Tool             | Beschreibung                                                                                   |
| ---------------- | ---------------------------------------------------------------------------------------------- |
| `get_campaigns`  | Kampagnen mit Status, Budget, Impressionen, Klicks, Kosten und Conversions auflisten           |
| `get_keywords`   | Keyword-Performance-Daten nach Anzeigengruppe — Impressionen, Klicks, Kosten, Qualitaetsfaktor |
| `pause_campaign` | Eine Kampagne anhand ihrer ID pausieren                                                        |

***

## Facebook Ads

### Authentifizierung

Verwendet Meta OAuth mit dem Bereich `ads_management`. Unterstuetzt sowohl Facebook- als auch Instagram-Werbekampagnen, die ueber Meta Ads Manager verwaltet werden.

| Feld              | Beschreibung                                            |
| ----------------- | ------------------------------------------------------- |
| **OAuth**         | Meta-Konto mit Zugriff auf das Werbekonto               |
| **Werbekonto-ID** | Format: `act_XXXXXXXXX` (zu finden im Meta Ads Manager) |

### Einrichtung

<Steps>
  <Step title="Integration hinzufuegen">
    Gehen Sie zu **Integrationen** → **Integration hinzufuegen** → waehlen Sie **Facebook Ads**.
  </Step>

  <Step title="OAuth">
    Klicken Sie auf "Mit Meta verbinden" und autorisieren Sie den Zugriff auf Ihr Werbekonto.
  </Step>

  <Step title="Details eingeben">
    Geben Sie Ihre Werbekonto-ID ein.
  </Step>

  <Step title="Verifizieren">
    Revol testet die Verbindung, indem es Ihre Kampagnen abruft.
  </Step>
</Steps>

### Agenten-Tools

| Tool             | Beschreibung                                                                                         |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| `get_campaigns`  | Kampagnen mit Status, Budget und 30-Tage-Performance auflisten (Impressionen, Klicks, Ausgaben, CTR) |
| `get_ad_sets`    | Anzeigengruppen innerhalb einer Kampagne mit Targeting- und Zeitplanungsinformationen auflisten      |
| `get_insights`   | Detaillierte Performance-Insights nach benutzerdefiniertem Datumsbereich                             |
| `pause_campaign` | Eine Kampagne anhand ihrer ID pausieren                                                              |

## Tools in Workflow-Knoten verwenden

Werbekampagnen-Tools funktionieren wie jedes andere Agenten-Tool:

1. Verbinden Sie die Werbeplattform und verifizieren Sie per OAuth
2. Die Tools erscheinen im **Tools**-Tab des Agenten
3. Fuegen Sie sie zu **benutzerdefinierten Knoten** im Workflow-Editor hinzu
4. Das LLM ruft sie auf, wenn der Benutzer nach Kampagnendaten fragt

**Beispiel:** Ein Benutzer fragt "Wie laufen unsere Google Ads diese Woche?" → der Agent ruft `get_campaigns` mit einem Datumsfilter auf und liefert eine Zusammenfassung von Ausgaben, Klicks und Conversions in Klartext.

## Anwendungsfaelle

<AccordionGroup>
  <Accordion title="Performance-Reporting">
    "Was ist unser ROAS bei Google Ads diesen Monat?" → Agent ruft `get_campaigns` auf und berechnet den Return on Ad Spend aus den Metriken.
  </Accordion>

  <Accordion title="Plattformuebergreifender Vergleich">
    Agent ruft Daten sowohl von Google Ads als auch von Facebook Ads ab, um die Kosten pro Lead plattformuebergreifend zu vergleichen.
  </Accordion>

  <Accordion title="Kampagnenverwaltung">
    "Pausiere die Fruehlingsaktions-Kampagne auf Facebook" → Agent ruft `pause_campaign` mit der Kampagnen-ID auf.
  </Accordion>

  <Accordion title="Lead-Quellen-Zuordnung">
    Wenn ein Lead ueber das Website-Widget kommt, prueft der Agent die UTM-Parameter aus der Tracking-Sitzung und korreliert sie mit Kampagnendaten, um zu identifizieren, welche Anzeige den Lead generiert hat.
  </Accordion>
</AccordionGroup>