Отчеты

Чтобы получить список объектов и их атрибутов, отправьте запрос на языке запросов Google Рекламы (GAQL) к GoogleAdsService. Объекты представлены элементом asset, который содержит ряд полей, относящихся к объектам.

Атрибуты объектов

Следующий запрос GAQL возвращает список всех объектов в аккаунте Google Рекламы, а также их названия и типы ресурсов.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

Чтобы получить свойства, относящиеся к определенным объектам, например ImageAsset или YoutubeVideoAsset, добавьте в запрос атрибуты, относящиеся к типу.

Например, следующий запрос возвращает идентификаторы видео YouTube для всех объектов YoutubeVideoAsset в аккаунте Google Рекламы, отфильтрованных по значению asset.type. Ознакомьтесь со списком возможных значений asset.type.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

Показатели объектов

Показатели объектов доступны в следующих ресурсах:

С помощью этих ресурсов вы можете запрашивать показатели объектов на каждом уровне. Например, при запросе ресурса ad_group_asset вы можете использовать поле ad_group.id для сегментирования результатов, чтобы получить показатели для каждого уникального сочетания ad_group и asset:

SELECT
  ad_group.id,
  asset.id,
  metrics.clicks,
  metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC

Показатели на уровне объявления

Важно! ad_group_ad_asset_view возвращает информацию только об объектах, связанных с рекламой приложений, кампаниями для создания спроса и адаптивными поисковыми объявлениями.

Показатели эффективности объектов на уровне объявлений агрегируются в ad_group_ad_asset_view. В этом представлении собраны показатели объектов для каждого отдельного объявления. Таким образом, запрос к этому представлению возвращает по одной строке для каждой группы объявлений и каждого объявления.

ad_group_ad_asset_view содержит атрибут performance_label, который позволяет получить статистику по эффективности конкретной пары "объект – объявление". В таблице ниже перечислены возможные значения полей performance_label.

performance_labelОписание
BESTСамые эффективные объекты.
GOODОбъекты с хорошей эффективностью.
LOWОбъекты с самой низкой эффективностью.
LEARNINGОбъект начал получать показы, но их недостаточно, чтобы определить его эффективность.
PENDINGИнформации об эффективности этого объекта пока нет. Возможно, он ещё находится на проверке.
UNKNOWNПредставляет значение, неизвестное в этой версии.
UNSPECIFIEDНе указано.

Следующий запрос GAQL возвращает показы, клики, расходы и конверсии для всех объектов в аккаунте Google Рекламы за последний месяц, отсортированные по performance_label:

SELECT
  ad_group_ad_asset_view.ad_group_ad,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.field_type,
  ad_group_ad_asset_view.performance_label,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label

Источник объекта

Asset.source точно работает только для изменяемых объектов.

Для источника объектов адаптивных поисковых объявлений используйте ad_group_ad_asset_view.source.

Назад
Загрузка видео