Google Ads API는 광고가 게재된 위치와 실적을 분석할 수 있는 여러 뷰를 제공합니다.
managed_placement_view,
group_placement_view,
detail_placement_view,
performance_max_placement_view 각 뷰는 게재위치 데이터에 대한 다양한 관점을 제공합니다. Google Ads UI에서 게재위치 화면을 복제하는 바로 실행 가능한 Google Ads 쿼리 언어(GAQL) 및 curl 쿼리는 쿼리 설명서를 참고하세요.
선택 게재위치 보기
- 표시되는 항목:
managed_placement_view리소스는 광고 그룹에서 타겟팅하는 양성 게재위치 기준별로 집계된 실적 데이터를 제공합니다. 이 뷰에는 Google Ads UI의 콘텐츠 > 게재위치에서 관리되는 5가지 기준 유형(웹사이트, YouTube 채널, YouTube 동영상, 모바일 앱, 모바일 앱 카테고리)이 모두 포함됩니다. - UI 상응 항목: 콘텐츠 > 게재위치
- 쿼리 빌더: 쿼리 빌더에서 탐색
타겟 게재위치 기준 유형
managed_placement_view 리소스의 각 행은 ad_group_criterion.type 값과 일치하는 AdGroupCriterion 필드를 채우고 다른 배치 필드는 설정되지 않은 상태로 둡니다.
| UI 게재위치 유형 | ad_group_criterion.type 값 |
기준 세부정보 필드 | 참고 |
|---|---|---|---|
| 웹사이트 | PLACEMENT |
ad_group_criterion.placement.url |
타겟 웹사이트 또는 도메인 URL입니다. |
| YouTube 채널 | YOUTUBE_CHANNEL |
ad_group_criterion.youtube_channel.channel_id |
YouTube 채널 ID ad_group_criterion.display_name 필드는 채널 이름을 반환합니다. |
| YouTube 동영상 | YOUTUBE_VIDEO |
ad_group_criterion.youtube_video.video_id |
YouTube 동영상 ID입니다. ad_group_criterion.display_name 필드는 동영상 제목을 반환합니다. |
| 앱 | MOBILE_APPLICATION |
ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name |
{platform}-{platform_native_id} 형식의 앱 ID(iOS의 경우 1-, Android의 경우 2-) 및 앱 이름 |
| 앱 카테고리 | MOBILE_APP_CATEGORY |
ad_group_criterion.mobile_app_category.mobile_app_category_constant |
mobileAppCategoryConstants/{mobile_app_category_id} 형식의 리소스 이름입니다. 모바일 앱 카테고리 이름 및 계층 구조를 참고하세요. |
예시 검색어
지난 30일 동안 타겟 게재위치 유형 전체의 실적 측정항목을 가져오려면 유형별 필드와 함께 ad_group_criterion.type 필드를 선택합니다.
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.display_name,
ad_group_criterion.placement.url,
ad_group_criterion.youtube_channel.channel_id,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.mobile_application.app_id,
ad_group_criterion.mobile_application.name,
ad_group_criterion.mobile_app_category.mobile_app_category_constant,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
모바일 앱 카테고리 이름 및 계층 구조
Google Ads UI에서 타겟팅된 모바일 앱 카테고리는 앱 카테고리 > Apple App Store > 교육과 같이 전체 스토어 경로를 표시합니다. Google Ads API를 쿼리할 때는 다음 동작에 유의하세요.
- 모바일 앱 카테고리 상수 기여 분석:
mobile_app_category_constant리소스는managed_placement_view리소스의 기여 분석 리소스가 아닙니다. 대신ad_group_criterion.mobile_app_category.mobile_app_category_constant필드(예:mobileAppCategoryConstants/60503)를 선택하거나 측정항목이 필요하지 않은 경우ad_group_criterion리소스를 쿼리하세요. - 리프 전용 표시 이름:
ad_group_criterion.display_name및mobile_app_category_constant.name필드 모두"Education"또는"Games"와 같은 리프 카테고리 이름만 반환합니다. 두 필드 모두 상위 앱 스토어 경로를 포함하지 않습니다. - 앱 스토어 경로 확인: Google Play와 Apple App Store는 서로 다른 기준 ID에서 리프 카테고리 이름을 공유합니다. 예를 들어 기준 ID
60005(/All Apps/Google Play/Education),60060(/All Apps/Google Play/Family/Education),60503(/All Apps/Apple App Store/Education)는 모두name및display_name필드에서"Education"를 반환합니다. 리소스 이름에서{mobile_app_category_id}서픽스를 추출하고 모바일 앱 카테고리 테이블 또는 CSV 파일에서 전체 계층 구조 경로를 빠른 검색합니다.
그룹 게재위치 뷰
- 표시되는 항목:
group_placement_view리소스는 게재위치가 명시적으로 타겟팅되었는지 또는 Google 시스템에서 자동으로 발견되었는지에 관계없이 디스플레이 네트워크 및 YouTube에서 광고가 실제로 게재된 위치를 보여줍니다. 여기에는 웹사이트, YouTube 채널 또는 동영상, 앱이 포함될 수 있습니다. - UI 상응 항목: 콘텐츠 > 광고가 게재된 위치
- 쿼리 빌더: 쿼리 빌더에서 탐색
예시 검색어
다음 쿼리는 지난 30일 동안 광고가 게재된 도메인, 모바일 앱, YouTube 채널의 실적 측정항목을 가져옵니다.
SELECT
campaign.id,
ad_group.id,
group_placement_view.display_name,
group_placement_view.target_url,
group_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS
'합계: 기타' 행
보고서 생성을 가속화하기 위해 group_placement_view 및 detail_placement_view 리소스는 노출수 또는 상호작용의 최소 활동 기준을 충족하지 않는 개별 게재위치를 제외합니다.
- Google Ads UI: UI는 이 활동 기준점을 충족하지 않는 게재위치를 합계: 기타라는 요약 행으로 집계합니다.
- Google Ads API: API는 활동 기준점을 충족하지 않는 게재위치를 보고서 결과에서 생략하고
group_placement_view.placement또는detail_placement_view.placement필드의 값이"Other"인 요약 행을 반환하지 않습니다.
따라서 group_placement_view 및 detail_placement_view 리소스의 개별 게재위치 행의 합계가 광고 그룹 또는 캠페인의 총 측정항목보다 작을 수 있습니다. 자세한 내용은 '광고가 게재된 위치' 보고서 정보를 참고하세요. 기준점 및 누락된 메타데이터가 교차 뷰 비교에 미치는 영향에 대한 자세한 내용은 게재위치 뷰 간의 측정항목 차이 및 게재위치 세부정보를 사용할 수 없는 행을 참고하세요.
게재위치 타겟팅 설정
group_placement_view의 동작과 유틸리티는 광고 그룹 수준에서 PLACEMENT 측정기준의 TargetingSetting에 영향을 받습니다. 이 설정에는 target_restrictions 목록이 포함되며, 각 목록에는 광고가 타겟 게재위치에만 게재되는지 아니면 다른 게재위치에도 게재되는지를 나타내는 bid_only 불리언 필드가 있습니다. '타겟팅' 및 '관찰' 설정을 참고하세요.
bid_only = false: 이 값은 게재위치에 대한 Google Ads UI의 타겟팅에 해당합니다. 광고 그룹이 '타겟팅'으로 설정된 경우 광고는 명시적으로 기준으로 추가한 게재위치에만 게재됩니다. 이러한 게재위치에 입찰가 조정을 적용할 수 있습니다. 이 시나리오에서group_placement_view는managed_placement_view를 크게 반영하지만 여전히 최소 활동 기준점이 적용됩니다.bid_only = true: 이 값은 게재위치에 대한 Google Ads UI의 관찰에 해당합니다. 광고 그룹이 '관찰'로 설정된 경우 디스플레이 네트워크 및 YouTube의 운영 가능한 모든 게재위치에 광고가 게재될 수 있습니다. 타겟팅한 게재위치에 입찰가 조정을 적용할 수도 있습니다. 이 경우group_placement_view는 광고가 게재되는 새 게재위치를 찾는 데 매우 중요하며, 이를 선택 게재위치 또는 제외로 추가할 수 있습니다.
상세 게재위치 보기
- 표시되는 내용:
detail_placement_view리소스는 게재위치를 더 세분화하여 도메인 또는 채널 수준을 넘어서는 세부정보를 제공합니다. 예를 들어 광고가 게재된 특정 URL 또는 YouTube 동영상 ID를 표시할 수 있습니다. - UI 상응 기능: 콘텐츠 > 광고 표시 채널에서 행을 선택한 다음 세부정보 보기를 클릭하는 것과 같습니다.
- 쿼리 빌더: 쿼리 빌더에서 탐색
- 중요 고려사항:
group_placement_view리소스와 마찬가지로 이 뷰에서는 최소 활동 기준을 충족하지 않는 활동이 적은 게재위치를 생략합니다('합계: 기타' 행 섹션 참고).
예시 검색어
결과 볼륨을 제한하기 위해 다음 쿼리는 7일 동안 URL 수준 및 동영상 수준 게재위치 측정항목을 가져옵니다. 대규모 계정의 경우 campaign.id 또는 ad_group.id 필드로 추가 필터링합니다.
SELECT
campaign.id,
ad_group.id,
detail_placement_view.display_name,
detail_placement_view.target_url,
detail_placement_view.group_placement_target_url,
detail_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS
게재위치 메타데이터를 사용할 수 없는 행을 제외하려면 AND
detail_placement_view.target_url IS NOT NULL를 추가합니다(게재위치 세부정보를 사용할 수 없는 행 참고). 반환된 resource_name 필드가 필요하지 않으면 PARAMETERS
omit_unselected_resource_names = true 절을 추가합니다.
게재위치 보기 간 측정항목 차이
최소 활동 기준점은 각 세분화 수준에서 독립적으로 평가됩니다.
group_placement_view리소스는 집계된 도메인, 모바일 앱 또는 YouTube 채널에서 기준점을 평가합니다.detail_placement_view리소스는 각 개별 페이지 URL 또는 YouTube 동영상에 대해 개별적으로 기준점을 평가합니다.
detail_placement_view 리소스는 기준을 충족하지 않는 개별 페이지 URL 또는 YouTube 동영상을 생략합니다. 따라서 도메인 또는 YouTube 채널의 detail_placement_view 행을 합산하면(detail_placement_view.group_placement_target_url 필드로 필터링됨) 해당 group_placement_view 행보다 노출수가 적을 수 있습니다.
게재위치 세부정보를 사용할 수 없는 행
group_placement_view 또는 detail_placement_view 리소스에 대한 쿼리는 placement, display_name, target_url 필드가 설정되지 않고 동일한 resource_name 값(예: ~MTRf로 끝남)이 있는 동일한 광고 그룹의 여러 행을 반환할 수 있습니다.
이 동작은 다음과 같은 이유로 발생합니다.
- 내부 게재위치 그룹화: 두 뷰 모두
resource_name또는placement문자열 필드가 아닌 고유한 내부 게재위치 식별자로 실적 측정항목을 그룹화합니다. - 사용할 수 없는 게재위치 메타데이터: Google Ads UI에서 백엔드 참고표에 메타데이터가 없는 게재위치는 알 수 없음, 채널을 더 이상 사용할 수 없음 또는 동영상을 더 이상 사용할 수 없음으로 표시됩니다. API에서 각 고유 게재위치 식별자는
placement,display_name,target_url필드가 설정되지 않은 상태로 측정항목 행을 반환합니다. - 합성된 리소스 이름:
resource_name필드의{base64_placement}서픽스는{type_id}_{placement}에서 Base64로 인코딩됩니다. 여기서{type_id}는PlacementTypeenum 번호가 아닌 내부 배치 유형 식별자입니다.placement_type필드가WEBSITE(내부 ID14)이고placement필드가 설정되지 않은 경우 문자열"14_"는MTRf로 인코딩됩니다(마찬가지로MOBILE_APPLICATION는"55_"를NTVf로 인코딩하고,YOUTUBE_VIDEO는"89_"를ODlf로 인코딩하고,YOUTUBE_CHANNEL는"90_"를OTBf로 인코딩함). 따라서 동일한 광고 그룹에서 메타데이터를 사용할 수 없는 동일한 유형의 여러 게재위치는 별도의 측정항목 행을 보고하는 동안 동일한resource_name값을 공유합니다.
클라이언트 코드에서 group_placement_view 또는 detail_placement_view 결과를 처리할 때 resource_name 필드만으로 행을 중복 삭제하지 마세요. 이렇게 하면 사용할 수 없는 메타데이터가 있는 여러 게재위치의 측정항목을 덮어쓸 수 있습니다.
GAQL에서 사용할 수 없는 메타데이터가 있는 행을 제외하려면 target_url 또는 display_name 필드를 필터링하세요. placement 및 resource_name 필드는 필터링할 수 없기 때문입니다. 예를 들어 WHERE group_placement_view.target_url IS
NOT NULL 또는 WHERE detail_placement_view.target_url IS NOT NULL를 사용합니다.
실적 최대화 캠페인 게재위치 뷰
- 표시되는 항목:
performance_max_placement_view리소스는 실적 최대화 광고가 게재된 게재위치의 노출 데이터(metrics.impressions)를 제공합니다. v24 이상에서는segments.ad_network_type로performance_max_placement_view를 분류할 수 있습니다(v23에서는 지원되지 않음). - UI 상응 기능: 통계 및 보고서 > 보고서 편집기 > 실적 최대화 캠페인 게재위치
- 쿼리 빌더: 쿼리 빌더에서 탐색
예시 검색어
다음 쿼리는 지난 30일 동안의 실적 최대화 캠페인에 대해 광고 네트워크 유형별로 분류된 게재위치 노출수를 가져옵니다.
SELECT
campaign.id,
performance_max_placement_view.display_name,
performance_max_placement_view.target_url,
performance_max_placement_view.placement_type,
segments.ad_network_type,
metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS
게재위치 뷰 선택
managed_placement_view를 사용하여 적극적으로 타겟팅하고 입찰하는 게재위치의 실적을 평가합니다.group_placement_view를 사용하여 광고가 게재되는 전체 범위를 파악하세요. 특히 '관찰' 설정을 사용하는 경우 새로운 타겟팅 기회 또는 제외를 발견할 수 있습니다.detail_placement_view를 사용하여 광고가 게재된 특정 URL 또는 동영상에 대한 가장 세부적인 정보를 가져옵니다. 이는group_placement_view에서 관심 있는 도메인 또는 채널을 식별한 후에 자주 사용됩니다.performance_max_placement_view를 사용하여 실적 최대화 캠페인의 게재위치 노출수를 검사합니다.