Отчеты

Вы можете получить список объектов и их атрибутов, отправив запрос на языке запросов 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
• campaign_asset
• customer_asset

С помощью этих ресурсов можно запрашивать показатели объектов на каждом уровне. Например, при запросе ресурса 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.

Следующий запрос 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.