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

# Рекламні кампанії

> Підключіть Google Ads та Facebook Ads для аналітики та управління кампаніями

## Огляд

Інтеграції рекламних кампаній надають вашим AI-агентам доступ до рекламних даних. Агенти можуть аналізувати ефективність кампаній, звітувати про метрики, ставити на паузу неефективні кампанії та відповідати на питання про витрати на рекламу — все через природну розмову.

## Підтримувані платформи

| Платформа        | Авторизація  | Інструменти | Можливості                                            |
| ---------------- | ------------ | ----------- | ----------------------------------------------------- |
| **Google Ads**   | Google OAuth | 3           | Кампанії, ключові слова, пауза кампаній               |
| **Facebook Ads** | Meta OAuth   | 4           | Кампанії, набори оголошень, аналітика, пауза кампаній |

## Google Ads

### Автентифікація

Використовує той самий Google OAuth-потік, що й Google Workspace, з додатковими вимогами:

| Поле                | Опис                                                                       |
| ------------------- | -------------------------------------------------------------------------- |
| **OAuth**           | Google-акаунт з доступом до рекламного акаунту                             |
| **Customer ID**     | ID вашого Google Ads акаунту (формат: `123-456-7890`)                      |
| **Developer Token** | Отримується з [Google Ads API Center](https://ads.google.com/aw/apicenter) |

### Налаштування

<Steps>
  <Step title="Додайте інтеграцію">
    Перейдіть в **Інтеграції** → **Додати інтеграцію** → оберіть **Google Ads** з категорії Реклама.
  </Step>

  <Step title="OAuth">
    Натисніть "Connect with Google" та авторизуйте доступ до Google Ads акаунту.
  </Step>

  <Step title="Введіть деталі">
    Введіть Customer ID та Developer Token.
  </Step>

  <Step title="Верифікація">
    Revol тестує підключення, отримуючи ваші кампанії.
  </Step>
</Steps>

### Інструменти агента

| Інструмент       | Опис                                                                                    |
| ---------------- | --------------------------------------------------------------------------------------- |
| `get_campaigns`  | Список кампаній зі статусом, бюджетом, показами, кліками, витратами та конверсіями      |
| `get_keywords`   | Ефективність ключових слів за групами оголошень — покази, кліки, витрати, Quality Score |
| `pause_campaign` | Поставити кампанію на паузу за її ID                                                    |

***

## Facebook Ads

### Автентифікація

Використовує Meta OAuth зі scope `ads_management`. Підтримує рекламні кампанії Facebook та Instagram, керовані через Meta Ads Manager.

| Поле              | Опис                                                  |
| ----------------- | ----------------------------------------------------- |
| **OAuth**         | Meta-акаунт з доступом до рекламного акаунту          |
| **Ad Account ID** | Формат: `act_XXXXXXXXX` (знайдіть у Meta Ads Manager) |

### Налаштування

<Steps>
  <Step title="Додайте інтеграцію">
    Перейдіть в **Інтеграції** → **Додати інтеграцію** → оберіть **Facebook Ads**.
  </Step>

  <Step title="OAuth">
    Натисніть "Connect with Meta" та авторизуйте доступ до рекламного акаунту.
  </Step>

  <Step title="Введіть деталі">
    Введіть Ad Account ID.
  </Step>

  <Step title="Верифікація">
    Revol тестує підключення, отримуючи ваші кампанії.
  </Step>
</Steps>

### Інструменти агента

| Інструмент       | Опис                                                                                          |
| ---------------- | --------------------------------------------------------------------------------------------- |
| `get_campaigns`  | Список кампаній зі статусом, бюджетом та 30-денною ефективністю (покази, кліки, витрати, CTR) |
| `get_ad_sets`    | Список наборів оголошень у кампанії з таргетингом та розкладом                                |
| `get_insights`   | Детальна аналітика ефективності за довільний діапазон дат                                     |
| `pause_campaign` | Поставити кампанію на паузу за її ID                                                          |

## Використання інструментів у workflow-нодах

Інструменти рекламних кампаній працюють як будь-які інші інструменти агента:

1. Підключіть рекламну платформу та верифікуйте через OAuth
2. Інструменти з'являться у вкладці **Tools** агента
3. Додайте їх до **custom node** у workflow-редакторі
4. LLM викликає їх, коли користувач питає про дані кампаній

**Приклад:** Користувач питає "Як справи з нашою рекламою в Google цього тижня?" → агент викликає `get_campaigns` з фільтром за датою та повертає зведення витрат, кліків та конверсій зрозумілою мовою.

## Приклади використання

<AccordionGroup>
  <Accordion title="Звітування про ефективність">
    "Який ROAS у нашій Google-рекламі цього місяця?" → агент викликає `get_campaigns` та обчислює повернення на рекламні витрати з метрик.
  </Accordion>

  <Accordion title="Порівняння платформ">
    Агент отримує дані з Google Ads та Facebook Ads для порівняння вартості за ліда на різних платформах.
  </Accordion>

  <Accordion title="Управління кампаніями">
    "Постав на паузу кампанію Spring Promo у Facebook" → агент викликає `pause_campaign` з ID кампанії.
  </Accordion>

  <Accordion title="Атрибуція джерел лідів">
    Коли лід приходить через віджет на сайті, агент перевіряє UTM-параметри з трекінгової сесії та зіставляє з даними кампаній для визначення, яка реклама привела ліда.
  </Accordion>
</AccordionGroup>