보고

GAQL (Google Ads 쿼리 언어) 쿼리를 GoogleAdsService에 전송하여 애셋 및 애셋 속성 목록을 가져올 수 있습니다. 애셋은 여러 애셋 관련 필드를 노출하는 asset 항목으로 표현됩니다.

애셋 속성

다음 GAQL 쿼리는 광고주 계정의 모든 애셋을 리소스 이름 및 유형과 함께 나열합니다.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

ImageAsset 또는 YoutubeVideoAsset과 같이 애셋과 관련된 속성을 읽기 위해 위 쿼리에 추가할 수 있는 유형별 속성이 있습니다.

예를 들어 다음 쿼리는 YoutubeVideoAsset의 asset.type 값 (가능한 유형 값 목록은 문서 참고)을 필터링하여 계정 내 모든 YoutubeVideoAsset 객체의 YouTube 동영상 ID를 나열합니다.

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
이전
자동 애셋