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

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

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

Для запроса к API можно использовать язык запросов Search Ads 360 Query Language, используя следующие средства:

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 ).

Дополнительную информацию о получении метаданных полей см. в разделе «Получение метаданных ресурса» .

Узнать больше

Узнайте больше о том, как создавать запросы в API отчетов Search Ads 360: