Google Ads 보고서 변환

이 문서에서는 Google Ads (이전 명칭: Google 애드워즈)에 대해 보고서를 변환하는 방법을 설명합니다.

Google Ads 보고서의 테이블 매핑

Google Ads 보고서를 BigQuery로 전송하면 보고서가 다음과 같은 BigQuery 테이블과 뷰로 전환됩니다.

BigQuery에서 표와 뷰를 볼 때 customer_id 값은 사용자의 Google Ads 고객 ID입니다.

애드워즈 보고서 (지원 중단됨) BigQuery AdWords 테이블 Google Ads 표 Google Ads API 리소스 (v21.0.0) BigQuery 뷰
계정 실적 보고서 p_Customer_customer_id
p_HourlyAccountConversionStats_customer_id
p_AccountConversionStats_customer_id
p_HourlyAccountStats_customer_id
p_AccountNonClickStats_customer_id
p_AccountBasicStats_customer_id
p_AccountStats_customer_id
p_ads_Customer_customer_id
p_ads_HourlyAccountConversionStats_customer_id
p_ads_AccountConversionStats_customer_id
p_ads_HourlyAccountStats_customer_id
p_ads_AccountNonClickStats_customer_id
p_ads_AccountBasicStats_customer_id
p_ads_AccountStats_customer_id
고객 Customer_customer_id
HourlyAccountConversionStats_customer_id
AccountConversionStats_customer_id
HourlyAccountStats_customer_id
AccountNonClickStats_customer_id
AccountBasicStats_customer_id
AccountStats_customer_id
광고 실적 보고서 p_AdBasicStats_customer_id
p_AdCrossDeviceStats_customer_id
p_AdConversionStats_customer_id
p_AdStats_customer_id
p_AdCrossDeviceConversionStats_customer_id
p_Ad_customer_id
p_ads_AdBasicStats_customer_id
p_ads_AdCrossDeviceStats_customer_id
p_ads_AdConversionStats_customer_id
p_ads_AdStats_customer_id
p_ads_AdCrossDeviceConversionStats_customer_id
p_ads_Ad_customer_id
광고 그룹 광고 AdBasicStats_customer_id
AdCrossDeviceStats_customer_id
AdConversionStats_customer_id
AdStats_customer_id
AdCrossDeviceConversionStats_customer_id
Ad_customer_id
광고그룹 실적 보고서 p_AdGroupStats_customer_id
p_AdGroupBasicStats_customer_id
p_AdGroupCrossDeviceStats_customer_id
p_HourlyAdGroupConversionStats_customer_id
p_HourlyAdGroupStats_customer_id
p_AdGroupConversionStats_customer_id
p_AdGroupCrossDeviceConversionStats_customer_id
p_AdGroup_customer_id
p_ads_AdGroupStats_customer_id
p_ads_AdGroupBasicStats_customer_id
p_ads_AdGroupCrossDeviceStats_customer_id
p_ads_HourlyAdGroupConversionStats_customer_id
p_ads_HourlyAdGroupStats_customer_id
p_ads_AdGroupConversionStats_customer_id
p_ads_AdGroupCrossDeviceConversionStats_customer_id
p_ads_AdGroup_customer_id
광고 그룹 AdGroupStats_customer_id
AdGroupBasicStats_customer_id
AdGroupCrossDeviceStats_customer_id
HourlyAdGroupConversionStats_customer_id
HourlyAdGroupStats_customer_id
AdGroupConversionStats_customer_id
AdGroupCrossDeviceConversionStats_customer_id
AdGroup_customer_id
연령대 실적 보고서 p_AgeRange_customer_id
p_AgeRangeBasicStats_customer_id
p_AgeRangeStats_customer_id
p_AgeRangeConversionStats_customer_id
p_AgeRangeNonClickStats_customer_id
p_ads_AgeRange_customer_id
p_ads_AgeRangeBasicStats_customer_id
p_ads_AgeRangeStats_customer_id
p_ads_AgeRangeConversionStats_customer_id
p_ads_AgeRangeNonClickStats_customer_id
연령대 보기 AgeRange_customer_id
AgeRangeBasicStats_customer_id
AgeRangeStats_customer_id
AgeRangeConversionStats_customer_id
AgeRangeNonClickStats_customer_id
잠재고객 실적 보고서 p_Audience_customer_id
p_AudienceConversionStats_customer_id
p_AudienceNonClickStats_customer_id
p_AudienceBasicStats_customer_id
p_AudienceStats_customer_id
NULL
NULL
NULL
NULL
NULL
광고 그룹 잠재고객 보기
캠페인 잠재고객 보기
Audience_customer_id
AudienceConversionStats_customer_id
AudienceNonClickStats_customer_id
AudienceBasicStats_customer_id
AudienceStats_customer_id
입찰 목표 실적 보고서 p_BidGoal_customer_id
p_BidGoalStats_customer_id
p_HourlyBidGoalStats_customer_id
p_BidGoalConversionStats_customer_id
p_ads_BidGoal_customer_id
p_ads_BidGoalStats_customer_id
p_ads_HourlyBidGoalStats_customer_id
p_ads_BidGoalConversionStats_customer_id
입찰 전략 BidGoal_customer_id
BidGoalStats_customer_id
HourlyBidGoalStats_customer_id
BidGoalConversionStats_customer_id
예산 실적 보고서 p_Budget_customer_id
p_BudgetStats_customer_id
p_ads_Budget_customer_id
p_ads_BudgetStats_customer_id
캠페인 예산 Budget_customer_id
BudgetStats_customer_id
캠페인 타겟 위치 보고서 p_CampaignLocationTargetStats_customer_id
p_LocationBasedCampaignCriterion_customer_id
p_ads_CampaignLocationTargetStats_customer_id
p_ads_LocationBasedCampaignCriterion_customer_id
위치 보기 CampaignLocationTargetStats_customer_id
LocationBasedCampaignCriterion_customer_id
캠페인 실적 보고서 p_Campaign_customer_id
p_CampaignBasicStats_customer_id
p_CampaignConversionStats_customer_id
p_CampaignCrossDeviceStats_customer_id
p_HourlyCampaignConversionStats_customer_id
p_CampaignStats_customer_id
p_HourlyCampaignStats_customer_id
p_CampaignCrossDeviceConversionStats_customer_id
p_CampaignCookieStats_customer_id
p_ads_Campaign_customer_id
p_ads_CampaignBasicStats_customer_id
p_ads_CampaignConversionStats_customer_id
p_ads_CampaignCrossDeviceStats_customer_id
p_ads_HourlyCampaignConversionStats_customer_id
p_ads_CampaignStats_customer_id
p_ads_HourlyCampaignStats_customer_id
p_ads_CampaignCrossDeviceConversionStats_customer_id
p_ads_CampaignCookieStats_customer_id
Campaign Campaign_customer_id
CampaignBasicStats_customer_id
CampaignConversionStats_customer_id
CampaignCrossDeviceStats_customer_id
HourlyCampaignConversionStats_customer_id
CampaignStats_customer_id
HourlyCampaignStats_customer_id
CampaignCrossDeviceConversionStats_customer_id
CampaignCookieStats_customer_id
클릭 실적 보고서 p_ClickStats_customer_id p_ads_ClickStats_customer_id 보기 클릭 ClickStats_customer_id
기준 실적 보고서 p_Criteria_customer_id
p_CriteriaBasicStats_customer_id
p_CriteriaStats_customer_id
p_CriteriaConversionStats_customer_id
p_CriteriaNonClickStats_customer_id
NULL
NULL
NULL
NULL
NULL
Criteria_customer_id
CriteriaBasicStats_customer_id
CriteriaStats_customer_id
CriteriaConversionStats_customer_id
CriteriaNonClickStats_customer_id
성별 실적 보고서 p_Gender_customer_id
p_GenderBasicStats_customer_id
p_GenderStats_customer_id
p_GenderConversionStats_customer_id
p_GenderNonClickStats_customer_id
p_ads_Gender_customer_id
p_ads_GenderBasicStats_customer_id
p_ads_GenderStats_customer_id
p_ads_GenderConversionStats_customer_id
p_ads_GenderNonClickStats_customer_id
성별 보기 Gender_customer_id
GenderBasicStats_customer_id
GenderStats_customer_id
GenderConversionStats_customer_id
GenderNonClickStats_customer_id
지역 실적 보고서 p_GeoConversionStats_customer_id
p_GeoStats_customer_id
p_ads_GeoConversionStats_customer_id
p_ads_GeoStats_customer_id
지역별 보기 GeoConversionStats_customer_id
GeoStats_customer_id
키워드 실적 보고서 p_Keyword_customer_id
p_KeywordBasicStats_customer_id
p_KeywordCrossDeviceStats_customer_id
p_KeywordStats_customer_id
p_KeywordCrossDeviceConversionStats_customer_id
p_KeywordConversionStats_customer_id
p_ads_Keyword_customer_id
p_ads_KeywordBasicStats_customer_id
p_ads_KeywordCrossDeviceStats_customer_id
p_ads_KeywordStats_customer_id
p_ads_KeywordCrossDeviceConversionStats_customer_id
p_ads_KeywordConversionStats_customer_id
키워드 보기 Keyword_customer_id
KeywordBasicStats_customer_id
KeywordCrossDeviceStats_customer_id
KeywordStats_customer_id
KeywordCrossDeviceConversionStats_customer_id
KeywordConversionStats_customer_id
유료 자연 쿼리 보고서 p_PaidOrganicStats_customer_id p_ads_PaidOrganicStats_customer_id 유료 자연 검색어 보기 PaidOrganicStats_customer_id
자녀 유무 실적 보고서 p_ParentalStatus_customer_id
p_ParentalStatusBasicStats_customer_id
p_ParentalStatusStats_customer_id
p_ParentalStatusConversionStats_customer_id
p_ParentalStatusNonClickStats_customer_id
p_ads_ParentalStatus_customer_id
p_ads_ParentalStatusBasicStats_customer_id
p_ads_ParentalStatusStats_customer_id
p_ads_ParentalStatusConversionStats_customer_id
p_ads_ParentalStatusNonClickStats_customer_id
자녀 유무 보기 ParentalStatus_customer_id
ParentalStatusBasicStats_customer_id
ParentalStatusStats_customer_id
ParentalStatusConversionStats_customer_id
ParentalStatusNonClickStats_customer_id
게재위치 실적 보고서 p_PlacementBasicStats_customer_id
p_PlacementNonClickStats_customer_id
p_PlacementStats_customer_id
p_Placement_customer_id
p_PlacementConversionStats_customer_id
p_ads_PlacementBasicStats_customer_id
p_ads_PlacementNonClickStats_customer_id
p_ads_PlacementStats_customer_id
p_ads_Placement_customer_id
p_ads_PlacementConversionStats_customer_id
선택 게재위치 보기 PlacementBasicStats_customer_id
PlacementNonClickStats_customer_id
PlacementStats_customer_id
Placement_customer_id
PlacementConversionStats_customer_id
검색어 실적 보고서 p_SearchQueryStats_customer_id
p_SearchQueryConversionStats_customer_id
p_ads_SearchQueryStats_customer_id
p_ads_SearchQueryConversionStats_customer_id
검색어 보기 SearchQueryStats_customer_id
SearchQueryConversionStats_customer_id
쇼핑 실적 보고서 p_ShoppingProductConversionStats_customer_id
p_ShoppingProductStats_customer_id
p_ads_ShoppingProductConversionStats_customer_id
p_ads_ShoppingProductStats_customer_id
쇼핑 실적 보기 ShoppingProductConversionStats_customer_id
ShoppingProductStats_customer_id
동영상 실적 보고서 p_VideoBasicStats_customer_id
p_VideoConversionStats_customer_id
p_VideoStats_customer_id
p_Video_customer_id
p_VideoNonClickStats_customer_id
p_ads_VideoBasicStats_customer_id
p_ads_VideoConversionStats_customer_id
p_ads_VideoStats_customer_id
p_ads_Video_customer_id
p_ads_VideoNonClickStats_customer_id
동영상 VideoBasicStats_customer_id
VideoConversionStats_customer_id
VideoStats_customer_id
Video_customer_id
VideoNonClickStats_customer_id
AdGroupBidModifier 광고 그룹 입찰가 조정
AdGroupAdLabel 광고 그룹 광고 라벨
CampaignLabel 캠페인 라벨
CampaignCriterion 캠페인 기준
AdGroupLabel 광고 그룹 라벨
AdGroupAudience
AdGroupAudienceStats
AdGroupAudienceConversionStats
AdGroupAudienceNonClickStats
AdGroupAudienceBasicStats
광고 그룹 잠재고객 보기
Assets (available if Pmax data is enabled) 애셋
AssetGroup (available if Pmax data is enabled) 애셋 그룹
AssetGroupAsset (available if Pmax data is enabled) 애셋 그룹 애셋
AssetGroupSignal (available if Pmax data is enabled) 애셋 그룹 신호
AssetGroupProductGroupStats (available if Pmax data is enabled) AssetGroupProductGroupStats
CampaignAssetStats (available if Pmax data is enabled) CampaignAssetStats

Google Ads 보고서의 열 매핑

Google Ads 전송으로 생성된 BigQuery 테이블은 다음 열 (필드)로 구성됩니다.

Google Ads 테이블 이름: AccountBasicStats

Google Ads API 리소스: customer

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_slot 광고의 게재순위입니다. 슬롯

Google Ads 테이블 이름: AccountConversionStats

Google Ads API 리소스: customer

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018년 4월 1일에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_slot 광고의 게재순위입니다. 슬롯
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AccountNonClickStats

Google Ads API 리소스: customer

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_content_budget_lost_impression_share 광고가 디스플레이 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 콘텐츠 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. ContentBudgetLostImpressionShare
metrics_content_impression_share 디스플레이 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 콘텐츠 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. ContentImpressionShare
metrics_content_rank_lost_impression_share 디스플레이 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 콘텐츠 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. ContentRankLostImpressionShare
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_invalid_click_rate 보고 기간 동안 전체 클릭수(필터링된 클릭수 + 필터링되지 않은 클릭수)에서 필터링된 클릭수의 비율입니다. InvalidClickRate
metrics_invalid_clicks Google에서 불법으로 간주하여 비용을 청구하지 않는 클릭수입니다. InvalidClicks
metrics_search_budget_lost_impression_share 광고가 검색 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 검색 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostImpressionShare
metrics_search_exact_match_impression_share 키워드 검색 유형과 관계없이 검색 네트워크에서 키워드와 정확히 일치하거나 거의 일치하는 검색어로 인해 발생한 노출의 추정 횟수로 나눈 노출수입니다. 참고: 검색 일치검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchExactMatchImpressionShare
metrics_search_impression_share 검색 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchImpressionShare
metrics_search_rank_lost_impression_share 검색 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 검색 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostImpressionShare
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018년 4월 1일에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AccountStats

Google Ads API 리소스: customer

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018년 4월 1일에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 표 이름: 광고

Google Ads API 리소스: ad_group_ad

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_added_by_google_ads 이 광고가 사용자가 아닌 Google Ads에 의해 자동으로 추가되었는지 여부를 나타냅니다. 예를 들어 기존 광고의 실적에 대한 지식을 기반으로 새 광고에 대한 제안으로 광고가 자동으로 생성되는 경우에 발생할 수 있습니다. 자동
ad_group_ad_ad_app_ad_descriptions 설명에 사용할 텍스트 애셋 목록입니다. 광고가 내용 입력란을 게재할 때 이 목록에서 선택됩니다. UniversalAppAdDescriptions
ad_group_ad_ad_app_ad_headlines 광고 제목의 텍스트 애셋 목록입니다. 이 목록에서 광고에 광고 제목이 게재되는 경우를 선택합니다. UniversalAppAdHeadlines
ad_group_ad_ad_app_ad_html5_media_bundles 광고와 함께 사용할 수 있는 미디어 번들 애셋 목록입니다. UniversalAppAdHtml5MediaBundles
ad_group_ad_ad_app_ad_images 광고와 함께 표시될 수 있는 이미지 애셋 목록입니다. UniversalAppAdImages
ad_group_ad_ad_app_ad_mandatory_ad_text 선택사항인 텍스트 확장 소재로, 지정된 경우 광고가 게재될 때 항상 표시되어야 합니다. UniversalAppAdMandatoryAdText
ad_group_ad_ad_app_ad_youtube_videos 광고와 함께 표시될 수 있는 YouTube 동영상 애셋 목록입니다. UniversalAppAdYouTubeVideos
ad_group_ad_ad_call_ad_phone_number 광고에 표시되는 전화번호입니다. CallOnlyPhoneNumber
ad_group_ad_ad_device_preference 광고의 기기 환경설정입니다. 휴대기기에 대한 환경설정만 지정할 수 있습니다. 이 환경설정이 설정되면 휴대기기에 표시될 때 다른 광고보다 이 광고가 우선적으로 표시됩니다. 다른 기기 유형에는 광고가 계속 표시될 수 있습니다. 예를 들어 다른 광고가 없는 경우 지정되지 않은 경우 (기기 환경설정이 없음) 모든 기기가 타겟팅됩니다. 일부 광고 유형에서만 지원됩니다.
ad_group_ad_ad_display_url 일부 광고 형식의 광고 설명에 표시되는 URL입니다. DisplayUrl
ad_group_ad_ad_expanded_dynamic_search_ad_description 광고 설명입니다.
ad_group_ad_ad_expanded_dynamic_search_ad_description2 광고의 두 번째 설명입니다. ExpandedDynamicSearchCreativeDescription2
ad_group_ad_ad_expanded_text_ad_description 광고 설명입니다.
ad_group_ad_ad_expanded_text_ad_description2 광고의 두 번째 설명입니다. ExpandedTextAdDescription2
ad_group_ad_ad_expanded_text_ad_headline_part1 광고 제목의 첫 번째 부분입니다. HeadlinePart1
ad_group_ad_ad_expanded_text_ad_headline_part2 광고 제목의 두 번째 부분입니다. HeadlinePart2
ad_group_ad_ad_expanded_text_ad_headline_part3 광고 제목의 세 번째 부분입니다. ExpandedTextAdHeadlinePart3
ad_group_ad_ad_expanded_text_ad_path1 광고의 표시 URL 옆에 표시될 수 있는 텍스트입니다. Path1
ad_group_ad_ad_expanded_text_ad_path2 광고의 표시 URL과 함께 표시될 수 있는 추가 텍스트입니다. Path2
ad_group_ad_ad_final_app_urls 사용자가 특정 앱을 설치한 경우 모바일에서 사용되는 최종 앱 URL 목록입니다. CreativeFinalAppUrls
ad_group_ad_ad_final_mobile_urls 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 모바일 URL 목록입니다. CreativeFinalMobileUrls
ad_group_ad_ad_final_urls 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. CreativeFinalUrls
ad_group_ad_ad_group 광고가 속한 광고 그룹입니다.
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_ad_ad_image_ad_image_url 전체 크기 이미지의 URL입니다. ImageAdUrl
ad_group_ad_ad_image_ad_mime_type 이미지의 MIME 유형입니다. ImageCreativeMimeType
ad_group_ad_ad_image_ad_name 이미지의 이름입니다. 이미지가 MediaFile에서 생성된 경우 MediaFile의 이름입니다. 바이트에서 이미지가 생성된 경우 비어 있습니다. ImageCreativeName
ad_group_ad_ad_image_ad_pixel_height 전체 크기 이미지의 높이(픽셀)입니다. ImageCreativeImageHeight
ad_group_ad_ad_image_ad_pixel_width 전체 크기 이미지의 너비(픽셀)입니다. ImageCreativeImageWidth
ad_group_ad_ad_legacy_responsive_display_ad_accent_color 광고의 강조 색상(16진수)입니다. 예를 들어 흰색의 경우 #ffffff입니다. main_color와 accent_color 중 하나가 설정된 경우 다른 하나도 필요합니다. AccentColor
ad_group_ad_ad_legacy_responsive_display_ad_allow_flexible_color 유연한 색상을 허용하는 광고주의 동의입니다. true인 경우 필요한 경우 광고가 다른 색상으로 게재될 수 있습니다. false인 경우 광고가 지정된 색상 또는 중립 색상으로 게재됩니다. 기본값은 true입니다. main_color와 accent_color가 설정되지 않은 경우 true여야 합니다. AllowFlexibleColor
ad_group_ad_ad_legacy_responsive_display_ad_business_name 광고에 표시되는 비즈니스 이름입니다. BusinessName
ad_group_ad_ad_legacy_responsive_display_ad_call_to_action_text 광고의 클릭 유도 문구 텍스트입니다. CallToActionText
ad_group_ad_ad_legacy_responsive_display_ad_description 광고 설명입니다. 설명
ad_group_ad_ad_legacy_responsive_display_ad_format_setting 광고가 게재되는 형식을 지정합니다. 기본값은 ALL_FORMATS입니다. FormatSetting
ad_group_ad_ad_legacy_responsive_display_ad_logo_image 광고에 사용된 로고 이미지의 MediaFile 리소스 이름입니다. EnhancedDisplayCreativeLandscapeLogoImageMediaId
ad_group_ad_ad_legacy_responsive_display_ad_long_headline 광고 제목의 긴 버전입니다. LongHeadline
ad_group_ad_ad_legacy_responsive_display_ad_main_color 광고의 기본 색상(16진수)입니다. 예를 들어 흰색의 경우 #ffffff입니다. main_color와 accent_color 중 하나가 설정된 경우 다른 하나도 필요합니다. MainColor
ad_group_ad_ad_legacy_responsive_display_ad_marketing_image 광고에 사용된 마케팅 이미지의 MediaFile 리소스 이름입니다. EnhancedDisplayCreativeMarketingImageMediaId
ad_group_ad_ad_legacy_responsive_display_ad_price_prefix 가격 앞의 접두사입니다. 예를 들어 '최저'입니다. PricePrefix
ad_group_ad_ad_legacy_responsive_display_ad_promo_text 반응형 광고의 동적 형식에 사용되는 프로모션 문구입니다. 예를 들어 '2일 무료 배송'입니다. PromoText
ad_group_ad_ad_legacy_responsive_display_ad_short_headline 광고 제목의 짧은 버전입니다. ShortHeadline
ad_group_ad_ad_legacy_responsive_display_ad_square_logo_image 광고에 사용되는 정사각형 로고 이미지의 MediaFile 리소스 이름입니다. EnhancedDisplayCreativeLogoImageMediaId
ad_group_ad_ad_legacy_responsive_display_ad_square_marketing_image 광고에 사용된 정사각형 마케팅 이미지의 MediaFile 리소스 이름입니다. EnhancedDisplayCreativeMarketingImageSquareMediaId
ad_group_ad_ad_responsive_display_ad_accent_color 광고의 강조 색상(16진수)입니다. 예를 들어 흰색의 경우 #ffffff입니다. main_color와 accent_color 중 하나가 설정된 경우 다른 하나도 필요합니다. MultiAssetResponsiveDisplayAdAccentColor
ad_group_ad_ad_responsive_display_ad_business_name 광고주 또는 브랜드 이름입니다. 최대 표시 너비는 25입니다. MultiAssetResponsiveDisplayAdBusinessName
ad_group_ad_ad_responsive_display_ad_call_to_action_text 광고의 클릭 유도 문구 텍스트입니다. 최대 표시 너비는 30입니다. MultiAssetResponsiveDisplayAdCallToActionText
ad_group_ad_ad_responsive_display_ad_descriptions 광고의 설명 텍스트입니다. 최대 길이는 90자(영문 기준)입니다. 광고 제목은 1개 이상 5개 이하로 지정할 수 있습니다. MultiAssetResponsiveDisplayAdDescriptions
ad_group_ad_ad_responsive_display_ad_format_setting 광고가 게재되는 형식을 지정합니다. 기본값은 ALL_FORMATS입니다. MultiAssetResponsiveDisplayAdFormatSetting
ad_group_ad_ad_responsive_display_ad_headlines 광고의 짧은 형식 광고 제목입니다. 최대 길이는 30자(영문 기준)입니다. 광고 제목은 1개 이상 5개 이하로 지정할 수 있습니다. MultiAssetResponsiveDisplayAdHeadlines
ad_group_ad_ad_responsive_display_ad_logo_images 광고에 사용할 로고 이미지입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 512x128이며 가로세로 비율은 4:1 (+/-1%)이어야 합니다. square_logo_images와 합쳐 최대 5개입니다. MultiAssetResponsiveDisplayAdLandscapeLogoImages
ad_group_ad_ad_responsive_display_ad_long_headline 필수 긴 형식 광고 제목입니다. 최대 길이는 90자(영문 기준)입니다. MultiAssetResponsiveDisplayAdLongHeadline
ad_group_ad_ad_responsive_display_ad_main_color 광고의 기본 색상(16진수)입니다. 예를 들어 흰색의 경우 #ffffff입니다. main_color와 accent_color 중 하나가 설정된 경우 다른 하나도 필요합니다. MultiAssetResponsiveDisplayAdMainColor
ad_group_ad_ad_responsive_display_ad_marketing_images 광고에 사용할 마케팅 이미지입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 600x314이며 가로세로 비율은 1.91:1(±1%)이어야 합니다. marketing_image가 하나 이상 필요합니다. square_marketing_images와 합쳐 최대 15개입니다. MultiAssetResponsiveDisplayAdMarketingImages
ad_group_ad_ad_responsive_display_ad_price_prefix 가격 앞의 접두사입니다. 예를 들어 '최저'입니다. MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix
ad_group_ad_ad_responsive_display_ad_promo_text 반응형 광고의 동적 형식에 사용되는 프로모션 문구입니다. 예를 들어 '2일 무료 배송'입니다. MultiAssetResponsiveDisplayAdDynamicSettingsPromoText
ad_group_ad_ad_responsive_display_ad_square_logo_images 광고에 사용할 정사각형 로고 이미지입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 128x128이며 가로세로 비율은 1:1(±1%)이어야 합니다. square_logo_images와 합쳐 최대 5개입니다. MultiAssetResponsiveDisplayAdLogoImages
ad_group_ad_ad_responsive_display_ad_square_marketing_images 광고에 사용할 정사각형 마케팅 이미지입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 300x300이며 가로세로 비율은 1:1 (+/-1%)이어야 합니다. 정사각형 marketing_image가 하나 이상 필요합니다. marketing_images와 합쳐 최대 15개입니다. MultiAssetResponsiveDisplayAdSquareMarketingImages
ad_group_ad_ad_responsive_display_ad_youtube_videos 광고에 사용할 선택사항인 YouTube 동영상입니다. 최대 5개의 동영상을 지정할 수 있습니다. MultiAssetResponsiveDisplayAdYouTubeVideos
ad_group_ad_ad_responsive_search_ad_descriptions 설명에 사용할 텍스트 애셋 목록입니다. 광고가 내용 입력란을 게재할 때 이 목록에서 선택됩니다. ResponsiveSearchAdDescriptions
ad_group_ad_ad_responsive_search_ad_headlines 광고 제목의 텍스트 애셋 목록입니다. 광고가 광고 제목을 게재할 때 이 목록에서 선택됩니다. ResponsiveSearchAdHeadlines
ad_group_ad_ad_responsive_search_ad_path1 광고에 표시되는 URL에 추가될 수 있는 텍스트의 첫 번째 부분입니다. ResponsiveSearchAdPath1
ad_group_ad_ad_responsive_search_ad_path2 광고에 표시되는 URL에 추가될 수 있는 텍스트의 두 번째 부분입니다. 이 필드는 path1도 설정된 경우에만 설정할 수 있습니다. ResponsiveSearchAdPath2
ad_group_ad_ad_strength 이 광고 그룹 광고의 전체 광고 효력입니다. AdStrengthInfo
ad_group_ad_ad_system_managed_resource_source 이 광고가 시스템 관리 광고인 경우 이 필드는 소스를 나타냅니다. 이 필드는 읽기 전용입니다. SystemManagedEntitySource
ad_group_ad_ad_text_ad_description1 광고 설명의 첫 번째 줄입니다. Description1
ad_group_ad_ad_text_ad_description2 광고 설명의 두 번째 줄입니다. Description2
ad_group_ad_ad_text_ad_headline 광고의 제목입니다. Headline
ad_group_ad_ad_tracking_url_template 추적 URL을 만들기 위한 URL 템플릿입니다. CreativeTrackingUrlTemplate
ad_group_ad_ad_type 광고의 유형입니다. AdType
ad_group_ad_ad_url_custom_parameters `tracking_url_template`, `final_urls`, `mobile_final_urls`에서 맞춤 매개변수 태그를 대체하는 데 사용할 수 있는 매핑 목록입니다. 변경의 경우 URL 맞춤 매개변수 작업을 사용하세요. CreativeUrlCustomParameters
ad_group_ad_status 광고의 상태입니다. 상태
ad_group_id 출력 전용입니다. 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: AdBasicStats

Google Ads API 리소스: ad_group_ad

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_group 광고가 속한 광고 그룹입니다.
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 출력 전용입니다. 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_slot 광고의 게재순위입니다. 슬롯

Google Ads 표 이름: AdConversionStats

Google Ads API 리소스: ad_group_ad

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_group 광고가 속한 광고 그룹입니다.
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 출력 전용입니다. 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_slot 광고의 게재순위입니다. 슬롯
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AdCrossDeviceConversionStats

Google Ads API 리소스: ad_group_ad

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_group 광고가 속한 광고 그룹입니다.
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 출력 전용입니다. 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AdCrossDeviceStats

Google Ads API 리소스: ad_group_ad

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_group 광고가 속한 광고 그룹입니다.
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 출력 전용입니다. 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_absolute_top_impression_percentage 자연 검색 결과 위에 첫 번째 광고로 게재되는 광고 노출수의 비율입니다. AbsoluteTopImpressionPercentage
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_average_page_views 세션당 평균 페이지 조회수입니다. AveragePageviews
metrics_average_time_on_site 모든 세션의 총 시간 (초) / 세션 수 Google 애널리틱스에서 가져왔습니다. AverageTimeOnSite
metrics_bounce_rate 사용자가 사이트에서 단일 페이지를 방문한 클릭의 비율입니다. Google 애널리틱스에서 가져옴 BounceRate
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_percent_new_visitors 이전에 내 사이트를 방문한 적이 없는 사용자의 첫 번째 세션 비율입니다. Google 애널리틱스에서 가져옴 PercentNewVisitors
metrics_top_impression_percentage 자연 검색 결과 위에 광고가 노출된 횟수의 비율입니다. TopImpressionPercentage
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AdGroup

Google Ads API 리소스: ad_group

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_rotation_mode 광고 그룹의 광고 로테이션 모드입니다. AdRotationMode
ad_group_cpc_bid_micros 최대 CPC(클릭당비용) 입찰가입니다. CpcBid
ad_group_cpm_bid_micros 최대 CPM (조회 가능 노출 1,000회당 비용) 입찰가입니다. CpmBidStr
ad_group_cpv_bid_micros CPV (조회당비용) 입찰가입니다. CpvBid
ad_group_display_custom_bid_dimension 광고주가 절대 입찰가를 적용할 타겟팅 측정기준을 지정할 수 있습니다. 이 설정은 검색이 아닌 디스플레이 네트워크만 타겟팅하는 캠페인에만 적용됩니다. ContentBidCriterionTypeGroup
ad_group_effective_target_cpa_micros 효과적인 타겟 CPA (전환당비용)입니다. 이 필드는 읽기 전용입니다. TargetCpa
ad_group_effective_target_cpa_source 효과적인 타겟 CPA의 소스입니다. 이 필드는 읽기 전용입니다. TargetCpaBidSource
ad_group_effective_target_roas 유효 타겟 ROAS (광고 투자수익)입니다. 이 필드는 읽기 전용입니다. EffectiveTargetRoas
ad_group_effective_target_roas_source 유효 타겟 ROAS의 소스입니다. 이 필드는 읽기 전용입니다. EffectiveTargetRoasSource
ad_group_id 광고 그룹의 ID입니다. AdGroupId
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다. AdGroupName
ad_group_status 광고 그룹의 상태입니다. AdGroupStatus
ad_group_tracking_url_template 추적 URL을 만들기 위한 URL 템플릿입니다. TrackingUrlTemplate
ad_group_type 광고 그룹의 유형입니다. AdGroupType
ad_group_url_custom_parameters `tracking_url_template`, `final_urls` 또는 `mobile_final_urls`에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다. UrlCustomParameters
campaign_bidding_strategy 캠페인에서 사용하는 포트폴리오 입찰 전략입니다. BiddingStrategyId
campaign_bidding_strategy_type 입찰 전략의 유형입니다. 입찰 스킴을 설정해서 표준 입찰 전략을 만들거나 `bidding_strategy` 필드를 설정해서 포트폴리오 입찰 전략을 만드는 방식으로 입찰 전략을 만들 수 있습니다. 이 필드는 읽기 전용입니다. BiddingStrategyType
campaign_id 캠페인의 ID입니다. CampaignId
campaign_manual_cpc_enhanced_cpc_enabled 전환 최적화 도구 데이터를 기반으로 입찰가를 향상할지 여부입니다. EnhancedCpcEnabled
campaign_percent_cpc_enhanced_cpc_enabled 전환 가능성에 따라 각 입찰의 입찰가를 상향 또는 하향 조정합니다. 개별 입찰가는 cpc_bid_ceiling_micros를 초과할 수 있지만 캠페인의 평균 입찰가는 초과해서는 안 됩니다.
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: AdGroupAdLabel

Google Ads API 리소스: ad_group_ad_label

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_label_ad_group_ad 라벨이 연결된 광고 그룹 광고입니다.
ad_group_ad_label_label 광고 그룹 광고에 할당된 라벨입니다.
ad_group_ad_label_resource_name 광고 그룹 광고 라벨의 리소스 이름입니다. 광고 그룹 광고 라벨 리소스 이름의 형식은 `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`입니다.
ad_group_id 광고 그룹의 ID입니다.
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
label_id 라벨의 ID입니다. 읽기 전용입니다.
label_name 라벨 이름입니다. 이 필드는 필수이며 새 라벨을 만들 때 비워 두지 않아야 합니다. 이 문자열의 길이는 1~80 사이여야 합니다(1 및 80 포함).
label_resource_name 리소스의 이름입니다. 라벨 리소스 이름의 형식은 다음과 같습니다. `customers/{customer_id}/labels/{label_id}`

Google Ads 테이블 이름: AdGroupAudience

Google Ads API 리소스: ad_group_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다.
ad_group_campaign 광고 그룹이 속한 캠페인입니다.
ad_group_criterion_bid_modifier 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다.
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_criterion_effective_cpc_bid_micros 유효 CPC(클릭당비용) 입찰가입니다.
ad_group_criterion_effective_cpc_bid_source 유효 CPC 입찰가의 소스입니다.
ad_group_criterion_effective_cpm_bid_micros 유효 CPM (조회 가능 노출 1,000회당 비용) 입찰가입니다.
ad_group_criterion_effective_cpm_bid_source 유효 CPM 입찰가의 소스입니다.
ad_group_criterion_final_mobile_urls 모든 교차 도메인 리디렉션 이후에 가능한 최종 모바일 URL 목록입니다.
ad_group_criterion_final_urls 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.
ad_group_criterion_keyword_text 키워드의 텍스트입니다(최대 80자 및 10개 단어).
ad_group_criterion_status 기준의 상태입니다.
ad_group_id 광고 그룹의 ID입니다.
ad_group_targeting_setting_target_restrictions 캠페인 또는 광고 그룹의 범위를 제한하기 위한 타겟팅별 측정기준 설정입니다.
ad_group_tracking_url_template 추적 URL을 만들기 위한 URL 템플릿입니다.
ad_group_url_custom_parameters `tracking_url_template`, `final_urls` 또는 `mobile_final_urls`에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다.
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
campaign_bidding_strategy 캠페인에서 사용하는 포트폴리오 입찰 전략입니다.
customer_id 고객의 ID입니다.

Google Ads 테이블 이름: AdGroupAudienceBasicStats

Google Ads API 리소스: ad_group_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다.
ad_group_campaign 광고 그룹이 속한 캠페인입니다.
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_id 광고 그룹의 ID입니다.
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
customer_id 고객의 ID입니다.
metrics_clicks 클릭수입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다.
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회).
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_slot 광고의 게재순위입니다.

Google Ads 테이블 이름: AdGroupAudienceConversionStats

Google Ads API 리소스: ad_group_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다.
ad_group_campaign 광고 그룹이 속한 캠페인입니다.
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_id 광고 그룹의 ID입니다.
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
customer_id 고객의 ID입니다.
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_all_conversions_value 모든 전환의 총 가치입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다.
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다.
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_conversion_action 전환 액션의 리소스 이름입니다.
segments_conversion_action_category 전환 액션 카테고리입니다.
segments_conversion_action_name 전환 액션 이름입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: AdGroupAudienceNonClickStats

Google Ads API 리소스: ad_group_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다.
ad_group_campaign 광고 그룹이 속한 캠페인입니다.
ad_group_id 광고 그룹의 ID입니다.
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
customer_id 고객의 ID입니다.
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다.
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다.
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다.
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다.
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다.
metrics_video_views 동영상 광고가 조회된 횟수입니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: AdGroupAudienceStats

Google Ads API 리소스: ad_group_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다.
ad_group_campaign 광고 그룹이 속한 캠페인입니다.
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_id 광고 그룹의 ID입니다.
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
customer_id 고객의 ID입니다.
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다.
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다.
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다.
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다.
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다.
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다.
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다.
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다.
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다.
metrics_clicks 클릭수입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다.
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다.
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다.
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다.
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다.
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회).
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_click_type 클릭 유형
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: AdGroupBasicStats

Google Ads API 리소스: ad_group

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_slot 광고의 게재순위입니다. 슬롯

Google Ads 테이블 이름: AdGroupBidModifier

Google Ads API 리소스: ad_group_bid_modifier

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_bid_modifier_ad_group 이 기준이 속한 광고 그룹입니다.
ad_group_bid_modifier_base_ad_group 이 초안 또는 테스트 광고 그룹 입찰가 조정이 생성된 기본 광고 그룹입니다. ad_group이 기본 광고 그룹인 경우 이 필드는 ad_group과 같습니다. 광고 그룹이 초안 또는 시험판에서 생성되었고 해당 기본 광고 그룹이 없는 경우 이 필드는 null입니다. 이 필드는 읽기 전용입니다.
ad_group_bid_modifier_bid_modifier 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 선호 콘텐츠의 경우 범위는 1.0~6.0입니다. 기기 유형을 선택 해제하려면 0을 사용합니다.
ad_group_bid_modifier_bid_modifier_source 입찰가 조정 소스입니다.
ad_group_bid_modifier_criterion_id 입찰가를 수정할 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_bid_modifier_device_type 기기 유형입니다.
ad_group_bid_modifier_resource_name 광고 그룹 입찰가 조정의 리소스 이름입니다. 광고 그룹 입찰가 조정 리소스 이름의 형식은 `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}`입니다.
ad_group_id 광고 그룹의 ID입니다.
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.

Google Ads 테이블 이름: AdGroupConversionStats

Google Ads API 리소스: ad_group

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_slot 광고의 게재순위입니다. 슬롯
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AdGroupCriterion

Google Ads API 리소스: ad_group_criterion

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_criterion_ad_group 기준이 속한 광고 그룹입니다.
ad_group_criterion_bid_modifier 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다.
ad_group_criterion_cpc_bid_micros CPC(클릭당비용) 입찰가입니다.
ad_group_criterion_cpm_bid_micros CPM (조회 가능 노출 1,000회당 비용) 입찰가입니다.
ad_group_criterion_cpv_bid_micros CPC (조회당비용) 입찰가입니다.
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_criterion_display_name 기준의 표시 이름입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_criterion_negative 기준을 타겟팅할지 (`false`) 또는 제외할지 (`true`) 여부입니다.
ad_group_criterion_status 기준의 상태입니다.
ad_group_criterion_type 기준의 유형입니다.
ad_group_id 광고 그룹의 ID입니다.
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.

Google Ads 테이블 이름: AdGroupCriterionLabel

Google Ads API 리소스: ad_group_criterion_label

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_criterion_label_ad_group_criterion 라벨이 연결된 광고 그룹 기준입니다.
ad_group_criterion_label_label 광고 그룹 기준에 할당된 라벨입니다.
ad_group_criterion_label_resource_name 광고 그룹 기준 라벨의 리소스 이름입니다. 광고 그룹 기준 라벨 리소스 이름의 형식은 `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}`입니다.
label_id 라벨의 ID입니다. 읽기 전용입니다.
label_name 라벨 이름입니다. 이 필드는 필수이며 새 라벨을 만들 때 비워 두지 않아야 합니다. 이 문자열의 길이는 1~80 사이여야 합니다(1 및 80 포함).
label_resource_name 리소스의 이름입니다. 라벨 리소스 이름의 형식은 다음과 같습니다. `customers/{customer_id}/labels/{label_id}`

Google Ads 테이블 이름: AdGroupCrossDeviceConversionStats

Google Ads API 리소스: ad_group

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AdGroupCrossDeviceStats

Google Ads API 리소스: ad_group

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_absolute_top_impression_percentage 자연 검색 결과 위에 첫 번째 광고로 게재되는 광고 노출수의 비율입니다. AbsoluteTopImpressionPercentage
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_average_page_views 세션당 평균 페이지 조회수입니다. AveragePageviews
metrics_average_time_on_site 모든 세션의 총 시간 (초) / 세션 수 Google 애널리틱스에서 가져왔습니다. AverageTimeOnSite
metrics_bounce_rate 사용자가 사이트에서 단일 페이지를 방문한 클릭의 비율입니다. Google 애널리틱스에서 가져옴 BounceRate
metrics_content_impression_share 디스플레이 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 콘텐츠 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. ContentImpressionShare
metrics_content_rank_lost_impression_share 디스플레이 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 콘텐츠 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. ContentRankLostImpressionShare
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_percent_new_visitors 이전에 내 사이트를 방문한 적이 없는 사용자의 첫 번째 세션 비율입니다. Google 애널리틱스에서 가져옴 PercentNewVisitors
metrics_phone_calls 오프라인 전화 통화 수입니다. NumOfflineInteractions
metrics_phone_impressions 오프라인 전화 노출수입니다. NumOfflineImpressions
metrics_phone_through_rate 수신된 전화 통화수 (phone_calls)를 전화번호가 표시된 횟수 (phone_impressions)로 나눈 값입니다. OfflineInteractionRate
metrics_relative_ctr 내 클릭률 (CTR)을 내 광고가 게재되는 웹사이트의 모든 광고주의 평균 클릭률로 나눈 값입니다. 디스플레이 네트워크 사이트에서 광고가 동일한 사이트의 다른 광고와 비교하여 얼마나 실적이 좋은지 측정합니다. RelativeCtr
metrics_search_absolute_top_impression_share 가장 눈에 잘 띄는 쇼핑 위치에 표시되는 고객의 쇼핑 또는 검색 광고 노출수의 비율입니다. 자세한 내용은 https://support.google.com/google-ads/answer/7501826을 참고하세요. 0.1 미만의 값은 0.0999로 보고됩니다. SearchAbsoluteTopImpressionShare
metrics_search_budget_lost_absolute_top_impression_share 예산 부족으로 인해 광고가 자연 검색 결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산으로 인한 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostAbsoluteTopImpressionShare
metrics_search_budget_lost_top_impression_share 예산 부족으로 인해 자연 검색 결과 위에 광고가 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산 상실 상단 노출 점유율은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostTopImpressionShare
metrics_search_exact_match_impression_share 키워드 검색 유형과 관계없이 검색 네트워크에서 키워드와 정확히 일치하거나 거의 일치하는 검색어로 인해 발생한 노출의 추정 횟수로 나눈 노출수입니다. 참고: 검색 일치검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchExactMatchImpressionShare
metrics_search_impression_share 검색 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchImpressionShare
metrics_search_rank_lost_absolute_top_impression_share 광고 순위가 낮아 자연 검색 결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위로 인한 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostAbsoluteTopImpressionShare
metrics_search_rank_lost_impression_share 검색 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 검색 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostImpressionShare
metrics_search_rank_lost_top_impression_share 광고 순위가 낮아 자연 검색 결과 위 아무 곳에도 광고가 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostTopImpressionShare
metrics_search_top_impression_share 상단 위치 (자연 검색 결과 위의 모든 곳)에서 발생한 노출수를 상단 위치에서 발생 가능한 예상 노출수와 비교한 값입니다. 참고: 검색 상단 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchTopImpressionShare
metrics_top_impression_percentage 자연 검색 결과 위에 광고가 노출된 횟수의 비율입니다. TopImpressionPercentage
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AdGroupLabel

Google Ads API 리소스: ad_group_label

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_id 광고 그룹의 ID입니다.
ad_group_label_ad_group 라벨이 연결된 광고 그룹입니다.
ad_group_label_label 광고 그룹에 할당된 라벨입니다.
ad_group_label_resource_name 광고 그룹 라벨의 리소스 이름입니다. 광고 그룹 라벨 리소스 이름의 형식은 `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}`입니다.
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
label_id 라벨의 ID입니다. 읽기 전용입니다.
label_name 라벨 이름입니다. 이 필드는 필수이며 새 라벨을 만들 때 비워 두지 않아야 합니다. 이 문자열의 길이는 1~80 사이여야 합니다(1 및 80 포함).
label_resource_name 리소스의 이름입니다. 라벨 리소스 이름의 형식은 다음과 같습니다. `customers/{customer_id}/labels/{label_id}`

Google Ads 테이블 이름: AdGroupStats

Google Ads API 리소스: ad_group

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cost_per_current_model_attributed_conversion 광고 상호작용 비용을 현재 모델 기여 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerCurrentModelAttributedConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_current_model_attributed_conversions 선택한 기여 분석 모델에서 이전 전환 데이터가 어떻게 표시되는지 보여줍니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CurrentModelAttributedConversions
metrics_current_model_attributed_conversions_value 현재 모델에서 기여도가 부여된 전환의 총 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CurrentModelAttributedConversionValue
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다. GmailForwards
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다. GmailSaves
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다. GmailSecondaryClicks
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_value_per_current_model_attributed_conversion 현재 모델의 기여 분석 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerCurrentModelAttributedConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AdStats

Google Ads API 리소스: ad_group_ad

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_group 광고가 속한 광고 그룹입니다.
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 출력 전용입니다. 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cost_per_current_model_attributed_conversion 광고 상호작용 비용을 현재 모델 기여 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerCurrentModelAttributedConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_current_model_attributed_conversions 선택한 기여 분석 모델에서 이전 전환 데이터가 어떻게 표시되는지 보여줍니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CurrentModelAttributedConversions
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다. GmailForwards
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다. GmailSaves
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다. GmailSecondaryClicks
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_value_per_current_model_attributed_conversion 현재 모델의 기여 분석 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerCurrentModelAttributedConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AgeRange

Google Ads API 리소스: age_range_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_age_range_type 연령대의 유형입니다. 기준
ad_group_criterion_bid_modifier 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. BidModifier
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_criterion_effective_cpc_bid_micros 유효 CPC(클릭당비용) 입찰가입니다. CpcBid
ad_group_criterion_effective_cpc_bid_source 유효 CPC 입찰가의 소스입니다. CpcBidSource
ad_group_criterion_effective_cpm_bid_micros 유효 CPM (조회 가능 노출 1,000회당 비용) 입찰가입니다. CpmBidStr
ad_group_criterion_effective_cpm_bid_source 유효 CPM 입찰가의 소스입니다. CpmBidSource
ad_group_criterion_final_mobile_urls 모든 교차 도메인 리디렉션 이후에 가능한 최종 모바일 URL 목록입니다. FinalMobileUrls
ad_group_criterion_final_urls 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. FinalUrls
ad_group_criterion_negative 기준을 타겟팅할지 (`false`) 또는 제외할지 (`true`) 여부입니다. 이 필드는 변경할 수 없습니다. 기준을 긍정에서 부정으로 전환하려면 기준을 삭제한 후 다시 추가하세요. IsNegative
ad_group_criterion_status 기준의 상태입니다. 상태
ad_group_criterion_tracking_url_template 추적 URL을 만들기 위한 URL 템플릿입니다. TrackingUrlTemplate
ad_group_criterion_url_custom_parameters `tracking_url_template`, `final_urls` 또는 `mobile_final_urls`에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다. UrlCustomParameters
ad_group_id 광고 그룹의 ID입니다. AdGroupId
ad_group_targeting_setting_target_restrictions 캠페인 또는 광고 그룹의 범위를 제한하기 위한 타겟팅별 측정기준 설정입니다.
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_bidding_strategy 캠페인에서 사용하는 포트폴리오 입찰 전략입니다. BiddingStrategyId
campaign_bidding_strategy_type 입찰 전략의 유형입니다. 입찰 스킴을 설정해서 표준 입찰 전략을 만들거나 `bidding_strategy` 필드를 설정해서 포트폴리오 입찰 전략을 만드는 방식으로 입찰 전략을 만들 수 있습니다. 이 필드는 읽기 전용입니다. BiddingStrategyType
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: AgeRangeBasicStats

Google Ads API 리소스: age_range_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기

Google Ads 테이블 이름: AgeRangeConversionStats

Google Ads API 리소스: age_range_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AgeRangeNonClickStats

Google Ads API 리소스: age_range_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: AgeRangeStats

Google Ads API 리소스: age_range_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다. GmailForwards
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다. GmailSaves
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다. GmailSecondaryClicks
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: Asset

Google Ads API 리소스: asset

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
asset_final_urls 출력 전용입니다. 애셋 유형입니다.
asset_name 애셋의 선택적 이름입니다.
asset_source 출력 전용입니다. 애셋의 소스입니다.
asset_type 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.
segments_conversion_action 전환 액션의 리소스 이름입니다.

Google Ads 테이블 이름: AssetGroup

Google Ads API 리소스: asset_group

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
asset_group_campaign 변경할 수 없습니다. 이 애셋 그룹이 연결된 캠페인입니다. 애셋 그룹에 연결된 애셋입니다.
asset_group_final_mobile_urls 모든 교차 도메인 리디렉션 이후의 최종 모바일 URL 목록입니다. 실적 최대화 캠페인에서는 선택 해제하지 않는 한 URL이 기본적으로 확장될 수 있습니다.
asset_group_final_urls 모든 교차 도메인 리디렉션 이후의 최종 URL 목록입니다. 실적 최대화 캠페인에서는 선택 해제하지 않는 한 URL이 기본적으로 확장될 수 있습니다.
asset_group_id 출력 전용입니다. 애셋 그룹의 ID입니다.
asset_group_name 필수 항목입니다. 애셋 그룹의 이름입니다. 필수 항목입니다. 길이는 최소 1, 최대 128이어야 합니다. 캠페인 내에서 고유해야 합니다.
asset_group_status 애셋 그룹의 상태입니다.

Google Ads 테이블 이름: AssetGroupAsset

Google Ads API 리소스: asset_group_asset

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
asset_group_asset_asset 이 애셋 그룹 애셋이 연결된 애셋입니다.
asset_group_asset_asset_group 이 애셋 그룹 애셋이 연결된 애셋 그룹입니다.
asset_group_asset_field_type 애셋 그룹 내 애셋의 배치에 대한 설명입니다. 예: HEADLINE, YOUTUBE_VIDEO
asset_group_asset_performance_label 이 애셋 그룹 애셋의 실적입니다.
asset_group_asset_policy_summary_approval_status 개별 정책 주제 항목의 상태를 기반으로 계산되는 전체 승인 상태입니다.
asset_group_asset_policy_summary_policy_topic_entries 정책 발견 목록입니다.
asset_group_asset_policy_summary_review_status 검토 프로세스에서 리소스가 있는 위치입니다.

Google Ads 테이블 이름: AssetGroupListingGroupFilter

Google Ads API 리소스: asset_group_listing_group_filter

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
asset_group_listing_group_filter_asset_group 이 애셋 그룹 등록정보 그룹 필터가 속한 애셋 그룹입니다.
asset_group_listing_group_filter_case_value_product_bidding_category_id (obsolete - use asset_group_listing_group_filter_case_value_product_category_category_id instead) 제품 입찰 카테고리의 ID입니다. 이 ID는 이 문서에 설명된 google_product_category ID와 동일합니다. https://support.google.com/merchants/answer/6324436
asset_group_listing_group_filter_case_value_product_bidding_category_level (obsolete - use asset_group_listing_group_filter_case_value_product_category_level instead) 분류의 카테고리 수준을 나타냅니다.
asset_group_listing_group_filter_case_value_product_brand_value 제품 브랜드의 문자열 값입니다.
asset_group_listing_group_filter_case_value_product_channel_channel 지역 값입니다.
asset_group_listing_group_filter_case_value_product_condition_condition 조건 값입니다.
asset_group_listing_group_filter_case_value_product_custom_attribute_index 맞춤 속성의 색인을 나타냅니다.
asset_group_listing_group_filter_case_value_product_custom_attribute_value 제품 맞춤 속성의 문자열 값입니다.
asset_group_listing_group_filter_case_value_product_item_id_value ID 값입니다.
asset_group_listing_group_filter_case_value_product_type_level 유형의 수준입니다.
asset_group_listing_group_filter_case_value_product_type_value 유형의 값입니다.
asset_group_listing_group_filter_id ListingGroupFilter의 ID입니다.
asset_group_listing_group_filter_parent_listing_group_filter 상위 등록정보 그룹 하위 분류의 리소스 이름입니다. 루트 등록정보 그룹 필터 노드의 경우 null입니다.
asset_group_listing_group_filter_type 등록정보 그룹 필터 노드의 유형입니다.
asset_group_listing_group_filter_vertical (obsolete - use asset_group_listing_group_filter_listing_source instead) 현재 노드 트리가 나타내는 카테고리입니다. 동일한 트리에 있는 모든 노드는 동일한 카테고리에 속해야 합니다.

Google Ads 테이블 이름: AssetGroupProductGroupStats

Google Ads API 리소스: asset_group_product_group_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
asset_group_product_group_view_asset_group 등록정보 그룹 필터와 연결된 애셋 그룹입니다.
asset_group_product_group_view_asset_group_listing_group_filter 애셋 그룹 등록정보 그룹 필터의 리소스 이름입니다.
asset_group_product_group_view_resource_name 애셋 그룹 제품 그룹 뷰의 리소스 이름입니다. 애셋 그룹 제품 그룹 뷰 리소스 이름의 형식은 customers/{customer_id}/assetGroupProductGroupViews/{asset_group_id}~{listing_group_filter_id}입니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다.
metrics_clicks 클릭수입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용하는 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
metrics_conversions_value 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용하는 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018년 4월 1일에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: AssetGroupSignal

Google Ads API 리소스: asset_group_signal

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
asset_group_signal_asset_group 이 애셋 그룹 신호가 속한 애셋 그룹입니다.
asset_group_signal_audience_audience 잠재고객 리소스 이름입니다.
asset_group_signal_resource_name 애셋 그룹 신호의 리소스 이름입니다. 애셋 그룹 신호 리소스 이름 형식은 customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}입니다.

Google Ads 테이블 이름: Audience

Google Ads API 리소스: audience

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
audience_description 이 잠재고객에 대한 설명입니다.
audience_dimensions 잠재고객 구성을 지정하는 긍정적 측정기준입니다.
audience_exclusion_dimension 잠재고객 구성을 지정하는 음수 측정기준입니다.
audience_id 잠재고객의 ID입니다.
audience_name 잠재고객의 이름입니다. 모든 잠재고객에서 고유해야 합니다. 길이는 최소 1, 최대 255여야 합니다.
audience_status 이 잠재고객의 상태입니다. 잠재고객이 사용 설정되었는지 삭제되었는지를 나타냅니다.

Google Ads 테이블 이름: BidGoal

Google Ads API 리소스: bidding_strategy

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
bidding_strategy_id 입찰 전략의 ID입니다. BidStrategyID
bidding_strategy_name 입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다. 이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다. 이름
bidding_strategy_status 입찰 전략의 상태입니다. 이 필드는 읽기 전용입니다. 상태
bidding_strategy_target_cpa_cpc_bid_ceiling_micros 입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 이 한도는 전략에서 관리하는 모든 키워드에 적용됩니다. TargetCpaMaxCpcBidCeiling
bidding_strategy_target_cpa_cpc_bid_floor_micros 입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 이 한도는 전략에서 관리하는 모든 키워드에 적용됩니다. TargetCpaMaxCpcBidFloor
bidding_strategy_target_cpa_target_cpa_micros 평균 CPA 타겟입니다. 이 타겟은 계정의 통화를 기준으로 최소 청구 가능 단위보다 크거나 같아야 합니다. TargetCpa
bidding_strategy_target_roas_cpc_bid_ceiling_micros 입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 이 한도는 전략에서 관리하는 모든 키워드에 적용됩니다. TargetRoasBidCeiling
bidding_strategy_target_roas_cpc_bid_floor_micros 입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 이 한도는 전략에서 관리하는 모든 키워드에 적용됩니다. TargetRoasBidFloor
bidding_strategy_target_roas_target_roas 필수 항목입니다. 지출 단위당 원하는 수익 (전환 데이터 기준)입니다. 값은 0.01~1000.0 사이여야 합니다(0.01 및 1000.0 포함). TargetRoas
bidding_strategy_target_spend_cpc_bid_ceiling_micros 입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 이 한도는 전략에서 관리하는 모든 키워드에 적용됩니다. TargetSpendBidCeiling
bidding_strategy_target_spend_target_spend_micros 클릭수를 최대화할 지출 목표입니다. TargetSpend 입찰자는 이 값 또는 자연 제한 지출 금액 중 더 작은 값을 지출하려고 시도합니다. 지정하지 않으면 예산이 지출 목표로 사용됩니다. TargetSpendSpendTarget
bidding_strategy_type 입찰 전략의 유형입니다. 입찰 스킴을 설정하여 입찰 전략을 만듭니다. 이 필드는 읽기 전용입니다. 유형
customer_descriptive_name 고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다. AccountDescriptiveName
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: BidGoalConversionStats

Google Ads API 리소스: bidding_strategy

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
bidding_strategy_campaign_count 이 입찰 전략에 연결된 캠페인의 수입니다. 이 필드는 읽기 전용입니다. CampaignCount
bidding_strategy_id 입찰 전략의 ID입니다. BidStrategyID
bidding_strategy_non_removed_campaign_count 이 입찰 전략에 연결되어 있으며 삭제되지 않은 캠페인의 수입니다. 이 필드는 읽기 전용입니다. NonRemovedCampaignCount
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: BidGoalStats

Google Ads API 리소스: bidding_strategy

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
bidding_strategy_campaign_count 이 입찰 전략에 연결된 캠페인의 수입니다. 이 필드는 읽기 전용입니다. CampaignCount
bidding_strategy_id 입찰 전략의 ID입니다. BidStrategyID
bidding_strategy_non_removed_campaign_count 이 입찰 전략에 연결되어 있으며 삭제되지 않은 캠페인의 수입니다. 이 필드는 읽기 전용입니다. NonRemovedCampaignCount
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다.
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 표 이름: 예산

Google Ads API 리소스: campaign_budget

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_budget_amount_micros 예산 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 월별 지출은 이 금액의 30.4배로 제한됩니다. 금액
campaign_budget_delivery_method 캠페인 예산의 소비율을 결정하는 게재 방법입니다. 만들기 작업에서 지정되지 않은 경우 기본적으로 STANDARD입니다. DeliveryMethod
campaign_budget_explicitly_shared 예산이 명시적으로 공유되는지 여부를 지정합니다. 만들기 작업에서 지정되지 않은 경우 기본값은 true입니다. true인 경우 하나 이상의 캠페인에서 공유할 목적으로 예산이 생성되었습니다. false인 경우 예산은 단일 캠페인에서만 사용하기 위해 생성된 것입니다. 예산의 이름과 상태는 캠페인의 이름과 상태와 동기화됩니다. 두 번째 캠페인과 예산을 공유하려고 하면 오류가 발생합니다. 공유되지 않은 예산은 명시적으로 공유된 예산이 될 수 있습니다. 동일한 작업에서 예산에 이름을 할당해야 합니다. 공유 캠페인 예산은 공유되지 않는 예산이 될 수 없습니다. IsBudgetExplicitlyShared
campaign_budget_has_recommended_budget 이 캠페인 예산에 추천 예산이 있는지 여부를 나타냅니다. 이 필드는 읽기 전용입니다. HasRecommendedBudget
campaign_budget_id 캠페인 예산의 ID입니다. 캠페인 예산은 CampaignBudgetService create 작업을 사용하여 생성되며 예산 ID가 할당됩니다. 예산 ID는 여러 캠페인에서 공유할 수 있습니다. 시스템은 최적의 결과를 얻기 위해 여러 캠페인에 캠페인 예산을 할당합니다. BudgetId
campaign_budget_name 캠페인 예산의 이름입니다. CampaignBudgetService를 통해 캠페인 예산을 만들 때 명시적으로 공유된 모든 캠페인 예산에는 null이 아니고 비어 있지 않은 이름이 있어야 합니다. 명시적으로 공유되지 않은 캠페인 예산은 연결된 캠페인의 이름에서 이름을 가져옵니다. 이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다. BudgetName
campaign_budget_period 예산을 지출할 기간입니다. 지정하지 않으면 기본적으로 DAILY입니다. 기간
campaign_budget_recommended_budget_amount_micros 추천 예산 금액입니다. 사용 가능한 추천이 없으면 예산 금액으로 설정됩니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 이 필드는 읽기 전용입니다. RecommendedBudgetAmount
campaign_budget_reference_count 예산을 활발하게 사용하는 캠페인 수입니다. 이 필드는 읽기 전용입니다. BudgetReferenceCount
campaign_budget_status 이 캠페인 예산의 상태입니다. 이 필드는 읽기 전용입니다. BudgetStatus
campaign_budget_total_amount_micros 예산의 평생 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. TotalAmount
customer_descriptive_name 고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다. AccountDescriptiveName
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 표 이름: BudgetStats

Google Ads API 리소스: campaign_budget

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_budget_id 캠페인 예산의 ID입니다. 캠페인 예산은 CampaignBudgetService create 작업을 사용하여 생성되며 예산 ID가 할당됩니다. 예산 ID는 여러 캠페인에서 공유할 수 있습니다. 그러면 시스템에서 최적의 결과를 얻기 위해 여러 캠페인에 캠페인 예산을 할당합니다. BudgetId
campaign_budget_recommended_budget_estimated_change_weekly_clicks 권장 예산을 적용할 경우 예상되는 주간 클릭수 변동치입니다. 이 필드는 읽기 전용입니다. RecommendedBudgetEstimatedChangeInWeeklyClicks
campaign_budget_recommended_budget_estimated_change_weekly_cost_micros 권장 예산을 적용할 경우 주간 비용의 예상 변동치(마이크로 단위)입니다. 100만은 통화 단위 1에 해당합니다. 이 필드는 읽기 전용입니다. RecommendedBudgetEstimatedChangeInWeeklyCost
campaign_budget_recommended_budget_estimated_change_weekly_interactions 권장 예산을 적용할 경우 주간 상호작용의 예상 변동치입니다. 이 필드는 읽기 전용입니다. RecommendedBudgetEstimatedChangeInWeeklyInteractions
campaign_budget_recommended_budget_estimated_change_weekly_views 권장 예산을 적용할 경우 예상되는 주간 조회수 변동치입니다. 이 필드는 읽기 전용입니다. RecommendedBudgetEstimatedChangeInWeeklyViews
campaign_id 캠페인의 ID입니다. AssociatedCampaignId
campaign_name 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다. AssociatedCampaignName
campaign_status 캠페인의 상태입니다. 새 캠페인이 추가되면 상태는 기본적으로 ENABLED로 설정됩니다. AssociatedCampaignStatus
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.

Google Ads 표 이름: Campaign

