Эта страница переведена с помощью Cloud Translation API.

Отчеты

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

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

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

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

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

Например, следующий запрос выводит идентификаторы видео YouTube для всех объектов YoutubeVideoAsset в учетной записи, фильтруя по значению asset.type . (См. список возможных значений 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

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

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

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

Ресурсы бизнес-сообщений