GoogleAdsService에 Google Ads 쿼리 언어 (GAQL) 쿼리를 전송하여 애셋 목록과 속성을 가져올 수 있습니다. 애셋은 여러 애셋별 필드를 노출하는 asset 엔티티로 표현됩니다.
애셋 속성
다음 GAQL 쿼리는 광고주 계정의 모든 확장 소재를 리소스 이름 및 유형과 함께 나열합니다.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
이 쿼리에 유형별 속성을 추가하여 ImageAsset 또는 YoutubeVideoAsset과 같은 애셋 관련 속성을 읽을 수 있습니다.
예를 들어 다음 쿼리는 asset.type 값을 필터링하여 계정의 모든 YoutubeVideoAsset 객체의 YouTube 동영상 ID를 나열합니다. 가능한 유형 값 목록은 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를 사용합니다.