Сегменты Google Ads
Сегменты в Google Ads API позволяют разбить метрики по дополнительным измерениям, недоступным через основные поля ресурсов.
Обзор сегментов
Сегменты добавляются в GAQL-запрос через префикс segments.:
sql
SELECT
campaign.name,
segments.date,
segments.device,
metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_7_DAYSВременные сегменты
| Сегмент | Тип | Формат | Описание |
|---|---|---|---|
segments.date | DATE | YYYY-MM-DD | Дата (день) |
segments.week | DATE | YYYY-MM-DD | Начало недели (понедельник) |
segments.month | DATE | YYYY-MM | Месяц |
segments.quarter | STRING | YYYY-Q | Квартал |
segments.year | INTEGER | YYYY | Год |
segments.day_of_week | ENUM | MONDAY..SUNDAY | День недели |
segments.hour | INTEGER | 0..23 | Час суток |
Сегменты устройств и сетей
| Сегмент | Тип | Значения |
|---|---|---|
segments.device | ENUM | DESKTOP, MOBILE, TABLET, CONNECTED_TV, OTHER |
segments.network | ENUM | SEARCH, SEARCH_PARTNERS, DISPLAY, YOUTUBE_SEARCH, YOUTUBE_WATCH, SHOPPING |
segments.slot | ENUM | TOP, OTHER (позиция на странице) |
Географические сегменты
| Сегмент | Тип | Описание |
|---|---|---|
segments.geo_target_city | STRING | Город |
segments.geo_target_region | STRING | Регион/область |
segments.geo_target_country | STRING | Страна |
segments.geo_target_metro | STRING | Метрополия (США) |
Сегменты конверсий
| Сегмент | Тип | Описание |
|---|---|---|
segments.conversion_action | STRING | Ресурс действия-конверсии |
segments.conversion_action_name | STRING | Название действия |
segments.conversion_action_category | ENUM | Категория конверсии |
segments.conversion_lag_bucket | ENUM | Задержка конверсии |
segments.conversion_adjustment | BOOLEAN | Является ли корректировкой |
Сегменты аукциона
| Сегмент | Тип | Описание |
|---|---|---|
segments.auction_insight_domain | STRING | Домен конкурента |
segments.auction_insight_search_term | STRING | Поисковый запрос аукциона |
Ограничения и правила
Совместимость
Не все комбинации сегментов поддерживаются. Основные правила:
- Временные + любые другие:
segments.dateможно комбинировать с большинством сегментов - Конверсионные + временные: поддерживается, но увеличивает объём данных
- Аукционные сегменты: часто требуют отдельного запроса
Производительность
- Максимум 5 сегментов в одном запросе
- Каждый дополнительный сегмент умножает количество строк
- Для больших аккаунтов ограничивайте период при использовании сегментов
Практические комбинации
Дневная эффективность по устройствам
sql
SELECT
segments.date,
segments.device,
metrics.impressions,
metrics.clicks,
metrics.conversions
FROM campaign
WHERE segments.date DURING LAST_7_DAYSКонверсии с задержкой
sql
SELECT
segments.conversion_action_name,
segments.conversion_lag_bucket,
metrics.conversions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS