Язык запросов Поисковой рекламы 360

Язык запросов Search Ads 360 позволяет создавать поисковые запросы для получения данных отчетов и метаданных ресурсов с помощью Search Ads 360 Reporting API.

Поисковые сервисы

Вы можете использовать язык запросов 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: