Отчеты

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

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

Источник активов

Asset.source точен только для mutable активов.

В качестве источника ресурсов RSA используйте AdGroupAdAsset.source .