Google Ads API 리소스: campaign

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
bidding_strategy_name 입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다. 이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다. BiddingStrategyName
campaign_advertising_channel_sub_type `advertising_channel_type`에 대한 선택적 미세 조정입니다. 상위 채널 유형의 유효한 하위 유형이어야 합니다. 캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다. AdvertisingChannelSubType
campaign_advertising_channel_type 캠페인 내 광고의 기본 게재 타겟입니다. 타겟팅 옵션은 `network_settings`에서 미세 조정할 수 있습니다. 이 필드는 필수이며 새 캠페인을 만들 때 비워두지 않아야 합니다. 캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다. AdvertisingChannelType
campaign_bidding_strategy 캠페인에서 사용하는 포트폴리오 입찰 전략입니다. BiddingStrategyId
campaign_bidding_strategy_type 입찰 전략의 유형입니다. 입찰 스킴을 설정해서 표준 입찰 전략을 만들거나 `bidding_strategy` 필드를 설정해서 포트폴리오 입찰 전략을 만드는 방식으로 입찰 전략을 만들 수 있습니다. 이 필드는 읽기 전용입니다. BiddingStrategyType
campaign_budget_amount_micros 예산 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 월별 지출은 이 금액의 30.4배로 제한됩니다. 금액
campaign_budget_explicitly_shared 예산이 명시적으로 공유되는지 여부를 지정합니다. 만들기 작업에서 지정되지 않은 경우 기본값은 true입니다. true인 경우 하나 이상의 캠페인에서 공유할 목적으로 예산이 생성되었습니다. false인 경우 예산은 단일 캠페인에서만 사용하기 위해 생성된 것입니다. 예산의 이름과 상태는 캠페인의 이름과 상태와 동기화됩니다. 두 번째 캠페인과 예산을 공유하려고 하면 오류가 발생합니다. 공유되지 않은 예산은 명시적으로 공유된 예산이 될 수 있습니다. 동일한 작업에서 예산에 이름을 할당해야 합니다. 공유 캠페인 예산은 공유되지 않는 예산이 될 수 없습니다. IsBudgetExplicitlyShared
campaign_budget_has_recommended_budget 이 캠페인 예산에 추천 예산이 있는지 여부를 나타냅니다. 이 필드는 읽기 전용입니다. HasRecommendedBudget
campaign_budget_period 예산을 지출할 기간입니다. 지정하지 않으면 기본적으로 DAILY입니다. 기간
campaign_budget_recommended_budget_amount_micros 추천 예산 금액입니다. 사용 가능한 추천이 없으면 예산 금액으로 설정됩니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 이 필드는 읽기 전용입니다. RecommendedBudgetAmount
campaign_budget_total_amount_micros 예산의 평생 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. TotalAmount
campaign_campaign_budget 캠페인의 예산입니다. BudgetId
campaign_end_date 캠페인이 종료된 날짜입니다. 이 필드는 WHERE 절에서 사용하면 안 됩니다. EndDate
campaign_experiment_type 캠페인 유형(일반, 초안 또는 실험)입니다. CampaignTrialType
campaign_id 캠페인의 ID입니다. CampaignId
campaign_manual_cpc_enhanced_cpc_enabled 전환 최적화 도구 데이터를 기반으로 입찰가를 향상할지 여부입니다. EnhancedCpcEnabled
campaign_maximize_conversion_value_target_roas 타겟 광고 투자수익 (ROAS) 옵션입니다. 설정된 경우 입찰 전략은 타겟 광고 투자수익을 평균화하면서 수익을 극대화합니다. 타겟 ROAS가 높으면 입찰 전략에서 전체 예산을 지출하지 못할 수 있습니다. 타겟 ROAS가 설정되지 않은 경우 입찰 전략은 예산에 대해 가능한 가장 높은 ROAS를 달성하는 것을 목표로 합니다. MaximizeConversionValueTargetRoas
campaign_name 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다. CampaignName
campaign_percent_cpc_enhanced_cpc_enabled 전환 가능성에 따라 각 입찰의 입찰가를 상향 또는 하향 조정합니다. 개별 입찰가는 cpc_bid_ceiling_micros를 초과할 수 있지만 캠페인의 평균 입찰가는 초과해서는 안 됩니다.
campaign_serving_status 캠페인의 광고 게재 상태입니다. ServingStatus
campaign_start_date 캠페인이 시작된 날짜입니다. 이 필드는 WHERE 절에서 사용하면 안 됩니다. StartDate
campaign_status 캠페인의 상태입니다. 새 캠페인이 추가되면 상태는 기본적으로 ENABLED로 설정됩니다. CampaignStatus
campaign_tracking_url_template 추적 URL을 만들기 위한 URL 템플릿입니다. TrackingUrlTemplate
campaign_url_custom_parameters `tracking_url_template`, `final_urls` 또는 `mobile_final_urls`에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다. UrlCustomParameters
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: CampaignAssetStats

Google Ads API 리소스: campaign_asset

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_asset_asset 캠페인에 연결된 애셋입니다.
campaign_asset_campaign 애셋이 연결된 캠페인입니다.
campaign_asset_field_type 연결된 캠페인에서 애셋이 맡는 역할입니다.
campaign_asset_resource_name 캠페인 애셋의 리소스 이름입니다. CampaignAsset 리소스 이름의 형식은 customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}입니다.
campaign_asset_source 캠페인 확장 소재 연결의 소스입니다.
campaign_asset_status 캠페인 확장 소재의 상태입니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다.
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다.
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다.
metrics_clicks 클릭수입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용하는 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
metrics_conversions_value 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용하는 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회).
metrics_top_impression_percentage 자연 검색 결과 위에 첫 번째 광고로 게재되는 광고 노출수의 비율입니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018년 4월 1일에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: CampaignAudience

Google Ads API 리소스: campaign_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
campaign_criterion_bid_modifier 캠페인에서 사용하는 포트폴리오 입찰 전략입니다.
campaign_criterion_criterion_id 출력 전용입니다. 기준의 ID입니다. 변이 중에 이 필드는 무시됩니다.
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다.

Google Ads 테이블 이름: CampaignAudienceBasicStats

Google Ads API 리소스: campaign_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
campaign_criterion_criterion_id 출력 전용입니다. 기준의 ID입니다. 변이 중에 이 필드는 무시됩니다.
customer_id 고객의 ID입니다.
metrics_clicks 클릭수입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다.
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회).
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_slot 광고의 게재순위입니다.

Google Ads 테이블 이름: CampaignAudienceConversionStats

Google Ads API 리소스: campaign_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
campaign_criterion_criterion_id 출력 전용입니다. 기준의 ID입니다. 변이 중에 이 필드는 무시됩니다.
customer_id 고객의 ID입니다.
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_all_conversions_value 모든 전환의 총 가치입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다.
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다.
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_conversion_action 전환 액션의 리소스 이름입니다.
segments_conversion_action_category 전환 액션 카테고리입니다.
segments_conversion_action_name 전환 액션 이름입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: CampaignAudienceNonClickStats

Google Ads API 리소스: campaign_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
customer_id 고객의 ID입니다.
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다.
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다.
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다.
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다.
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다.
metrics_video_views 동영상 광고가 조회된 횟수입니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: CampaignAudienceStats

Google Ads API 리소스: campaign_audience_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다.
campaign_criterion_criterion_id 출력 전용입니다. 기준의 ID입니다. 변이 중에 이 필드는 무시됩니다.
customer_id 고객의 ID입니다.
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다.
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다.
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다.
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다.
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다.
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다.
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다.
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다.
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다.
metrics_clicks 클릭수입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다.
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다.
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다.
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다.
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다.
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회).
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
segments_ad_network_type 광고 네트워크 유형입니다.
segments_click_type 클릭 유형
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_device 측정항목이 적용되는 기기입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: CampaignBasicStats

Google Ads API 리소스: campaign

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_slot 광고의 게재순위입니다. 슬롯

Google Ads 테이블 이름: CampaignConversionStats

Google Ads API 리소스: campaign

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_conversion_attribution_event_type 전환 기여 분석 이벤트 유형입니다. ConversionAttributionEventType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_slot 광고의 게재순위입니다. 슬롯
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: CampaignCookieStats

Google Ads API 리소스: campaign

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_absolute_top_impression_percentage 자연 검색 결과 위에 첫 번째 광고로 게재되는 광고 노출수의 비율입니다. AbsoluteTopImpressionPercentage
metrics_search_budget_lost_absolute_top_impression_share 예산 부족으로 인해 광고가 자연 검색 결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산으로 인한 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostAbsoluteTopImpressionShare
metrics_search_budget_lost_top_impression_share 예산 부족으로 인해 자연 검색 결과 위에 광고가 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산 상실 상단 노출 점유율은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostTopImpressionShare
metrics_search_rank_lost_absolute_top_impression_share 광고 순위가 낮아 자연 검색 결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위로 인한 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostAbsoluteTopImpressionShare
metrics_search_rank_lost_top_impression_share 광고 순위가 낮아 자연 검색 결과 위 아무 곳에도 광고가 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostTopImpressionShare
metrics_search_top_impression_share 상단 위치 (자연 검색 결과 위의 모든 곳)에서 발생한 노출수를 상단 위치에서 발생 가능한 예상 노출수와 비교한 값입니다. 참고: 검색 상단 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchTopImpressionShare
metrics_top_impression_percentage 자연 검색 결과 위에 광고가 노출된 횟수의 비율입니다. TopImpressionPercentage
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.

Google Ads 테이블 이름: CampaignCriterion

Google Ads API 리소스: campaign_criterion

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_criterion_bid_modifier 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. 기기 유형을 선택 해제하려면 0을 사용합니다.
campaign_criterion_campaign 기준이 속한 캠페인입니다.
campaign_criterion_criterion_id 기준의 ID입니다. 변이 중에 이 필드는 무시됩니다.
campaign_criterion_device_type 기기 유형입니다.
campaign_criterion_display_name 기준의 표시 이름입니다. 이 필드는 변경사항에 대해 무시됩니다.
campaign_criterion_negative 기준을 타겟팅할지 (`false`) 또는 제외할지 (`true`) 여부입니다.
campaign_criterion_status 기준의 상태입니다.
campaign_criterion_type 기준의 유형입니다.
campaign_id 캠페인의 ID입니다.
campaign_name 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.

Google Ads 테이블 이름: CampaignCrossDeviceConversionStats

Google Ads API 리소스: campaign

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_conversion_attribution_event_type 전환 기여 분석 이벤트 유형입니다. ConversionAttributionEventType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: CampaignCrossDeviceStats

Google Ads API 리소스: campaign

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_absolute_top_impression_percentage 자연 검색 결과 위에 첫 번째 광고로 게재되는 광고 노출수의 비율입니다. AbsoluteTopImpressionPercentage
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_average_page_views 세션당 평균 페이지 조회수입니다. AveragePageviews
metrics_average_time_on_site 모든 세션의 총 시간 (초) / 세션 수 Google 애널리틱스에서 가져왔습니다. AverageTimeOnSite
metrics_bounce_rate 사용자가 사이트에서 단일 페이지를 방문한 클릭의 비율입니다. Google 애널리틱스에서 가져옴 BounceRate
metrics_content_budget_lost_impression_share 광고가 디스플레이 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 콘텐츠 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. ContentBudgetLostImpressionShare
metrics_content_impression_share 디스플레이 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 콘텐츠 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. ContentImpressionShare
metrics_content_rank_lost_impression_share 디스플레이 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 콘텐츠 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. ContentRankLostImpressionShare
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_invalid_click_rate 보고 기간 동안 전체 클릭수(필터링된 클릭수 + 필터링되지 않은 클릭수)에서 필터링된 클릭수의 비율입니다. InvalidClickRate
metrics_invalid_clicks Google에서 불법으로 간주하여 비용을 청구하지 않는 클릭수입니다. InvalidClicks
metrics_percent_new_visitors 이전에 내 사이트를 방문한 적이 없는 사용자의 첫 번째 세션 비율입니다. Google 애널리틱스에서 가져옴 PercentNewVisitors
metrics_phone_calls 오프라인 전화 통화 수입니다. NumOfflineInteractions
metrics_phone_impressions 오프라인 전화 노출수입니다. NumOfflineImpressions
metrics_phone_through_rate 수신된 전화 통화수 (phone_calls)를 전화번호가 표시된 횟수 (phone_impressions)로 나눈 값입니다. OfflineInteractionRate
metrics_relative_ctr 내 클릭률 (CTR)을 내 광고가 게재되는 웹사이트의 모든 광고주의 평균 클릭률로 나눈 값입니다. 디스플레이 네트워크 사이트에서 광고가 동일한 사이트의 다른 광고와 비교하여 얼마나 실적이 좋은지 측정합니다. RelativeCtr
metrics_search_absolute_top_impression_share 가장 눈에 잘 띄는 쇼핑 위치에 표시되는 고객의 쇼핑 또는 검색 광고 노출수의 비율입니다. 자세한 내용은 https://support.google.com/google-ads/answer/7501826을 참고하세요. 0.1 미만의 값은 0.0999로 보고됩니다. SearchAbsoluteTopImpressionShare
metrics_search_budget_lost_absolute_top_impression_share 예산 부족으로 인해 광고가 자연 검색 결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산으로 인한 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostAbsoluteTopImpressionShare
metrics_search_budget_lost_impression_share 광고가 검색 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 검색 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostImpressionShare
metrics_search_budget_lost_top_impression_share 예산 부족으로 인해 자연 검색 결과 위에 광고가 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산 상실 상단 노출 점유율은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostTopImpressionShare
metrics_search_click_share 검색 네트워크에서 발생한 클릭수를 발생 가능한 예상 클릭수로 나눈 값입니다. 참고: 검색 클릭 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchClickShare
metrics_search_exact_match_impression_share 키워드 검색 유형과 관계없이 검색 네트워크에서 키워드와 정확히 일치하거나 거의 일치하는 검색어로 인해 발생한 노출의 추정 횟수로 나눈 노출수입니다. 참고: 검색 일치검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchExactMatchImpressionShare
metrics_search_impression_share 검색 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchImpressionShare
metrics_search_rank_lost_absolute_top_impression_share 광고 순위가 낮아 자연 검색 결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위로 인한 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostAbsoluteTopImpressionShare
metrics_search_rank_lost_impression_share 검색 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 검색 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostImpressionShare
metrics_search_rank_lost_top_impression_share 광고 순위가 낮아 자연 검색 결과 위 아무 곳에도 광고가 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostTopImpressionShare
metrics_search_top_impression_share 상단 위치 (자연 검색 결과 위의 모든 곳)에서 발생한 노출수를 상단 위치에서 발생 가능한 예상 노출수와 비교한 값입니다. 참고: 검색 상단 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchTopImpressionShare
metrics_top_impression_percentage 자연 검색 결과 위에 광고가 노출된 횟수의 비율입니다. TopImpressionPercentage
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: CampaignLabel

Google Ads API 리소스: campaign_label

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_id 캠페인의 ID입니다.
campaign_label_campaign 라벨이 연결된 캠페인입니다.
campaign_label_label 캠페인에 할당된 라벨입니다.
campaign_label_resource_name 리소스의 이름입니다. 캠페인 라벨 리소스 이름의 형식은 `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}`입니다.
campaign_name 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
label_id 라벨의 ID입니다. 읽기 전용입니다.
label_name 라벨 이름입니다. 이 필드는 필수이며 새 라벨을 만들 때 비워 두지 않아야 합니다. 이 문자열의 길이는 1~80 사이여야 합니다(1 및 80 포함).
label_resource_name 리소스의 이름입니다. 라벨 리소스 이름의 형식은 다음과 같습니다. `customers/{customer_id}/labels/{label_id}`

Google Ads 테이블 이름: CampaignLocationTargetStats

Google Ads API 리소스: location_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_criterion_criterion_id 기준의 ID입니다. 변이 중에 이 필드는 무시됩니다. CriterionId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: CampaignStats

Google Ads API 리소스: campaign

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cost_per_current_model_attributed_conversion 광고 상호작용 비용을 현재 모델 기여 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerCurrentModelAttributedConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_current_model_attributed_conversions 선택한 기여 분석 모델에서 이전 전환 데이터가 어떻게 표시되는지 보여줍니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CurrentModelAttributedConversions
metrics_current_model_attributed_conversions_value 현재 모델에서 기여도가 부여된 전환의 총 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CurrentModelAttributedConversionValue
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다. GmailForwards
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다. GmailSaves
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다. GmailSecondaryClicks
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_value_per_current_model_attributed_conversion 현재 모델의 기여 분석 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerCurrentModelAttributedConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: ClickStats

