Получение атрибутов и показателей активов

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Атрибуты объекта

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