Язык запросов Search Ads 360 позволяет создавать поисковые запросы для получения данных отчетов и метаданных ресурсов с помощью API отчетов Search Ads 360.
Поисковые сервисы
Вы можете использовать язык запросов Search Ads 360 для запроса API, используя:
-
SearchAds360Service
Используйте эту службу для запроса ресурсов и связанных с ними атрибутов, сегментов и показателей. Существует два метода:
Search
иSearchStream
.Запросы
SearchAds360Service
возвращают список экземпляровSearchAds360Row
:- Каждая строка представляет ресурс.
- По запросу строки включают поля атрибутов и показателей.
- Если вы запрашиваете сегменты, для каждого кортежа сегмента-ресурса включаются дополнительные строки.
Дополнительные сведения см. в разделе Создание отчетов о поиске .
-
SearchAds360FieldService
Используйте эту службу для запроса метаданных о доступных полях и ресурсах. Служба предоставляет каталог запрашиваемых полей с указанием их совместимости и типа.
SearchAds360FieldService
возвращает список экземпляровSearchAds360Field
:- Каждое поле содержит сведения о запрошенном поле.
Дополнительные сведения см. в разделе Получение метаданных ресурса .
Примеры основных запросов
В следующих разделах представлены базовые примеры запросов, которые вы можете адаптировать для создания собственных запросов.
Запрос атрибутов ресурса
Это базовый запрос атрибутов ресурса campaign
, который возвращает идентификатор, имя и статус кампании:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
- Каждая возвращаемая
SearchAds360Row
представляет объектcampaign
. - Строки заполняются выбранными полями (включая
resource_name
данной кампании). - Запрос упорядочивается по идентификатору кампании.
См. campaign
чтобы узнать о других доступных полях, которые вы можете использовать в своих запросах.
Запрос метрик
Это базовый запрос метрик, связанных с атрибутами ресурса campaign
:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
- Запрос возвращает кампании со статусом
PAUSED
и более 1000 показов. - Каждая возвращенная
SearchAds360Row
имеет полеmetrics
, заполненное выбранными показателями. - Запрос упорядочивается по идентификатору кампании.
metrics
с другими доступными показателями, которые вы можете использовать в своих запросах.
Запрос сегментов
Это базовый запрос сегментов, связанных с атрибутами ресурса campaign
:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
- Запрос возвращает кампании со статусом
PAUSED
и более 1000 показов. - Он сегментирует данные по дате.
- В результате сегментации каждая
SearchAds360Row
представляет собой кортеж кампании и сегмента дат. - Запрос упорядочивается по идентификатору кампании.
Список segments
которые вы можете использовать в своих запросах, см. в разделе «Сегменты» , а дополнительную информацию о сегментации отчетов см. в разделе «Сегментация».
Запрос атрибутов связанного ресурса
Это базовый запрос к ресурсу campaign
, который объединяет атрибуты ресурса bidding_strategy
, если они доступны. Этот тип связанного ресурса известен как атрибутированный ресурс.
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
- Запрос выбирает атрибуты кампании и связанные атрибуты из каждой выбранной кампании.
- Каждая возвращаемая
SearchAds360Row
представляет объектcampaign
, заполненный выбранными атрибутами кампании, а также выбранным атрибутом стратегии назначения ставокbidding_strategy.name
.
Просмотрите campaign
, чтобы узнать, какие атрибутированные ресурсы доступны для запросов кампании.
Запрос метаданных поля
Вы можете использовать SearchAds360FieldService
для получения метаданных поля.
Это базовый запрос метаданных поля:
SELECT name, category, selectable, filterable, sortable, selectable_with, data_type, is_repeated WHERE name = RESOURCE/FIELD
- Замените RESOURCE OR FIELD либо ресурсом (например,
customer
илиcampaign
), либо полем (например,campaign.id
,metrics.impressions
илиad_group.id
).
Дополнительные сведения о получении метаданных поля см. в разделе Получение метаданных ресурса .
Узнать больше
Узнайте больше о том, как создавать запросы в Search Ads 360 Reporting API: