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