Перейти до змісту

Розділ 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: перевірте логи, може знадобитися повторна авторизація - Див. Усунення неполадок для детальних кроків.

Постачальники мовного AI

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

Підтримувані постачальники:

Постачальник Налаштування
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: чи достатньо свіжі дані конверсій для довіри

Пов'язані розділи