Отчеты

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

Атрибуты актива

В следующем запросе GAQL перечислены все активы в учетной записи рекламодателя, а также их имя и тип.

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

Обратите внимание, что существуют атрибуты, специфичные для типа, которые вы можете добавить в приведенный выше запрос для чтения свойств, специфичных для таких ресурсов, как ImageAsset или YoutubeVideoAsset .

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

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 предоставляет специфичный для представления атрибут performance_label , который дает представление о характеристиках производительности этой конкретной пары актив-объявление. Возможные значения полей performance_label перечислены в следующей таблице.

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

Следующий запрос GAQL возвращает показы, клики, затраты и конверсии для всех активов в аккаунте за последний месяц, отсортированные по их 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