Google Ads
Запрос кампаний, групп объявлений и метрик производительности
Google Ads — это рекламная платформа Google, которая позволяет бизнесам создавать объявления для привлечения клиентов через Google Поиск, YouTube, Gmail и миллионы партнёрских сайтов. Она поддерживает типы кампаний, включая Поисковые, Дисплейные, Видео, Покупки и Performance Max, с детальным таргетингом, стратегиями ставок и аналитикой производительности.
В AACFlow интеграция с Google Ads позволяет вашим агентам запрашивать данные кампаний, отслеживать производительность групп объявлений и получать детальные метрики с использованием Google Ads Запрос Language (GAQL). Это поддерживает такие сценарии использования, как автоматизированная отчётность по производительности, мониторинг бюджета, проверки состояния кампаний и рабочие процессы оптимизации на основе данных. Подключая AACFlow к Google Ads, ваши агенты могут получать данные рекламы в реальном времени и действовать на основе инсайтов без ручной навигации по панелям управления.
Подключитесь к Google Ads для просмотра доступных аккаунтов, списка кампаний, деталей групп объявлений, получения метрик производительности и выполнения пользовательских GAQL-запросов.
Показать все аккаунты клиентов Google Ads, доступные аутентифицированному пользователю
| Параметр | Тип | Обязательный | Описание |
|---|
developerToken | string | Да | Токен разработчика Google Ads API |
| Параметр | Тип | Описание |
|---|
customerIds | array | Список доступных ID клиентов |
totalCount | number | Общее количество доступных аккаунтов клиентов |
Выполнить пользовательский запрос на языке Google Ads Запрос Language (GAQL)
| Параметр | Тип | Обязательный | Описание |
|---|
customerId | string | Да | ID клиента Google Ads (числовой, без дефисов) |
developerToken | string | Да | Токен разработчика Google Ads API |
managerCustomerId | string | Нет | ID клиента менеджерского аккаунта (если доступ через менеджерский аккаунт) |
query | string | Да | GAQL-запрос для выполнения |
pageToken | string | Нет | Токен страницы для пагинации |
| Параметр | Тип | Описание |
|---|
results | json | Массив объектов результатов из GAQL-запроса |
totalResultsCount | number | Общее количество соответствующих результатов |
nextPageToken | string | Токен для следующей страницы результатов |
Показать кампании в аккаунте Google Ads с опциональной фильтрацией по статусу
| Параметр | Тип | Обязательный | Описание |
|---|
customerId | string | Да | ID клиента Google Ads (числовой, без дефисов) |
developerToken | string | Да | Токен разработчика Google Ads API |
managerCustomerId | string | Нет | ID клиента менеджерского аккаунта (если доступ через менеджерский аккаунт) |
status | string | Нет | Фильтр по статусу кампании (ENABLED, PAUSED, REMOVED) |
limit | number | Нет | Максимальное количество возвращаемых кампаний |
| Параметр | Тип | Описание |
|---|
campaigns | array | Список кампаний в аккаунте |
↳ id | string | ID кампании |
↳ name | string | Название кампании |
↳ status | string | Статус кампании (ENABLED, PAUSED, REMOVED) |
↳ channelType | string | Тип рекламного канала (SEARCH, DISPLAY, SHOPPING, VIDEO, PERFORMANCE_MAX) |
↳ startDate | string | Дата начала кампании (YYYY-MM-DD) |
↳ endDate | string | Дата окончания кампании (YYYY-MM-DD) |
↳ budgetAmountMicros | string | Дневной бюджет в микроединицах (разделить на 1,000,000 для получения валютного значения) |
totalCount | number | Общее количество возвращённых кампаний |
Получить метрики производительности для кампаний Google Ads за определённый период
| Параметр | Тип | Обязательный | Описание |
|---|
customerId | string | Да | ID клиента Google Ads (числовой, без дефисов) |
developerToken | string | Да | Токен разработчика Google Ads API |
managerCustomerId | string | Нет | ID клиента менеджерского аккаунта (если доступ через менеджерский аккаунт) |
campaignId | string | Нет | Фильтр по конкретному ID кампании |
dateRange | string | Нет | Предопределённый период времени (LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH, TODAY, YESTERDAY) |
startDate | string | Нет | Пользовательская дата начала в формате YYYY-MM-DD |
endDate | string | Нет | Пользовательская дата окончания в формате YYYY-MM-DD |
| Параметр | Тип | Описание |
|---|
campaigns | array | Данные производительности кампаний с разбивкой по датам |
↳ id | string | ID кампании |
↳ name | string | Название кампании |
↳ status | string | Статус кампании |
↳ impressions | string | Количество показов |
↳ clicks | string | Количество кликов |
↳ costMicros | string | Стоимость в микроединицах (разделить на 1,000,000 для получения валютного значения) |
↳ ctr | number | CTR (click-through rate) от 0.0 до 1.0 |
↳ conversions | number | Количество конверсий |
↳ date | string | Дата для этой строки (YYYY-MM-DD) |
totalCount | number | Общее количество строк результатов |
Показать группы объявлений в кампании Google Ads
| Параметр | Тип | Обязательный | Описание |
|---|
customerId | string | Да | ID клиента Google Ads (числовой, без дефисов) |
developerToken | string | Да | Токен разработчика Google Ads API |
managerCustomerId | string | Нет | ID клиента менеджерского аккаунта (если доступ через менеджерский аккаунт) |
campaignId | string | Да | ID кампании для показа групп объявлений |
status | string | Нет | Фильтр по статусу группы объявлений (ENABLED, PAUSED, REMOVED) |
limit | number | Нет | Максимальное количество возвращаемых групп объявлений |
| Параметр | Тип | Описание |
|---|
adGroups | array | Список групп объявлений в кампании |
↳ id | string | ID группы объявлений |
↳ name | string | Название группы объявлений |
↳ status | string | Статус группы объявлений (ENABLED, PAUSED, REMOVED) |
↳ type | string | Тип группы объявлений (SEARCH_STANDARD, DISPLAY_STANDARD, SHOPPING_PRODUCT_ADS) |
↳ campaignId | string | ID родительской кампании |
↳ campaignName | string | Название родительской кампании |
totalCount | number | Общее количество возвращённых групп объявлений |
Получить метрики производительности для отдельных объявлений за определённый период
| Параметр | Тип | Обязательный | Описание |
|---|
customerId | string | Да | ID клиента Google Ads (числовой, без дефисов) |
developerToken | string | Да | Токен разработчика Google Ads API |
managerCustomerId | string | Нет | ID клиента менеджерского аккаунта (если доступ через менеджерский аккаунт) |
campaignId | string | Нет | Фильтр по ID кампании |
adGroupId | string | Нет | Фильтр по ID группы объявлений |
dateRange | string | Нет | Предопределённый период времени (LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH, TODAY, YESTERDAY) |
startDate | string | Нет | Пользовательская дата начала в формате YYYY-MM-DD |
endDate | string | Нет | Пользовательская дата окончания в формате YYYY-MM-DD |
limit | number | Нет | Максимальное количество возвращаемых результатов |
| Параметр | Тип | Описание |
|---|
ads | array | Данные производительности объявлений с разбивкой по датам |
↳ adId | string | ID объявления |
↳ adGroupId | string | ID родительской группы объявлений |
↳ adGroupName | string | Название родительской группы объявлений |
↳ campaignId | string | ID родительской кампании |
↳ campaignName | string | Название родительской кампании |
↳ adType | string | Тип объявления (RESPONSIVE_SEARCH_AD, EXPANDED_TEXT_AD и т.д.) |
↳ impressions | string | Количество показов |
↳ clicks | string | Количество кликов |
↳ costMicros | string | Стоимость в микроединицах (разделить на 1,000,000 для получения валютного значения) |
↳ ctr | number | CTR (click-through rate) от 0.0 до 1.0 |
↳ conversions | number | Количество конверсий |
↳ date | string | Дата для этой строки (YYYY-MM-DD) |
totalCount | number | Общее количество строк результатов |
