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

# Kampanie reklamowe

> Połącz Google Ads i Facebook Ads, aby analizować i zarządzać kampaniami

## Przegląd

Integracje kampanii reklamowych dają Twoim agentom AI dostęp do danych reklamowych. Agenci mogą analizować wydajność kampanii, raportować metryki, wstrzymywać słabo działające kampanie i odpowiadać na pytania o wydatki na reklamy — wszystko w naturalnej rozmowie.

## Obsługiwane platformy

| Platforma        | Autoryzacja  | Narzędzia | Możliwości                                                   |
| ---------------- | ------------ | --------- | ------------------------------------------------------------ |
| **Google Ads**   | Google OAuth | 3         | Kampanie, słowa kluczowe, wstrzymywanie kampanii             |
| **Facebook Ads** | Meta OAuth   | 4         | Kampanie, zestawy reklam, statystyki, wstrzymywanie kampanii |

## Google Ads

### Uwierzytelnianie

Używa tego samego przepływu Google OAuth co Google Workspace, z dodatkowymi wymaganiami:

| Pole                | Opis                                                                    |
| ------------------- | ----------------------------------------------------------------------- |
| **OAuth**           | Konto Google z dostępem do konta Ads                                    |
| **Customer ID**     | ID Twojego konta Google Ads (format: `123-456-7890`)                    |
| **Developer Token** | Uzyskany z [Google Ads API Center](https://ads.google.com/aw/apicenter) |

### Konfiguracja

<Steps>
  <Step title="Dodaj integrację">
    Przejdź do **Integracje** → **Dodaj integrację** → wybierz **Google Ads** z kategorii Reklama.
  </Step>

  <Step title="OAuth">
    Kliknij „Połącz z Google" i autoryzuj dostęp do swojego konta Google Ads.
  </Step>

  <Step title="Wprowadź szczegóły">
    Wprowadź swój Customer ID i Developer Token.
  </Step>

  <Step title="Zweryfikuj">
    Revol testuje połączenie, pobierając Twoje kampanie.
  </Step>
</Steps>

### Narzędzia agenta

| Narzędzie        | Opis                                                                                                   |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| `get_campaigns`  | Lista kampanii ze statusem, budżetem, wyświetleniami, kliknięciami, kosztem i konwersjami              |
| `get_keywords`   | Dane o wydajności słów kluczowych według grupy reklam — wyświetlenia, kliknięcia, koszt, wynik jakości |
| `pause_campaign` | Wstrzymaj kampanię po jej ID                                                                           |

***

## Facebook Ads

### Uwierzytelnianie

Używa Meta OAuth z zakresem `ads_management`. Obsługuje kampanie reklamowe Facebook i Instagram zarządzane przez Meta Ads Manager.

| Pole              | Opis                                                      |
| ----------------- | --------------------------------------------------------- |
| **OAuth**         | Konto Meta z dostępem do konta reklamowego                |
| **Ad Account ID** | Format: `act_XXXXXXXXX` (znajduje się w Meta Ads Manager) |

### Konfiguracja

<Steps>
  <Step title="Dodaj integrację">
    Przejdź do **Integracje** → **Dodaj integrację** → wybierz **Facebook Ads**.
  </Step>

  <Step title="OAuth">
    Kliknij „Połącz z Meta" i autoryzuj dostęp do swojego konta reklamowego.
  </Step>

  <Step title="Wprowadź szczegóły">
    Wprowadź swój Ad Account ID.
  </Step>

  <Step title="Zweryfikuj">
    Revol testuje połączenie, pobierając Twoje kampanie.
  </Step>
</Steps>

### Narzędzia agenta

| Narzędzie        | Opis                                                                                                  |
| ---------------- | ----------------------------------------------------------------------------------------------------- |
| `get_campaigns`  | Lista kampanii ze statusem, budżetem i 30-dniową wydajnością (wyświetlenia, kliknięcia, wydatki, CTR) |
| `get_ad_sets`    | Lista zestawów reklam w kampanii z informacjami o targetowaniu i harmonogramie                        |
| `get_insights`   | Szczegółowe statystyki wydajności za niestandardowy zakres dat                                        |
| `pause_campaign` | Wstrzymaj kampanię po jej ID                                                                          |

## Używanie narzędzi w węzłach workflow

Narzędzia kampanii reklamowych działają jak każde inne narzędzie agenta:

1. Połącz platformę reklamową i zweryfikuj przez OAuth
2. Narzędzia pojawią się w zakładce **Narzędzia** agenta
3. Dodaj je do **węzłów niestandardowych** w edytorze workflow
4. LLM wywołuje je, gdy użytkownik pyta o dane kampanii

**Przykład:** Użytkownik pyta „Jak idą nasze Google Ads w tym tygodniu?" → agent wywołuje `get_campaigns` z filtrem daty i zwraca podsumowanie wydatków, kliknięć i konwersji w zrozumiałym języku.

## Przypadki użycia

<AccordionGroup>
  <Accordion title="Raportowanie wydajności">
    „Jaki jest nasz ROAS w Google Ads w tym miesiącu?" → agent wywołuje `get_campaigns` i oblicza zwrot z wydatków na reklamę na podstawie metryk.
  </Accordion>

  <Accordion title="Porównanie między platformami">
    Agent pobiera dane zarówno z Google Ads, jak i Facebook Ads, aby porównać koszt pozyskania leada na różnych platformach.
  </Accordion>

  <Accordion title="Zarządzanie kampaniami">
    „Wstrzymaj kampanię Spring Promo na Facebooku" → agent wywołuje `pause_campaign` z ID kampanii.
  </Accordion>

  <Accordion title="Atrybucja źródła leadów">
    Gdy lead przychodzi przez widget na stronie, agent sprawdza parametry UTM z sesji śledzenia i koreluje je z danymi kampanii, aby zidentyfikować, która reklama wygenerowała leada.
  </Accordion>
</AccordionGroup>