Перейти к содержанию

Глава 17: Интеграции

Аудитория: DevOps, платформенные инженеры

Сервисные аккаунты GCP

Cat-Scan требуются учётные данные сервисного аккаунта GCP для взаимодействия с API Google.

Настройка: 1. Создайте сервисный аккаунт в вашем проекте GCP с доступом к Authorized Buyers API. 2. Скачайте JSON-файл ключа. 3. Загрузите его в /settings/accounts > вкладка API Connection. 4. Проверьте подключение: Cat-Scan протестирует доступность и права.

Что это обеспечивает: - Обнаружение мест (discoverSeats) - Синхронизация конфигурации претаргетинга (syncPretargetingConfigs) - Синхронизация RTB-эндпоинтов (syncRTBEndpoints) - Сбор креативов (collectCreatives)

Статус проекта: Проверьте состояние проекта GCP в /settings/accounts или через GET /integrations/gcp/project-status. Этот эндпоинт подтверждает валидность сервисного аккаунта, доступность проекта и активацию необходимых API.

Google Authorized Buyers API

Cat-Scan синхронизирует данные из Authorized Buyers API:

Операция Какие данные получает Когда запускать
Обнаружение мест Аккаунты байеров, привязанные к сервисному аккаунту Начальная настройка, при добавлении новых мест
Синхронизация претаргетинга Текущее состояние конфигурации претаргетинга из Google После внешних изменений в интерфейсе AB
Синхронизация RTB-эндпоинтов URL-адреса и статусы эндпоинтов биддера Начальная настройка, после изменения эндпоинтов
Синхронизация креативов Метаданные креативов (форматы, размеры, назначения) Периодически, через «Sync All» в боковой панели

Интеграция с Gmail

Google Authorized Buyers отправляет ежедневные CSV-отчёты по электронной почте. Cat-Scan может импортировать их автоматически.

Настройка: 1. Перейдите в /settings/accounts > вкладка Gmail Reports. 2. Авторизуйте Cat-Scan для доступа к Gmail-аккаунту, получающему отчёты AB. 3. Cat-Scan будет опрашивать почту на наличие новых писем с отчётами и импортировать вложенные CSV.

Мониторинг: - GET /gmail/status: текущее состояние, количество непрочитанных, последняя причина - POST /gmail/import/start: ручной запуск цикла импорта - POST /gmail/import/stop: остановка текущего импорта - GET /gmail/import/history: записи прошлых импортов

Устранение неполадок: - Большое количество непрочитанных (30+): бэклог импорта, может потребоваться ручное вмешательство - last_reason: error: проверьте логи, может потребоваться повторная авторизация - См. Устранение неполадок для подробных инструкций.

Провайдеры языкового ИИ

Cat-Scan использует ИИ для определения языка креативов и выявления гео-лингвистических несоответствий (например, испаноязычная реклама на арабском рынке).

Поддерживаемые провайдеры:

Провайдер Настройка
Gemini API-ключ в /settings/accounts
Claude API-ключ в /settings/accounts
Grok API-ключ в /settings/accounts

Настраивается через GET/PUT /integrations/language-ai/config. Достаточно одного активного провайдера.

Вебхуки конверсий

Внешние системы отправляют события конверсий в Cat-Scan через вебхуки.

Уровни безопасности:

Уровень Назначение Настройка
Проверка HMAC Гарантирует подлинность запросов (подписаны общим секретом) Общий секрет настраивается в параметрах вебхука
Ограничение частоты запросов Предотвращает злоупотребления Автоматическое, с настраиваемыми порогами
Мониторинг свежести Оповещает, когда события перестают поступать Настраиваемый интервал устаревания

Мониторинг: - GET /conversions/security/status: статус HMAC, статус ограничения частоты, статус свежести - GET /conversions/health: общее состояние приёма и агрегации - GET /conversions/readiness: достаточно ли свежи данные конверсий для использования

Связанные разделы