Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://revolai.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

PlatformaAutoryzacjaNarzędziaMożliwości
Google AdsGoogle OAuth3Kampanie, słowa kluczowe, wstrzymywanie kampanii
Facebook AdsMeta OAuth4Kampanie, zestawy reklam, statystyki, wstrzymywanie kampanii

Uwierzytelnianie

Używa tego samego przepływu Google OAuth co Google Workspace, z dodatkowymi wymaganiami:
PoleOpis
OAuthKonto Google z dostępem do konta Ads
Customer IDID Twojego konta Google Ads (format: 123-456-7890)
Developer TokenUzyskany z Google Ads API Center

Konfiguracja

1

Dodaj integrację

Przejdź do IntegracjeDodaj integrację → wybierz Google Ads z kategorii Reklama.
2

OAuth

Kliknij „Połącz z Google” i autoryzuj dostęp do swojego konta Google Ads.
3

Wprowadź szczegóły

Wprowadź swój Customer ID i Developer Token.
4

Zweryfikuj

Revol testuje połączenie, pobierając Twoje kampanie.

Narzędzia agenta

NarzędzieOpis
get_campaignsLista kampanii ze statusem, budżetem, wyświetleniami, kliknięciami, kosztem i konwersjami
get_keywordsDane o wydajności słów kluczowych według grupy reklam — wyświetlenia, kliknięcia, koszt, wynik jakości
pause_campaignWstrzymaj 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.
PoleOpis
OAuthKonto Meta z dostępem do konta reklamowego
Ad Account IDFormat: act_XXXXXXXXX (znajduje się w Meta Ads Manager)

Konfiguracja

1

Dodaj integrację

Przejdź do IntegracjeDodaj integrację → wybierz Facebook Ads.
2

OAuth

Kliknij „Połącz z Meta” i autoryzuj dostęp do swojego konta reklamowego.
3

Wprowadź szczegóły

Wprowadź swój Ad Account ID.
4

Zweryfikuj

Revol testuje połączenie, pobierając Twoje kampanie.

Narzędzia agenta

NarzędzieOpis
get_campaignsLista kampanii ze statusem, budżetem i 30-dniową wydajnością (wyświetlenia, kliknięcia, wydatki, CTR)
get_ad_setsLista zestawów reklam w kampanii z informacjami o targetowaniu i harmonogramie
get_insightsSzczegółowe statystyki wydajności za niestandardowy zakres dat
pause_campaignWstrzymaj 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

„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.
Agent pobiera dane zarówno z Google Ads, jak i Facebook Ads, aby porównać koszt pozyskania leada na różnych platformach.
„Wstrzymaj kampanię Spring Promo na Facebooku” → agent wywołuje pause_campaign z ID kampanii.
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.