Google Ads

Запрос, аудит и оптимизация кампаний Google Ads. Этот инструмент поддерживает два режима работы: (1) API-режим для массовых операций через Python SDK Google Ads и (2) режим браузерной автоматизации для пользователей без доступа к API — достаточно подключить вкладку ads.google.com. Используется для анализа эффективности рекламы, остановки кампаний и ключевых слов, поиска неэффективных расходов, проверки отслеживания конверсий и оптимизации аккаунтов Google Ads.

Установка

openclaw skill add jdrhyne/google-ads

Техническая спецификация

Google Ads Skill

Управление аккаунтами Google Ads через API или браузерную автоматизацию.

Выбор режима

Перед началом необходимо определить подходящий режим работы:

• API-режим — если настроен файл google-ads.yaml или переменные окружения GOOGLE_ADS_*
• Browser-режим — если нет доступа к API или требуется быстрый анализ

ls ~/.google-ads.yaml 2>/dev/null || ls google-ads.yaml 2>/dev/null

Если конфигурация не найдена, необходимо уточнить: есть ли доступ к API Google Ads или использовать браузерную автоматизацию.

Режим браузерной автоматизации (универсальный)

Требование: пользователь должен быть авторизован в ads.google.com.

Настройка

• Открыть ads.google.com и войти в аккаунт
• Активировать расширение Browser Relay
• Использовать инструмент браузера с профилем Chrome

Основные сценарии

Получение эффективности кампаний

• Перейти в раздел кампаний
• Установить период
• Сделать снимок таблицы
• Извлечь данные: кампания, статус, бюджет, расходы, конверсии, стоимость за конверсию

Поиск ключевых слов без конверсий (слив бюджета)

• Открыть раздел ключевых слов
• Добавить фильтр: конверсии < 1
• Добавить фильтр: расходы > заданного порога
• Отсортировать по расходам
• Проанализировать таблицу

Остановка ключевых слов и кампаний

• Выбрать нужные элементы
• Открыть меню редактирования
• Нажать «Pause»
• Подтвердить действие

Скачивание отчетов

• Перейти в нужный раздел
• Нажать кнопку загрузки
• Выбрать формат (рекомендуется CSV)
• Скачать файл

API-режим (для продвинутых пользователей)

Требования: developer token Google Ads API и OAuth-учетные данные.

Проверка настройки

python -c "from google.ads.googleads.client import GoogleAdsClient; print('OK')"

cat ~/.google-ads.yaml

Пример запроса эффективности кампаний

from google.ads.googleads.client import GoogleAdsClient

client = GoogleAdsClient.load_from_storage()
ga_service = client.get_service("GoogleAdsService")

query = """
 SELECT campaign.name, campaign.status,
 metrics.cost_micros, metrics.conversions,
 metrics.cost_per_conversion
 FROM campaign
 WHERE segments.date DURING LAST_30_DAYS
 ORDER BY metrics.cost_micros DESC
"""