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