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