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