Google Ads API 리소스: click_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_id 광고 그룹의 ID입니다. AdGroupId
ad_group_status 광고 그룹의 상태입니다.
campaign_id 캠페인의 ID입니다. CampaignId
click_view_ad_group_ad 연결된 광고입니다. CreativeId
click_view_area_of_interest_city 노출과 연결된 도시 위치 기준입니다. AoiCityCriteriaId
click_view_area_of_interest_country 노출과 연결된 국가 위치 기준입니다. AoiCountryCriteriaId
click_view_area_of_interest_metro 노출과 연결된 대도시권 위치 기준입니다. AoiMetroCriteriaId
click_view_area_of_interest_most_specific 노출과 연결된 가장 구체적인 위치 기준입니다. AoiMostSpecificTargetId
click_view_area_of_interest_region 노출과 연결된 지역 위치 기준입니다. AoiRegionCriteriaId
click_view_gclid Google 클릭 ID입니다. GclId
click_view_keyword 연결된 키워드입니다(있는 경우, 클릭이 검색 채널에 해당하는 경우). CriteriaId
click_view_keyword_info_match_type 키워드의 일치 유형입니다. KeywordMatchType
click_view_keyword_info_text 키워드의 텍스트입니다(최대 80자 및 10개 단어). CriteriaParameters
click_view_location_of_presence_city 노출과 연결된 도시 위치 기준입니다. LopCityCriteriaId
click_view_location_of_presence_country 노출과 연결된 국가 위치 기준입니다. LopCountryCriteriaId
click_view_location_of_presence_metro 노출과 연결된 대도시권 위치 기준입니다. LopMetroCriteriaId
click_view_location_of_presence_most_specific 노출과 연결된 가장 구체적인 위치 기준입니다. LopMostSpecificTargetId
click_view_location_of_presence_region 노출과 연결된 지역 위치 기준입니다. LopRegionCriteriaId
click_view_page_number 광고가 게재된 검색 결과의 페이지 번호입니다. Page
customer_descriptive_name 고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다. AccountDescriptiveName
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_clicks 클릭수입니다. 클릭수
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_slot 광고의 게재순위입니다. 슬롯

Google Ads 표 이름: Customer

Google Ads API 리소스: customer

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
customer_auto_tagging_enabled 고객에 대해 자동 태그 추가가 사용 설정되어 있는지 여부입니다. IsAutoTaggingEnabled
customer_currency_code 계정에 사용되는 통화입니다. ISO 4217 표준의 통화 코드 중 일부가 지원됩니다. AccountCurrencyCode
customer_descriptive_name 고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다. AccountDescriptiveName,CustomerDescriptiveName
customer_id 고객의 ID입니다. ExternalCustomerId
customer_manager 고객이 관리자인지 여부입니다. CanManageClients
customer_test_account 고객이 테스트 계정인지 여부입니다. IsTestAccount
customer_time_zone 고객의 현지 시간대 ID입니다. AccountTimeZone

Google Ads 테이블 이름: DisplayVideoAutomaticPlacementsStats

Google Ads API 리소스: group_placement_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_id 광고 그룹의 ID입니다.
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
campaign_id 캠페인의 ID입니다.
campaign_name 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
customer_id 고객의 ID입니다.
group_placement_view_placement 그룹 수준의 자동 게재위치 문자열입니다(예: 웹 도메인, 모바일 앱 ID 또는 YouTube 채널 ID).
group_placement_view_placement_type 게재위치의 유형입니다. 예를 들어 웹사이트, YouTube 채널, 모바일 애플리케이션이 있습니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다.
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다.
metrics_clicks 클릭수입니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다.
metrics_video_views 동영상 광고가 조회된 횟수입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: DisplayVideoKeywordStats

Google Ads API 리소스: display_keyword_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_criterion_keyword_text 키워드의 텍스트입니다(최대 80자 및 10개 단어).
ad_group_id 광고 그룹의 ID입니다.
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
campaign_advertising_channel_sub_type `advertising_channel_type`에 대한 선택적 미세 조정입니다. 상위 채널 유형의 유효한 하위 유형이어야 합니다. 캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다.
campaign_bidding_strategy_type 입찰 전략의 유형입니다. 입찰 스킴을 설정해서 표준 입찰 전략을 만들거나 `bidding_strategy` 필드를 설정해서 포트폴리오 입찰 전략을 만드는 방식으로 입찰 전략을 만들 수 있습니다. 이 필드는 읽기 전용입니다.
campaign_id 캠페인의 ID입니다.
campaign_name 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
customer_id 고객의 ID입니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다.
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다.
metrics_clicks 클릭수입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다.
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회).
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: DisplayVideoTopicStats

Google Ads API 리소스: topic_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_criterion_status 기준의 상태입니다.
ad_group_criterion_topic_path 타겟팅하거나 제외할 카테고리입니다. 배열의 각 후속 요소는 더 구체적인 하위 카테고리를 설명합니다. 예를 들어 '반려동물 및 동물', '반려동물', '개'는 '반려동물 및 동물/반려동물/개' 카테고리를 나타냅니다.
ad_group_id 광고 그룹의 ID입니다.
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
campaign_id 캠페인의 ID입니다.
campaign_name 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
customer_id 고객의 ID입니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다.
metrics_clicks 클릭수입니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018년 4월 1일에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: Gender

Google Ads API 리소스: gender_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_bid_modifier 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. BidModifier
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_criterion_effective_cpc_bid_micros 유효 CPC(클릭당비용) 입찰가입니다. CpcBid
ad_group_criterion_effective_cpc_bid_source 유효 CPC 입찰가의 소스입니다. CpcBidSource
ad_group_criterion_effective_cpm_bid_micros 유효 CPM (조회 가능 노출 1,000회당 비용) 입찰가입니다. CpmBidStr
ad_group_criterion_effective_cpm_bid_source 유효 CPM 입찰가의 소스입니다. CpmBidSource
ad_group_criterion_final_mobile_urls 모든 교차 도메인 리디렉션 이후에 가능한 최종 모바일 URL 목록입니다. FinalMobileUrls
ad_group_criterion_final_urls 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. FinalUrls
ad_group_criterion_gender_type 성별 유형입니다. 기준
ad_group_criterion_negative 기준을 타겟팅할지 (`false`) 또는 제외할지 (`true`) 여부입니다. 이 필드는 변경할 수 없습니다. 기준을 긍정에서 부정으로 전환하려면 기준을 삭제한 후 다시 추가하세요. IsNegative
ad_group_criterion_status 기준의 상태입니다. 상태
ad_group_criterion_tracking_url_template 추적 URL을 만들기 위한 URL 템플릿입니다. TrackingUrlTemplate
ad_group_criterion_url_custom_parameters `tracking_url_template`, `final_urls` 또는 `mobile_final_urls`에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다. UrlCustomParameters
ad_group_id 광고 그룹의 ID입니다. AdGroupId
ad_group_targeting_setting_target_restrictions 캠페인 또는 광고 그룹의 범위를 제한하기 위한 타겟팅별 측정기준 설정입니다.
bidding_strategy_name 입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다. 이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다. BiddingStrategyName
bidding_strategy_type 입찰 전략의 유형입니다. 입찰 스킴을 설정하여 입찰 전략을 만듭니다. 이 필드는 읽기 전용입니다. BiddingStrategyType
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_bidding_strategy 캠페인에서 사용하는 포트폴리오 입찰 전략입니다. BiddingStrategyId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: GenderBasicStats

Google Ads API 리소스: gender_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기

Google Ads 테이블 이름: GenderConversionStats

Google Ads API 리소스: gender_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: GenderNonClickStats

Google Ads API 리소스: gender_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: GenderStats

Google Ads API 리소스: gender_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다. GmailForwards
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다. GmailSaves
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다. GmailSecondaryClicks
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: GeoConversionStats

Google Ads API 리소스: geographic_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_id 광고 그룹의 ID입니다. AdGroupId
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다. AdGroupName
ad_group_status 광고 그룹의 상태입니다. AdGroupStatus
campaign_id 캠페인의 ID입니다. CampaignId
campaign_status 캠페인의 상태입니다. 새 캠페인이 추가되면 상태는 기본적으로 ENABLED로 설정됩니다.
customer_id 고객의 ID입니다. ExternalCustomerId
geographic_view_country_criterion_id 국가의 기준 ID입니다. CountryCriteriaId
geographic_view_location_type 캠페인의 지역 타겟팅 유형입니다. LocationType
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_geo_target_most_specific_location 가장 구체적인 위치를 나타내는 지역 타겟 상수의 리소스 이름입니다. MostSpecificCriteriaId
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: GeoStats

Google Ads API 리소스: geographic_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_id 광고 그룹의 ID입니다. AdGroupId
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다. AdGroupName
ad_group_status 광고 그룹의 상태입니다. AdGroupStatus
campaign_id 캠페인의 ID입니다. CampaignId
campaign_status 캠페인의 상태입니다. 새 캠페인이 추가되면 상태는 기본적으로 ENABLED로 설정됩니다.
customer_id 고객의 ID입니다. ExternalCustomerId
geographic_view_country_criterion_id 국가의 기준 ID입니다. CountryCriteriaId
geographic_view_location_type 캠페인의 지역 타겟팅 유형입니다. LocationType
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_geo_target_most_specific_location 가장 구체적인 위치를 나타내는 지역 타겟 상수의 리소스 이름입니다. MostSpecificCriteriaId
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: HourlyAccountConversionStats

Google Ads API 리소스: customer

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_hour 시간(0~23 사이의 숫자, 경계 포함) HourOfDay
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: HourlyAccountStats

Google Ads API 리소스: customer

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_hour 시간(0~23 사이의 숫자, 경계 포함) HourOfDay
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: HourlyAdGroupConversionStats

Google Ads API 리소스: ad_group

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_hour 시간(0~23 사이의 숫자, 경계 포함) HourOfDay
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: HourlyAdGroupStats

Google Ads API 리소스: ad_group

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_hour 시간(0~23 사이의 숫자, 경계 포함) HourOfDay
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: HourlyBidGoalStats

Google Ads API 리소스: bidding_strategy

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
bidding_strategy_campaign_count 이 입찰 전략에 연결된 캠페인의 수입니다. 이 필드는 읽기 전용입니다. CampaignCount
bidding_strategy_id 입찰 전략의 ID입니다. BidStrategyID
bidding_strategy_non_removed_campaign_count 이 입찰 전략에 연결되어 있으며 삭제되지 않은 캠페인의 수입니다. 이 필드는 읽기 전용입니다. NonRemovedCampaignCount
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_hour 시간(0~23 사이의 숫자, 경계 포함) HourOfDay
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: HourlyCampaignConversionStats

Google Ads API 리소스: campaign

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_hour 시간(0~23 사이의 숫자, 경계 포함) HourOfDay
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: HourlyCampaignStats

Google Ads API 리소스: campaign

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_hour 시간(0~23 사이의 숫자, 경계 포함) HourOfDay
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 표 이름: Keyword

Google Ads API 리소스: keyword_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_criterion_approval_status 기준의 승인 상태입니다. ApprovalStatus
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_criterion_effective_cpc_bid_micros 유효 CPC(클릭당비용) 입찰가입니다. CpcBid
ad_group_criterion_effective_cpc_bid_source 유효 CPC 입찰가의 소스입니다. CpcBidSource
ad_group_criterion_effective_cpm_bid_micros 유효 CPM (조회 가능 노출 1,000회당 비용) 입찰가입니다. CpmBidStr
ad_group_criterion_final_mobile_urls 모든 교차 도메인 리디렉션 이후에 가능한 최종 모바일 URL 목록입니다. FinalMobileUrls
ad_group_criterion_final_url_suffix 최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다. FinalUrlSuffix
ad_group_criterion_final_urls 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. FinalUrls
ad_group_criterion_keyword_match_type 키워드의 일치 유형입니다. KeywordMatchType
ad_group_criterion_keyword_text 키워드의 텍스트입니다(최대 80자 및 10개 단어). 기준
ad_group_criterion_negative 기준을 타겟팅할지 (`false`) 또는 제외할지 (`true`) 여부입니다. 이 필드는 변경할 수 없습니다. 기준을 긍정에서 부정으로 전환하려면 기준을 삭제한 후 다시 추가하세요. IsNegative
ad_group_criterion_position_estimates_estimated_add_clicks_at_first_position_cpc 키워드 입찰가를 first_position_cpc_micros의 값으로 변경할 경우 주당 예상 클릭수입니다. EstimatedAddClicksAtFirstPositionCpc
ad_group_criterion_position_estimates_estimated_add_cost_at_first_position_cpc 키워드 입찰가를 first_position_cpc_micros의 값으로 변경할 경우 주당 비용이 어떻게 달라지는지 보여줍니다. EstimatedAddCostAtFirstPositionCpc
ad_group_criterion_position_estimates_first_page_cpc_micros 검색 결과의 첫 페이지에 광고가 게재되는 데 필요한 CPC 입찰가의 예상치입니다. FirstPageCpc
ad_group_criterion_position_estimates_first_position_cpc_micros 검색 결과 첫 페이지의 상단에 있는 첫 번째 위치에 광고가 게재되는 데 필요한 CPC 입찰가의 예상치입니다. FirstPositionCpc
ad_group_criterion_position_estimates_top_of_page_cpc_micros 검색 결과 첫 페이지 상단에 광고가 게재되는 데 필요한 CPC 입찰가의 예상치입니다. TopOfPageCpc
ad_group_criterion_quality_info_creative_quality_score 다른 광고주와 비교한 광고의 실적입니다. CreativeQualityScore
ad_group_criterion_quality_info_post_click_quality_score 방문 페이지의 품질평가점수입니다. PostClickQualityScore
ad_group_criterion_quality_info_quality_score 품질평가점수입니다. Google에서 값을 결정하기 위한 정보가 충분하지 않으면 이 필드가 채워지지 않을 수 있습니다. QualityScore
ad_group_criterion_quality_info_search_predicted_ctr 다른 광고주의 클릭률과 비교한 클릭률입니다. SearchPredictedCtr
ad_group_criterion_status 기준의 상태입니다. 상태
ad_group_criterion_system_serving_status 기준의 게재 상태입니다. SystemServingStatus
ad_group_criterion_topic_topic_constant 주제 상수 리소스 이름입니다. VerticalId
ad_group_criterion_tracking_url_template 추적 URL을 만들기 위한 URL 템플릿입니다. TrackingUrlTemplate
ad_group_criterion_url_custom_parameters `tracking_url_template`, `final_urls` 또는 `mobile_final_urls`에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다. UrlCustomParameters
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_bidding_strategy 캠페인에서 사용하는 포트폴리오 입찰 전략입니다. BiddingStrategyId
campaign_bidding_strategy_type 입찰 전략의 유형입니다. 입찰 스킴을 설정해서 표준 입찰 전략을 만들거나 `bidding_strategy` 필드를 설정해서 포트폴리오 입찰 전략을 만드는 방식으로 입찰 전략을 만들 수 있습니다. 이 필드는 읽기 전용입니다. BiddingStrategyType
campaign_id 캠페인의 ID입니다. CampaignId
campaign_manual_cpc_enhanced_cpc_enabled 전환 최적화 도구 데이터를 기반으로 입찰가를 향상할지 여부입니다. EnhancedCpcEnabled
campaign_percent_cpc_enhanced_cpc_enabled 전환 가능성에 따라 각 입찰의 입찰가를 상향 또는 하향 조정합니다. 개별 입찰가는 cpc_bid_ceiling_micros를 초과할 수 있지만 캠페인의 평균 입찰가는 초과해서는 안 됩니다.
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: KeywordBasicStats

Google Ads API 리소스: keyword_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_slot 광고의 게재순위입니다. 슬롯

Google Ads 표 이름: KeywordConversionStats

Google Ads API 리소스: keyword_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_slot 광고의 게재순위입니다. 슬롯
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: KeywordCrossDeviceConversionStats

Google Ads API 리소스: keyword_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: KeywordCrossDeviceStats

