이 페이지는 Cloud Translation API를 통해 번역되었습니다.

보고

GoogleAdsService에 GAQL (Google Ads 쿼리 언어) 쿼리를 전송하여 애셋 및 애셋 속성 목록을 가져올 수 있습니다. 애셋은 여러 애셋 관련 필드를 노출하는 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

자동 애셋

애셋