Google Ads API 리소스: keyword_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_absolute_top_impression_percentage 자연 검색 결과 위에 첫 번째 광고로 게재되는 광고 노출수의 비율입니다. AbsoluteTopImpressionPercentage
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_average_page_views 세션당 평균 페이지 조회수입니다. AveragePageviews
metrics_average_time_on_site 모든 세션의 총 시간 (초) / 세션 수 Google 애널리틱스에서 가져왔습니다. AverageTimeOnSite
metrics_bounce_rate 사용자가 사이트에서 단일 페이지를 방문한 클릭의 비율입니다. Google 애널리틱스에서 가져옴 BounceRate
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_percent_new_visitors 이전에 내 사이트를 방문한 적이 없는 사용자의 첫 번째 세션 비율입니다. Google 애널리틱스에서 가져옴 PercentNewVisitors
metrics_search_absolute_top_impression_share 가장 눈에 잘 띄는 쇼핑 위치에 표시되는 고객의 쇼핑 또는 검색 광고 노출수의 비율입니다. 자세한 내용은 https://support.google.com/google-ads/answer/7501826을 참고하세요. 0.1 미만의 값은 0.0999로 보고됩니다. SearchAbsoluteTopImpressionShare
metrics_search_budget_lost_absolute_top_impression_share 예산 부족으로 인해 광고가 자연 검색 결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산으로 인한 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostAbsoluteTopImpressionShare
metrics_search_budget_lost_top_impression_share 예산 부족으로 인해 자연 검색 결과 위에 광고가 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산 상실 상단 노출 점유율은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchBudgetLostTopImpressionShare
metrics_search_exact_match_impression_share 키워드 검색 유형과 관계없이 검색 네트워크에서 키워드와 정확히 일치하거나 거의 일치하는 검색어로 인해 발생한 노출의 추정 횟수로 나눈 노출수입니다. 참고: 검색 일치검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchExactMatchImpressionShare
metrics_search_impression_share 검색 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchImpressionShare
metrics_search_rank_lost_absolute_top_impression_share 광고 순위가 낮아 자연 검색 결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위로 인한 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostAbsoluteTopImpressionShare
metrics_search_rank_lost_impression_share 검색 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 검색 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostImpressionShare
metrics_search_rank_lost_top_impression_share 광고 순위가 낮아 자연 검색 결과 위 아무 곳에도 광고가 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. SearchRankLostTopImpressionShare
metrics_search_top_impression_share 상단 위치 (자연 검색 결과 위의 모든 곳)에서 발생한 노출수를 상단 위치에서 발생 가능한 예상 노출수와 비교한 값입니다. 참고: 검색 상단 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchTopImpressionShare
metrics_top_impression_percentage 자연 검색 결과 위에 광고가 노출된 횟수의 비율입니다. TopImpressionPercentage
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: KeywordStats

Google Ads API 리소스: keyword_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cost_per_current_model_attributed_conversion 광고 상호작용 비용을 현재 모델 기여 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerCurrentModelAttributedConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_current_model_attributed_conversions 선택한 기여 분석 모델에서 이전 전환 데이터가 어떻게 표시되는지 보여줍니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CurrentModelAttributedConversions
metrics_current_model_attributed_conversions_value 현재 모델에서 기여도가 부여된 전환의 총 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CurrentModelAttributedConversionValue
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다. GmailForwards
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다. GmailSaves
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다. GmailSecondaryClicks
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_value_per_current_model_attributed_conversion 현재 모델의 기여 분석 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerCurrentModelAttributedConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: LandingPageStats

Google Ads API 리소스: landing_page_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_name 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
ad_group_status 광고 그룹의 상태입니다.
campaign_name 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null (코드 포인트 0x0), NL 라인 피드 (코드 포인트 0xA), 캐리지 리턴 (코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
customer_id 고객의 ID입니다.
landing_page_view_unexpanded_final_url 광고주가 지정한 최종 URL입니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_clicks 클릭수입니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_mobile_friendly_clicks_percentage 모바일 친화적인 페이지로 이동하는 모바일 클릭수의 비율입니다.
metrics_speed_score 모바일 광고 클릭 후 페이지가 로드되는 속도를 측정한 값입니다. 점수는 1부터 10까지이고 10이 가장 빠른 속도를 나타냅니다.
metrics_valid_accelerated_mobile_pages_clicks_percentage 유효한 AMP 페이지에 도달하는 AMP (Accelerated Mobile Pages) 방문 페이지로 연결되는 광고 클릭의 비율입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: LocationBasedCampaignCriterion

Google Ads API 리소스: location_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
campaign_criterion_bid_modifier 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. 기기 유형을 선택 해제하려면 0을 사용합니다. BidModifier
campaign_criterion_criterion_id 기준의 ID입니다. 변이 중에 이 필드는 무시됩니다. CriterionId
campaign_criterion_negative 기준을 타겟팅할지 (`false`) 또는 제외할지 (`true`) 여부입니다. IsNegative
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: LocationsDistanceStats

Google Ads API 리소스: distance_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
customer_id 고객의 ID입니다.
distance_view_distance_bucket 위치 광고 확장에서의 사용자 거리 그룹화입니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_clicks 클릭수입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: LocationsUserLocationsStats

Google Ads API 리소스: user_location_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
customer_id 고객의 ID입니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_clicks 클릭수입니다.
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_geo_target_city 도시를 나타내는 지역 타겟 상수의 리소스 이름입니다.
segments_geo_target_most_specific_location 가장 구체적인 위치를 나타내는 지역 타겟 상수의 리소스 이름입니다.
segments_geo_target_region 지역을 나타내는 지역 타겟 상수의 리소스 이름입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.
user_location_view_country_criterion_id 국가의 기준 ID입니다.
user_location_view_targeting_location 타겟 위치입니다.

Google Ads 테이블 이름: PaidOrganicStats

Google Ads API 리소스: paid_organic_search_term_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_clicks 클릭수입니다. 클릭수
metrics_combined_clicks 광고 또는 무료 결과의 사이트 등록정보가 클릭된 횟수입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요. CombinedAdsOrganicClicks
metrics_combined_clicks_per_query 광고 또는 무료 검색 결과의 사이트 등록정보가 클릭된 횟수 (combined_clicks)를 combined_queries로 나눈 값입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요. CombinedAdsOrganicClicksPerQuery
metrics_combined_queries 무료 결과에서 사이트의 페이지가 반환되거나 텍스트 광고가 표시된 검색 수입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요. CombinedAdsOrganicQueries
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_organic_clicks 특정 검색어에 대한 무료 결과에서 사용자가 내 사이트의 등록정보를 클릭한 횟수입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요. OrganicClicks
metrics_organic_clicks_per_query 무료 검색 결과에서 사용자가 사이트의 등록정보를 클릭한 횟수 (organic_clicks)를 사이트의 페이지를 반환한 총 검색 수 (organic_queries)로 나눈 값입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요. OrganicClicksPerQuery
metrics_organic_impressions 무료 검색 결과에 표시된 내 사이트의 등록정보 수입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요. OrganicImpressions
metrics_organic_impressions_per_query 사이트의 페이지가 무료 검색 결과에 표시된 횟수 (organic_impressions)를 무료 결과에 사이트의 등록정보가 표시된 검색 수 (organic_queries)로 나눈 값입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요. OrganicImpressionsPerQuery
metrics_organic_queries 무료 결과에 사이트의 등록정보가 표시된 총 검색 수입니다. 자세한 내용은 https://support.google.com/google-ads/answer/3097241의 도움말 페이지를 참고하세요. OrganicQueries
paid_organic_search_term_view_search_term 검색어입니다. SearchQuery
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_search_engine_results_page_type 검색엔진 결과 페이지의 유형입니다. SerpType
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 표 이름: ParentalStatus

Google Ads API 리소스: parental_status_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_criterion_effective_cpc_bid_micros 유효 CPC(클릭당비용) 입찰가입니다. CpcBid
ad_group_criterion_effective_cpc_bid_source 유효 CPC 입찰가의 소스입니다. CpcBidSource
ad_group_criterion_effective_cpm_bid_micros 유효 CPM (조회 가능 노출 1,000회당 비용) 입찰가입니다. CpmBidStr
ad_group_criterion_effective_cpm_bid_source 유효 CPM 입찰가의 소스입니다. CpmBidSource
ad_group_criterion_final_mobile_urls 모든 교차 도메인 리디렉션 이후에 가능한 최종 모바일 URL 목록입니다. FinalMobileUrls
ad_group_criterion_final_urls 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. FinalUrls
ad_group_criterion_negative 기준을 타겟팅할지 (`false`) 또는 제외할지 (`true`) 여부입니다. 이 필드는 변경할 수 없습니다. 기준을 긍정에서 부정으로 전환하려면 기준을 삭제한 후 다시 추가하세요. IsNegative
ad_group_criterion_parental_status_type 자녀 유무의 유형입니다. 기준
ad_group_criterion_status 기준의 상태입니다. 상태
ad_group_criterion_tracking_url_template 추적 URL을 만들기 위한 URL 템플릿입니다. TrackingUrlTemplate
ad_group_criterion_url_custom_parameters `tracking_url_template`, `final_urls` 또는 `mobile_final_urls`에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다. UrlCustomParameters
ad_group_id 광고 그룹의 ID입니다. AdGroupId
ad_group_targeting_setting_target_restrictions 캠페인 또는 광고 그룹의 범위를 제한하기 위한 타겟팅별 측정기준 설정입니다.
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_bidding_strategy 캠페인에서 사용하는 포트폴리오 입찰 전략입니다. BiddingStrategyId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: ParentalStatusBasicStats

Google Ads API 리소스: parental_status_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기

Google Ads 테이블 이름: ParentalStatusConversionStats

Google Ads API 리소스: parental_status_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: ParentalStatusNonClickStats

Google Ads API 리소스: parental_status_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 표 이름: ParentalStatusStats

Google Ads API 리소스: parental_status_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다. GmailForwards
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다. GmailSaves
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다. GmailSecondaryClicks
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 표 이름: 게재위치

Google Ads API 리소스: managed_placement_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_bid_modifier 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. BidModifier
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_criterion_effective_cpc_bid_micros 유효 CPC(클릭당비용) 입찰가입니다. CpcBid
ad_group_criterion_effective_cpc_bid_source 유효 CPC 입찰가의 소스입니다. CpcBidSource
ad_group_criterion_effective_cpm_bid_micros 유효 CPM (조회 가능 노출 1,000회당 비용) 입찰가입니다. CpmBidStr
ad_group_criterion_effective_cpm_bid_source 유효 CPM 입찰가의 소스입니다. CpmBidSource
ad_group_criterion_final_mobile_urls 모든 교차 도메인 리디렉션 이후에 가능한 최종 모바일 URL 목록입니다. FinalMobileUrls
ad_group_criterion_final_urls 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. FinalUrls
ad_group_criterion_negative 기준을 타겟팅할지 (`false`) 또는 제외할지 (`true`) 여부입니다. 이 필드는 변경할 수 없습니다. 기준을 긍정에서 부정으로 전환하려면 기준을 삭제한 후 다시 추가하세요. IsNegative
ad_group_criterion_placement_url 게재위치의 URL입니다. 예: 'http://www.domain.com' 기준
ad_group_criterion_status 기준의 상태입니다. 상태
ad_group_criterion_tracking_url_template 추적 URL을 만들기 위한 URL 템플릿입니다. TrackingUrlTemplate
ad_group_criterion_url_custom_parameters `tracking_url_template`, `final_urls` 또는 `mobile_final_urls`에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다. UrlCustomParameters
ad_group_id 광고 그룹의 ID입니다. AdGroupId
ad_group_targeting_setting_target_restrictions 캠페인 또는 광고 그룹의 범위를 제한하기 위한 타겟팅별 측정기준 설정입니다.
bidding_strategy_name 입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다. 이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다. BiddingStrategyName
bidding_strategy_type 입찰 전략의 유형입니다. 입찰 스킴을 설정하여 입찰 전략을 만듭니다. 이 필드는 읽기 전용입니다. BiddingStrategyType
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_bidding_strategy 캠페인에서 사용하는 포트폴리오 입찰 전략입니다. BiddingStrategyId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId

Google Ads 테이블 이름: PlacementBasicStats

Google Ads API 리소스: managed_placement_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기

Google Ads 표 이름: PlacementConversionStats

Google Ads API 리소스: managed_placement_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: PlacementNonClickStats

Google Ads API 리소스: managed_placement_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: PlacementStats

Google Ads API 리소스: managed_placement_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_base_ad_group 초안 또는 실험 광고 그룹의 경우 이 필드는 이 광고 그룹이 생성된 기본 광고 그룹의 리소스 이름입니다. 초안 또는 실험 광고 그룹에 기본 광고 그룹이 없으면 이 필드는 null입니다. 기본 광고 그룹의 경우 이 필드는 광고 그룹 리소스 이름과 같습니다. 이 필드는 읽기 전용입니다. BaseAdGroupId
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다. CriterionId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_base_campaign 임시 캠페인 또는 실험 캠페인의 기본 캠페인의 리소스 이름입니다. 기본 캠페인의 경우 `resource_name`과 같습니다. 이 필드는 읽기 전용입니다. BaseCampaignId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_active_view_cpm 조회 가능 노출수 (`active_view_impressions`)의 평균 비용입니다. ActiveViewCpm
metrics_active_view_ctr Active View 측정 가능 클릭수를 Active View 조회 가능 노출수로 나눈 값입니다. 이 측정항목은 디스플레이 네트워크에 대해서만 보고됩니다. ActiveViewCtr
metrics_active_view_impressions 디스플레이 네트워크 사이트에서 광고가 조회 가능 상태가 된 빈도를 측정한 값입니다. ActiveViewImpressions
metrics_active_view_measurability Active View로 측정할 수 있는 노출수의 게재된 노출수에 대한 비율입니다. ActiveViewMeasurability
metrics_active_view_measurable_cost_micros Active View로 측정할 수 있었던 노출의 비용입니다. ActiveViewMeasurableCost
metrics_active_view_measurable_impressions 광고가 조회 가능한 위치의 게재위치에 게재되는 횟수입니다. ActiveViewMeasurableImpressions
metrics_active_view_viewability Active View가 사용 설정된 사이트에서 광고가 게재되고 (측정 가능 노출수) 조회 가능했던 (조회 가능 노출수) 횟수의 비율입니다. ActiveViewViewability
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate, ConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_gmail_forwards 광고가 메시지로 다른 사용자에게 전달된 횟수입니다. GmailForwards
metrics_gmail_saves 사용자가 Gmail 광고를 받은편지함에 메시지로 저장한 횟수입니다. GmailSaves
metrics_gmail_secondary_clicks Gmail 광고가 펼쳐진 상태에서 방문 페이지로 연결되는 클릭수입니다. GmailSecondaryClicks
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: ProductGroupStats

Google Ads API 리소스: product_group_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_criterion_cpc_bid_micros CPC(클릭당비용) 입찰가입니다.
ad_group_criterion_criterion_id 기준의 ID입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_criterion_display_name 기준의 표시 이름입니다. 이 필드는 변경사항에 대해 무시됩니다.
ad_group_criterion_listing_group_case_value_product_bidding_category_id (obsolete - use ad_group_criterion_listing_group_case_value_product_category_category_id instead) 제품 입찰 카테고리의 ID입니다. 이 ID는 이 문서에 설명된 google_product_category ID와 동일합니다. https://support.google.com/merchants/answer/6324436
ad_group_criterion_listing_group_case_value_product_bidding_category_level (obsolete - use ad_group_criterion_listing_group_case_value_product_category_level instead) 제품 입찰 카테고리의 수준입니다.
ad_group_criterion_listing_group_case_value_product_brand_value 제품 브랜드의 문자열 값입니다.
ad_group_criterion_listing_group_case_value_product_channel_channel 지역 값입니다.
ad_group_criterion_listing_group_case_value_product_channel_exclusivity_channel_exclusivity 재고 값입니다.
ad_group_criterion_listing_group_case_value_product_condition_condition 조건 값입니다.
ad_group_criterion_listing_group_case_value_product_custom_attribute_index 맞춤 속성의 색인을 나타냅니다.
ad_group_criterion_listing_group_case_value_product_custom_attribute_value 제품 맞춤 속성의 문자열 값입니다.
ad_group_criterion_listing_group_case_value_product_item_id_value ID 값입니다.
ad_group_criterion_listing_group_case_value_product_type_level 유형의 수준입니다.
ad_group_criterion_listing_group_case_value_product_type_value 유형의 값입니다.
ad_group_criterion_status 기준의 상태입니다.
ad_group_id 광고 그룹의 ID입니다.
campaign_id 캠페인의 ID입니다.
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다.
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다.
metrics_clicks 클릭수입니다.
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다.
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
product_group_view_resource_name 제품 그룹 뷰의 리소스 이름입니다. 제품 그룹 뷰 리소스 이름의 형식은 customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}입니다.
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다.
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다.
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다.

Google Ads 테이블 이름: SearchQueryConversionStats

Google Ads API 리소스: search_term_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
search_term_view_search_term 검색어입니다. 쿼리
search_term_view_status 검색어가 타겟팅된 키워드 또는 제외된 키워드 중 하나인지 여부를 나타냅니다. QueryTargetingStatus
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_search_term_match_type 변형을 포함하여 광고를 트리거한 키워드의 검색 유형입니다. QueryMatchTypeWithVariant
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: SearchQueryStats

Google Ads API 리소스: search_term_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_absolute_top_impression_percentage 자연 검색 결과 위에 첫 번째 광고로 게재되는 광고 노출수의 비율입니다. AbsoluteTopImpressionPercentage
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cost 상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. AverageCost
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_average_cpe 광고 참여에 대해 청구된 평균 금액입니다. 이 금액은 모든 광고 참여의 총비용을 총 광고 참여수로 나눈 값입니다. AverageCpe
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_interaction_event_types 유료 및 무료 상호작용 유형입니다. InteractionTypes
metrics_interaction_rate 사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. InteractionRate
metrics_interactions 상호작용 수입니다. 상호작용은 광고 형식과 관련된 주요 사용자 액션입니다(예: 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회). 상호작용 수
metrics_top_impression_percentage 자연 검색 결과 위에 광고가 노출된 횟수의 비율입니다. TopImpressionPercentage
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
search_term_view_search_term 검색어입니다. 쿼리
search_term_view_status 검색어가 타겟팅된 키워드 또는 제외된 키워드 중 하나인지 여부를 나타냅니다. QueryTargetingStatus
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018년 4월 1일에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_search_term_match_type 변형을 포함하여 광고를 트리거한 키워드의 검색 유형입니다. QueryMatchTypeWithVariant
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: ShoppingProductConversionStats

Google Ads API 리소스: shopping_performance_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
campaign_status 캠페인의 상태입니다. 새 캠페인이 추가되면 상태는 기본적으로 ENABLED로 설정됩니다.
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_product_aggregator_id 제품의 애그리게이터 ID입니다. AggregatorId
segments_product_bidding_category_level1 (obsolete - use segments_product_category_level1 instead) 제품의 입찰 카테고리(수준 1)입니다. CategoryL1
segments_product_bidding_category_level2 (obsolete - use segments_product_category_level2 instead) 제품의 입찰 카테고리(수준 2)입니다. CategoryL2
segments_product_bidding_category_level3 (obsolete - use segments_product_category_level3 instead) 제품의 입찰 카테고리(수준 3)입니다. CategoryL3
segments_product_bidding_category_level4 (obsolete - use segments_product_category_level4 instead) 제품의 입찰 카테고리(수준 4)입니다. CategoryL4
segments_product_bidding_category_level5 (obsolete - use segments_product_category_level5 instead) 제품의 입찰 카테고리(수준 5)입니다. CategoryL5
segments_product_category_level1 제품의 카테고리 (수준 1)입니다. CategoryL1
segments_product_category_level2 제품의 카테고리 (수준 2)입니다. CategoryL2
segments_product_category_level3 제품의 카테고리 (수준 3)입니다. CategoryL3
segments_product_category_level4 제품의 카테고리 (수준 4)입니다. CategoryL4
segments_product_category_level5 제품의 카테고리 (수준 5)입니다. CategoryL5
segments_product_brand 제품의 브랜드입니다. 브랜드
segments_product_channel 제품의 채널입니다. 채널
segments_product_channel_exclusivity 제품의 단일 채널 판매 여부입니다. ChannelExclusivity
segments_product_condition 제품 상태입니다. ProductCondition
segments_product_country 제품의 판매 국가에 대한 지역 타겟 상수의 리소스 이름입니다. CountryCriteriaId
segments_product_custom_attribute0 제품의 커스텀 속성 0입니다. CustomAttribute0
segments_product_custom_attribute1 제품의 커스텀 속성 1입니다. CustomAttribute1
segments_product_custom_attribute2 제품의 커스텀 속성 2입니다. CustomAttribute2
segments_product_custom_attribute3 제품의 커스텀 속성 3입니다. CustomAttribute3
segments_product_custom_attribute4 제품의 커스텀 속성 4입니다. CustomAttribute4
segments_product_item_id 제품의 상품 ID입니다. OfferId
segments_product_language 제품의 언어에 대한 언어 상수의 리소스 이름입니다. LanguageCriteriaId
segments_product_merchant_id 제품의 판매자 ID입니다. MerchantId
segments_product_store_id 제품의 스토어 ID입니다. StoreId
segments_product_type_l1 제품 유형(수준 1)입니다. ProductTypeL1
segments_product_type_l2 제품 유형(수준 2)입니다. ProductTypeL2
segments_product_type_l3 제품 유형(수준 3)입니다. ProductTypeL3
segments_product_type_l4 제품 유형(수준 4)입니다. ProductTypeL4
segments_product_type_l5 제품 유형(수준 5)입니다. ProductTypeL5
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 테이블 이름: ShoppingProductStats

Google Ads API 리소스: shopping_performance_view

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
campaign_status 캠페인의 상태입니다. 새 캠페인이 추가되면 상태는 기본적으로 ENABLED로 설정됩니다.
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cpc 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. AverageCpc
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_from_interactions_rate 상호작용으로 인한 전환수를 광고 상호작용수(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionRate
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_search_absolute_top_impression_share 가장 눈에 잘 띄는 쇼핑 위치에 표시되는 고객의 쇼핑 또는 검색 광고 노출수의 비율입니다. 자세한 내용은 https://support.google.com/google-ads/answer/7501826을 참고하세요. 0.1 미만의 값은 0.0999로 보고됩니다. SearchAbsoluteTopImpressionShare
metrics_search_click_share 검색 네트워크에서 발생한 클릭수를 발생 가능한 예상 클릭수로 나눈 값입니다. 참고: 검색 클릭 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchClickShare
metrics_search_impression_share 검색 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. SearchImpressionShare
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_value_per_conversion 전환 가치를 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ValuePerConversion
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_product_aggregator_id 제품의 애그리게이터 ID입니다. AggregatorId
segments_product_bidding_category_level1 (obsolete - use segments_product_category_level1 instead) 제품의 입찰 카테고리(수준 1)입니다. CategoryL1
segments_product_bidding_category_level2 (obsolete - use segments_product_category_level2 instead) 제품의 입찰 카테고리(수준 2)입니다. CategoryL2
segments_product_bidding_category_level3 (obsolete - use segments_product_category_level3 instead) 제품의 입찰 카테고리(수준 3)입니다. CategoryL3
segments_product_bidding_category_level4 (obsolete - use segments_product_category_level4 instead) 제품의 입찰 카테고리(수준 4)입니다. CategoryL4
segments_product_bidding_category_level5 (obsolete - use segments_product_category_level5 instead) 제품의 입찰 카테고리(수준 5)입니다. CategoryL5
segments_product_category_level1 제품의 카테고리 (수준 1)입니다. CategoryL1
segments_product_category_level2 제품의 카테고리 (수준 2)입니다. CategoryL2
segments_product_category_level3 제품의 카테고리 (수준 3)입니다. CategoryL3
segments_product_category_level4 제품의 카테고리 (수준 4)입니다. CategoryL4
segments_product_category_level5 제품의 카테고리 (수준 5)입니다. CategoryL5
segments_product_brand 제품의 브랜드입니다. 브랜드
segments_product_channel 제품의 채널입니다. 채널
segments_product_channel_exclusivity 제품의 단일 채널 판매 여부입니다. ChannelExclusivity
segments_product_condition 제품 상태입니다. ProductCondition
segments_product_country 제품의 판매 국가에 대한 지역 타겟 상수의 리소스 이름입니다. CountryCriteriaId
segments_product_custom_attribute0 제품의 커스텀 속성 0입니다. CustomAttribute0
segments_product_custom_attribute1 제품의 커스텀 속성 1입니다. CustomAttribute1
segments_product_custom_attribute2 제품의 커스텀 속성 2입니다. CustomAttribute2
segments_product_custom_attribute3 제품의 커스텀 속성 3입니다. CustomAttribute3
segments_product_custom_attribute4 제품의 커스텀 속성 4입니다. CustomAttribute4
segments_product_item_id 제품의 상품 ID입니다. OfferId
segments_product_language 제품의 언어에 대한 언어 상수의 리소스 이름입니다. LanguageCriteriaId
segments_product_merchant_id 제품의 판매자 ID입니다. MerchantId
segments_product_type_l1 제품 유형(수준 1)입니다. ProductTypeL1
segments_product_type_l2 제품 유형(수준 2)입니다. ProductTypeL2
segments_product_type_l3 제품 유형(수준 3)입니다. ProductTypeL3
segments_product_type_l4 제품 유형(수준 4)입니다. ProductTypeL4
segments_product_type_l5 제품 유형(수준 5)입니다. ProductTypeL5
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도

Google Ads 표 이름: 동영상

Google Ads API 리소스: video

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_status 광고의 상태입니다.
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
video_duration_millis 동영상 길이(밀리초)입니다. VideoDuration
video_id 동영상의 ID입니다. VideoId
video_title 동영상의 제목입니다. VideoTitle

Google Ads 표 이름: VideoBasicStats

Google Ads API 리소스: video

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_ad_status 광고의 상태입니다. CreativeStatus
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
metrics_view_through_conversions 총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용 (예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. ViewThroughConversions
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_device 측정항목이 적용되는 기기입니다. 기기
video_channel_id 동영상의 소유자 채널 ID입니다. VideoChannelId
video_id 동영상의 ID입니다. VideoId

Google Ads 표 이름: VideoConversionStats

Google Ads API 리소스: video

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_ad_status 광고의 상태입니다. CreativeStatus
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_conversion_action 전환 액션의 리소스 이름입니다. ConversionTrackerId
segments_conversion_action_category 전환 액션 카테고리입니다. ConversionCategoryName
segments_conversion_action_name 전환 액션 이름입니다. ConversionTypeName
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도
video_channel_id 동영상의 소유자 채널 ID입니다. VideoChannelId
video_id 동영상의 ID입니다. VideoId

Google Ads 표 이름: VideoNonClickStats

Google Ads API 리소스: video

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_ad_status 광고의 상태입니다.
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions 총 전환수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. AllConversions
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. AllConversionRate
metrics_all_conversions_value 모든 전환의 총 가치입니다. AllConversionValue
metrics_average_cpv 사용자가 광고를 조회할 때마다 광고주가 지불하는 평균 금액입니다. 평균 CPV는 모든 광고 조회수의 총비용을 조회수로 나눈 값으로 정의됩니다. AverageCpv
metrics_cost_per_all_conversions 광고 상호작용 비용을 모든 전환수로 나눈 값입니다. CostPerAllConversion
metrics_cross_device_conversions 고객이 하나의 기기에서 Google Ads 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. CrossDeviceConversions
metrics_engagement_rate 사용자가 광고를 본 후 광고에 참여하는 빈도입니다. 광고 확장 횟수를 광고가 게재된 횟수로 나눈 값입니다. EngagementRate
metrics_engagements 참여수입니다. 사용자 참여는 시청자가 라이트박스 광고를 펼칠 때 발생합니다. 또한 향후 다른 광고 유형에서 참여 측정항목을 지원할 수 있습니다. 참여
metrics_value_per_all_conversions 모든 전환의 가치를 모든 전환수로 나눈 값입니다. ValuePerAllConversion
metrics_video_quartile_p100_rate 시청자가 내 동영상을 모두 시청한 노출수의 비율입니다. VideoQuartile100Rate
metrics_video_quartile_p25_rate 시청자가 동영상의 25% 를 시청한 노출수의 비율입니다. VideoQuartile25Rate
metrics_video_quartile_p50_rate 시청자가 내 동영상의 50% 를 시청한 노출수의 비율입니다. VideoQuartile50Rate
metrics_video_quartile_p75_rate 시청자가 내 동영상의 75% 를 시청한 노출수의 비율입니다. VideoQuartile75Rate
metrics_video_view_rate TrueView 동영상 광고에서 발생한 조회수를 노출수(TrueView 인디스플레이 광고의 썸네일 노출수 포함)로 나눈 값입니다. VideoViewRate
metrics_video_views 동영상 광고가 조회된 횟수입니다. VideoViews
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018년 4월 1일에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도
video_channel_id 동영상의 소유자 채널 ID입니다. VideoChannelId
video_id 동영상의 ID입니다. VideoId

Google Ads 표 이름: VideoStats

Google Ads API 리소스: video

Google Ads 필드 이름 설명 Google Ads 매핑된 필드 이름
ad_group_ad_ad_id 광고의 ID입니다. CreativeId
ad_group_ad_status 광고의 상태입니다. CreativeStatus
ad_group_id 광고 그룹의 ID입니다. AdGroupId
campaign_id 캠페인의 ID입니다. CampaignId
customer_id 고객의 ID입니다. ExternalCustomerId
metrics_all_conversions_from_interactions_rate 조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. ConversionRate
metrics_average_cpm 평균 CPM(1,000회 노출당비용)입니다. AverageCpm
metrics_clicks 클릭수입니다. 클릭수
metrics_conversions 전환이 발생한 횟수입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환수
metrics_conversions_value 총 전환 가치입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. ConversionValue
metrics_cost_micros 일정 기간에 발생한 클릭당비용 (CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 비용
metrics_cost_per_conversion 광고 상호작용 비용을 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. CostPerConversion
metrics_ctr 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. Ctr
metrics_impressions Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. 노출수
segments_ad_network_type 광고 네트워크 유형입니다. AdNetworkType2
segments_click_type 클릭 유형 ClickType
segments_date 측정항목이 적용되는 날짜입니다(yyyy-MM-dd 형식). 예를 들어 2018-04-17입니다. 날짜
segments_day_of_week 요일입니다. 예를 들어 MONDAY입니다. DayOfWeek
segments_device 측정항목이 적용되는 기기입니다. 기기
segments_month 월을 나타내는 값으로, 월의 첫 번째 날짜입니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_quarter 분기의 첫날 날짜로 표시되는 분기입니다. 분기에 캘린더 연도를 사용합니다. 예를 들어 2018년 2분기는 2018년 4월 1일에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다. 분기
segments_week 주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
segments_year 연도이며, 형식은 yyyy입니다. 연도
video_channel_id 동영상의 소유자 채널 ID입니다. VideoChannelId
video_id 동영상의 ID입니다. VideoId

Google Ads 데이터 이동 색인은 속성 필드 (설정 또는 다른 수정 데이터를 포함하는 필드)만 포함하는 테이블이며, 사용자가 계정 구조 정보를 쿼리할 수 있도록 정의됩니다. 새로고침 창을 사용하거나 백필을 예약할 경우 데이터 이동 색인 스냅샷이 업데이트되지 않습니다.

다음은 Google Ads 전송의 데이터 이동 색인 목록입니다.

  • 광고
  • AdGroup
  • AdGroupAudience
  • AdGroupBidModifier
  • AdGroupAdLabel
  • AdGroupCriterion
  • AdGroupCriterionLabel
  • AdGroupLabel
  • AgeRange
  • 확장 소재
  • AssetGroup
  • AssetGroupAsset
  • AssetGroupListingGroupFilter
  • AssetGroupSignal
  • Audience
  • BidGoal
  • 예산
  • 캠페인
  • CampaignAudience
  • CampaignCriterion
  • CampaignLabel
  • 고객
  • 성별
  • 키워드
  • LocationBasedCampaignCriterion
  • ParentalStatus
  • Placement
  • Video