보고서 유형: adGroup

광고 그룹의 실적 측정항목 및 구성 속성입니다.

이 보고서는 비동기식 요청 (즉, Reports.request() 메서드)으로만 반환할 수 있습니다.

발췌 요청

일반 Reports.request() 요청 본문을 전송하지만 "reportType": "adGroup"를 지정합니다.

{
...
 
"reportType": "adGroup",
 
"columns": [
   
{
     
"columnName": string,
     
"headerText": string,
     
"startDate": string,
     
"endDate": string
   
}
 
],
 
"filters": [
   
{
     
"column": {
       
"columnName": string,
     
},
     
...
   
},
   
...
 
],
...
}

보고서에서 반환하거나 필터링하려는 각 열에 대해 아래 표에 나열된 columnName를 지정합니다. 원하는 경우 headerText, startDate, endDate를 지정할 수도 있습니다. 일부 열은 필터링할 수 없습니다. 아래 표의 '필터링 가능'을 참고하세요.

columnName설명동작유형필터링 가능
status adGroupStatus 속성의 별칭입니다. 속성 Status
engineStatus 외부 엔진 계정에 있는 광고 그룹의 추가 상태입니다. 외부 계정 유형에 따라 가능한 상태는 eligible, campaign ended 등입니다. 속성 String
creationTimestamp ISO 8601 형식의 광고 그룹 생성 타임스탬프입니다. 속성 Timestamp
lastModifiedTimestamp ISO 8601 형식의 광고 그룹 최근 수정 타임스탬프입니다. 속성 Timestamp
agency 대행사 이름입니다. 속성 String
agencyId DS 대행사 ID입니다. 속성 ID
advertiser 광고주 이름 속성 String
advertiserId DS 광고주 ID 속성 ID
account 엔진 계정 이름입니다. 속성 String
accountId DS 엔진 계정 ID입니다. 속성 ID
accountEngineId 외부 엔진 계정의 계정 ID입니다. 속성 String
accountType 엔진 계정 유형: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu 또는 Comparison Shopping 속성 Engine type
campaign 캠페인 이름: 속성 String
campaignId DS 캠페인 ID입니다. 속성 ID
campaignStatus 이 상품이 포함된 캠페인의 상태입니다. 속성 Status
adRotation 광고 그룹에서 사용하는 광고 게재 로테이션입니다(Optimize 또는 Rotate indefinitely). 속성 String 아니요
adGroup 광고그룹 이름: 속성 String
adGroupId DS 광고그룹 ID입니다. 속성 ID
adGroupStatus 광고 그룹의 상태(Active, Paused 또는 Removed)입니다. 캠페인, 광고 그룹, 키워드, 광고, 타겟은 각각 고유한 상태를 갖습니다. 상태를 참고하세요. 속성 Status
adGroupEngineId 외부 엔진 계정의 광고 그룹 ID입니다. 속성 ID
adGroupStartDate 광고 그룹의 시작일입니다. 속성 Date
adGroupEndDate 광고 그룹의 종료일입니다. 속성 Date
adGroupSearchMaxCpc 이 광고 그룹의 검색 키워드에 대한 기본 입찰가입니다. 속성 Money
adGroupBroadMaxCpc 이 광고 그룹의 확장검색 키워드에 대한 기본 입찰가입니다 (Bing Ads만 해당). 속성 Money
adGroupExactMaxCpc 이 광고그룹의 일치검색 키워드에 대한 기본 입찰가입니다 (Bing Ads만 해당). 속성 Money
adGroupPhraseMaxCpc 이 광고그룹의 구문검색 키워드에 대한 기본 입찰가입니다 (Bing Ads만 해당). 속성 Money
adGroupContentMaxCpc 이 광고그룹의 콘텐츠 키워드에 대한 기본 입찰가입니다. 속성 Money
adGroupMobileBidAdjustment 모바일에 대해 입찰가를 조정하는 비율입니다. 예를 들어 0.2는 20% 증가를 의미하므로 모바일 입찰가는 기본 입찰가의 1.2배입니다. 유효한 값의 범위는 외부 엔진에 따라 다릅니다. 속성 Number
adGroupTabletBidAdjustment 태블릿에 대해 입찰가를 조정하는 비율입니다. 예를 들어 0.2는 20% 증가를 의미하므로 태블릿 입찰가는 기본 입찰가의 1.2배입니다. 유효한 값의 범위는 외부 엔진에 따라 다릅니다. 속성 Number
adGroupDesktopBidAdjustment 데스크톱에 대해 입찰가를 조정하는 비율입니다. 예를 들어 0.2는 20% 증가를 의미하므로 데스크톱 입찰가는 기본 입찰가의 1.2배입니다. 유효한 값의 범위는 외부 엔진에 따라 다릅니다. 속성 Number
adGroupType (Google Ads에만 해당) 광고 그룹 유형을 나타냅니다(Standard, Dynamic, Showcase). 속성 Ad group type
bingAdsLanguage Bing Ads 광고 그룹의 광고 및 키워드의 언어입니다. 속성 Microsoft language code
bingAdsAdDistributions Bing Ads 광고 그룹에서 사용하는 광고 배포 채널입니다. SearchContent의 조합입니다. 속성 String 아니요
adGroupLabels 이 광고 그룹에 직접 할당된 라벨의 이름입니다. 상속된 라벨은 포함되지 않습니다. 속성 String list
effectiveBidStrategyId 이 항목에 할당되거나 이 항목에서 상속된 입찰 전략의 DS ID입니다. 속성 ID
effectiveBidStrategy 이 항목에 할당되거나 이 항목에서 상속된 입찰 전략의 이름입니다. 속성 String
bidStrategyInherited 이 항목의 입찰 전략이 상속되었는지 여부를 나타냅니다. 속성 Boolean
deviceTargets 광고 그룹 수준의 기기 타겟입니다. Desktop, Mobile, Tablet 또는 Other의 조합입니다. 속성 String 아니요
effectiveDeviceTargets 광고 그룹 수준에서 타겟팅하거나 캠페인에서 상속받은 기기 타겟입니다. Desktop, Mobile, Tablet 또는 Other의 조합입니다. 속성 String 아니요
countryTargets 광고 그룹에 포함된 국가 타겟입니다. 업로드 템플릿 및 지역/언어 코드 다운로드 속성 String 아니요
provinceTargets 광고 그룹에 포함된 도 타겟입니다. 업로드 템플릿 및 지역/언어 코드 다운로드 속성 String 아니요
metroTargets 광고 그룹에 포함된 메트로 타겟입니다. 업로드 템플릿 및 지역/언어 코드 다운로드 속성 String 아니요
cityTargets 광고 그룹에 포함된 도시 타겟입니다. 업로드 템플릿 및 지역/언어 코드 다운로드 속성 String 아니요
effectiveCountryTargets 광고 그룹에 포함되어 있거나 캠페인에서 상속된 국가 타겟입니다. 업로드 템플릿 및 지역/언어 코드 다운로드 속성 String 아니요
effectiveProvinceTargets 광고 그룹에 포함되거나 캠페인에서 상속된 도 타겟 업로드 템플릿 및 지역/언어 코드 다운로드 속성 String 아니요
effectiveMetroTargets 광고 그룹에 포함되거나 캠페인에서 상속된 메트로 타겟 업로드 템플릿 및 지역/언어 코드 다운로드 속성 String 아니요
effectiveCityTargets 광고 그룹에 포함되어 있거나 캠페인에서 상속된 도시 타겟입니다. 업로드 템플릿 및 지역/언어 코드 다운로드 속성 String 아니요
effectiveLabels 이 광고 그룹에 상속되거나 직접 할당된 모든 라벨의 이름입니다. 속성 String list
engineRemarketingListTargetAll 광고 그룹에서 리마케팅 타겟만 사용하여 입찰가를 조정하는지를 나타냅니다.

가능한 값은 다음과 같습니다.

  • 예: 광고 그룹에서 리마케팅 타겟을 사용하여 입찰가를 조정합니다.
  • 아니요. 광고 그룹은 리마케팅 타겟의 회원에게만 광고를 게재하며 리마케팅 타겟을 사용하여 입찰가를 조정할 수 있습니다.
속성 Boolean
clicksWithFeedItemShowing 피드 항목이 표시되는 동안 광고의 링크를 클릭한 경우입니다. 이 열은 피드 항목 보고서 또는 피드 항목 열로 분류된 보고서에서만 값을 반환합니다. 측정항목 Integer
costWithFeedItemShowing 피드 항목이 표시되었을 때의 모든 광고 비용입니다. 이 열은 피드 항목 보고서 또는 피드 항목 열로 분류된 보고서에서만 값을 반환합니다. 측정항목 Money
dfaActions Campaign Manager 액션의 총 개수입니다. 측정항목 Integer
dfaRevenue Campaign Manager 거래에서 발생한 총수익입니다. 측정항목 Money
dfaTransactions Campaign Manager 거래의 총 개수입니다. 측정항목 Integer
dfaWeightedActions Campaign Manager 액션의 가중치 합계입니다. 측정항목 Number
dfaActionsCrossEnv 교차 환경 캠페인 관리자 액션의 총 수입니다. 측정항목 Number
dfaRevenueCrossEnv 교차 환경 Campaign Manager 거래에서 발생한 총수익입니다. 측정항목 Money
dfaTransactionsCrossEnv 교차 환경 Campaign Manager 거래의 총 개수입니다. 측정항목 Number
dfaWeightedActionsCrossEnv 교차 환경 Campaign Manager 액션의 가중치 합계입니다. 측정항목 Number
avgCpc 평균 클릭당비용입니다. 측정항목 Money
avgCpm 평균 1,000회 노출당비용 측정항목 Money
avgPos 평균 게재순위 측정항목 Number
clicks 클릭수를 집계합니다. 측정항목 Integer
cost 엔진 계정에 지급된 총 비용입니다. 측정항목 Money
ctr 평균 클릭률입니다. 측정항목 Number
impr 총 노출수입니다. 측정항목 Integer
adWordsConversions 광고주가 Google Ads 전환수 열에 보고되도록 설정한 데이터입니다. Google Ads 전환 액션이 생성되면 광고주는 전환 보고 열에서 해당 전환을 집계할지 여부를 선택할 수 있습니다. 측정항목 Number
adWordsConversionValue Google Ads 전환의 집계된 가치입니다. 측정항목 Number
adWordsViewThroughConversions 총 Google Ads 조회 후 전환수입니다. 측정항목 Integer
visits DS 방문의 총 개수입니다. 측정항목 Integer
searchImpressionShare Google Ads 및 Bing Ads만 해당 검색 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 0.1과 1 사이의 숫자로 반환되며, 점유율이 0.1 미만인 경우 < 10% 문자열로 반환됩니다. 측정항목 Impression share
searchRankLostImpressionShare Google Ads 및 Bing Ads만 해당 검색 네트워크에서 광고 순위가 낮아 광고가 노출되지 못한 횟수의 비율입니다. 0과 0.9 사이의 숫자로 반환되며, 점유율이 0.9를 초과하면 문자열 > 90%로 반환됩니다. 측정항목 Impression share
displayImpressionShare Google Ads만 해당 디스플레이 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 0.1과 1 사이의 숫자로 반환되며, 점유율이 0.1 미만인 경우 문자열 < 10%로 반환됩니다. 측정항목 Impression share
displayRankLostImpressionShare Google Ads만 해당 디스플레이 네트워크에서 광고 순위가 낮아 광고가 노출되지 못한 횟수의 비율입니다. 0과 0.9 사이의 숫자로 반환되며, 점유율이 0.9를 초과하면 문자열 > 90%로 반환됩니다. 측정항목 Impression share
qualityScoreAvg Google Ads 및 Bing Ads만 해당 보고서 범위 내의 모든 날짜 및 키워드에 대해 엔진의 품질평가점수 (QS)의 노출 가중 평균입니다. 측정항목 Number
topOfPageBidAvg Google Ads만 해당 보고서 기간 동안 광고가 검색결과 상단의 상위 위치에 정기적으로 게재되기 위해 필요한 평균 CPC 입찰가를 추정합니다. 측정항목 Money
absoluteTopImpressionPercentage 자연 검색결과 위의 맨 처음 광고로 게재되는 광고 노출수의 비율입니다. 측정항목 Impression share
searchAbsoluteTopImpressionShare 절대 상단 위치 (자연 검색결과 위의 첫번째 광고)에서 발생한 노출수를 상단 위치에서 발생 가능한 예상 노출수로 나눈 값입니다. 측정항목 Impression share
topImpressionPercentage 자연 검색결과 위에 게재되는 광고 노출수의 비율입니다. 측정항목 Impression share
searchTopImpressionShare 상단 위치 (자연 검색결과 위의 모든 곳)에서 발생한 노출수를 상단 위치에서 발생 가능한 예상 노출수와 비교한 값입니다. 측정항목 Impression share
searchRankLostAbsoluteTopImpressionShare 광고 순위가 낮아 자연 검색결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정합니다. 측정항목 Impression share
searchRankLostTopImpressionShare 광고 순위가 낮아 자연 검색결과 위 아무 곳에도 광고가 게재되지 않은 빈도를 예측합니다. 측정항목 Impression share
date 보고서를 일별로 분류합니다. 각 행과 집계 측정항목은 일별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 날짜를 반환합니다. 세그먼트 Date
monthStart 보고서를 월별로 분류합니다. 각 행과 집계 측정항목은 월별로 여러 행으로 분할됩니다. 이 열은 각 행의 월 1일을 반환합니다. 세그먼트 Date
monthEnd 보고서를 월별로 분류합니다. 각 행과 집계 측정항목은 월별로 여러 행으로 분할됩니다. 이 열은 각 행의 월 마지막 날짜를 반환합니다. 세그먼트 Date
quarterStart 보고서를 분기별로 분류합니다. 각 행과 집계 측정항목은 분기별로 여러 행으로 분할됩니다. 이 열은 각 행의 분기 첫날을 반환합니다. 세그먼트 Date
quarterEnd 보고서를 분기별로 분류합니다. 각 행과 집계 측정항목은 분기별로 여러 행으로 분할됩니다. 이 열은 각 행의 분기 마지막 날짜를 반환합니다. 세그먼트 Date
weekStart 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 집계 측정항목은 주별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 첫 번째 날짜 (일요일)를 반환합니다. 세그먼트 Date
weekEnd 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 집계 측정항목은 주별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 마지막 날 (토요일)을 반환합니다. 세그먼트 Date
yearStart 보고서를 연도별로 분류합니다. 각 행과 집계 측정항목은 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 첫째 날짜를 반환합니다. 세그먼트 Date
yearEnd 보고서를 연도별로 분류합니다. 각 행과 집계 측정항목은 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 마지막 날짜를 반환합니다. 세그먼트 Date
deviceSegment 기기별로 보고서를 분류합니다. 각 행과 집계 측정항목은 여러 행으로 분할되며, 기기 세그먼트당 최대 1개까지 표시될 수 있습니다. 이 열은 각 행의 기기 세그먼트를 반환합니다. 세그먼트 Device segment
floodlightGroup 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 집계 측정항목은 플러드라이트 그룹별로 최대 1개까지 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 그룹 이름을 반환합니다. 클릭수 및 방문수와 같은 일부 측정항목에는 플러드라이트 분류 값이 없습니다. 세그먼트 String
floodlightGroupId 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 집계 측정항목은 플러드라이트 그룹별로 최대 1개까지 여러 행으로 분할됩니다. 이 열은 각 행의 DS 플러드라이트 그룹 ID를 반환합니다. 클릭수 및 방문수와 같은 일부 측정항목에는 플러드라이트 분류 값이 없습니다. 세그먼트 ID
floodlightGroupTag 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 집계 측정항목은 플러드라이트 그룹별로 최대 1개까지 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 그룹 태그를 반환합니다. 클릭수 및 방문수와 같은 일부 측정항목에는 플러드라이트 분류 값이 없습니다. 세그먼트 String
floodlightActivity 플러드라이트 액티비티별로 보고서를 분류합니다. 각 행과 집계 측정항목은 플러드라이트 액티비티별로 최대 1개까지 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 활동 이름을 반환합니다. 클릭수 및 방문수와 같은 일부 측정항목에는 플러드라이트 분류 값이 없습니다. 세그먼트 String
floodlightActivityId 플러드라이트 액티비티별로 보고서를 분류합니다. 각 행과 집계 측정항목은 플러드라이트 액티비티별로 최대 1개까지 여러 행으로 분할됩니다. 이 열은 각 행의 DS 플러드라이트 활동 ID를 반환합니다. 클릭수 및 방문수와 같은 일부 측정항목에는 플러드라이트 분류 값이 없습니다. 세그먼트 ID
floodlightActivityTag 플러드라이트 액티비티별로 보고서를 분류합니다. 각 행과 집계 측정항목은 플러드라이트 액티비티별로 최대 1개까지 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 활동 태그를 반환합니다. 클릭수 및 방문수와 같은 일부 측정항목에는 플러드라이트 분류 값이 없습니다. 세그먼트 String
sitelinkDisplayText 사이트링크별로 보고서를 분류합니다. 각 행과 집계 측정항목은 사이트링크별로 여러 행으로 분할됩니다. 이 열에는 각 행의 사이트링크 표시 텍스트가 반환됩니다. 세그먼트 String
sitelinkDescription1 사이트링크별로 보고서를 분류합니다. 각 행과 집계 측정항목은 사이트링크별로 여러 행으로 분할됩니다. 이 열은 각 행의 사이트링크 설명 1을 반환합니다. 세그먼트 String
sitelinkDescription2 사이트링크별로 보고서를 분류합니다. 각 행과 집계 측정항목은 사이트링크별로 여러 행으로 분할됩니다. 이 열은 각 행의 사이트링크 설명 2를 반환합니다. 세그먼트 String
sitelinkLandingPageUrl 사이트링크별로 보고서를 분류합니다. 각 행과 집계 측정항목은 사이트링크별로 여러 행으로 분할됩니다. 이 열은 각 행의 사이트링크 방문 페이지 URL을 반환합니다. 세그먼트 String
sitelinkClickserverUrl 사이트링크별로 보고서를 분류합니다. 각 행과 집계 측정항목은 사이트링크별로 여러 행으로 분할됩니다. 이 열은 각 행의 사이트링크의 클릭서버 URL을 반환합니다. 세그먼트 String
locationBusinessName 비즈니스 프로필 계정에 연결된 업그레이드된 위치 광고 확장으로 보고서를 분류합니다. 각 행과 집계 측정항목은 측정항목을 사용할 수 있는 위치마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 위치에 대한 비즈니스 이름을 반환합니다. 세그먼트 String
locationCategory 비즈니스 프로필 계정에 연결된 업그레이드된 위치 광고 확장으로 보고서를 분류합니다. 각 행과 집계 측정항목은 측정항목을 사용할 수 있는 위치마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 위치 카테고리를 반환합니다. 세그먼트 String
locationDetails 비즈니스 프로필 계정에 연결된 업그레이드된 위치 광고 확장으로 보고서를 분류합니다. 각 행과 집계 측정항목은 측정항목을 사용할 수 있는 위치마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 위치에 관한 세부정보를 반환합니다. 세그먼트 String
locationFilter 비즈니스 프로필 계정에 연결된 업그레이드된 위치 광고 확장으로 보고서를 분류합니다. 각 행과 집계 측정항목은 측정항목을 사용할 수 있는 위치마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 위치 필터를 반환합니다. 세그먼트 String 아니요
callPhoneNumber 통화 광고 확장별로 보고서를 분류합니다. 각 행과 집계 측정항목은 통화 광고 확장별로 여러 행으로 분할됩니다. 이 열에는 통화 확장 프로그램의 전화번호가 반환됩니다. 세그먼트 String
callCountryCode 통화 광고 확장별로 보고서를 분류합니다. 각 행과 집계 측정항목은 통화 광고 확장별로 여러 행으로 분할됩니다. 이 열은 각 행의 전화번호 확장자의 국가 코드를 반환합니다. 세그먼트 String
callIsTracked 통화 광고 확장별로 보고서를 분류합니다. 각 행과 집계 측정항목은 통화 광고 확장별로 여러 행으로 분할됩니다. 이 열은 통화 확장 프로그램의 통화가 추적되는 경우 true를 반환하고, 그렇지 않은 경우에는 false를 반환합니다. 세그먼트 Boolean
callCallOnly 통화 광고 확장별로 보고서를 분류합니다. 각 행과 집계 측정항목은 통화 광고 확장별로 여러 행으로 분할됩니다. 이 열은 전화번호 광고 확장에 전화번호만 표시되는 경우 true를 반환하고, 전화번호와 링크가 모두 표시되는 경우 false를 반환합니다. 세그먼트 Boolean
callConversionTracker 통화 광고 확장별로 보고서를 분류합니다. 각 행과 집계 측정항목은 통화 광고 확장별로 여러 행으로 분할됩니다. 이 열에는 피드 항목과 연결된 전환 추적기의 이름(있는 경우)이 반환됩니다. 세그먼트 String
callConversionTrackerId 통화 광고 확장별로 보고서를 분류합니다. 각 행과 집계 측정항목은 통화 광고 확장별로 여러 행으로 분할됩니다. 이 열에는 통화 확장과 연결된 전환 추적기의 ID(있는 경우)가 반환됩니다. 세그먼트 ID
appId 앱 확장 프로그램별로 보고서를 분류합니다. 각 행과 집계 측정항목은 앱 확장 프로그램별로 여러 행으로 분할됩니다. 이 열은 앱 ID가 있는 경우 이를 반환합니다. 세그먼트 String
appStore 앱 확장 프로그램별로 보고서를 분류합니다. 각 행과 집계 측정항목은 앱 확장 프로그램별로 여러 행으로 분할됩니다. 이 열은 앱 스토어 유형(Apple App Store, Google Play 스토어)을 반환합니다(있는 경우). 세그먼트 App store
feedItemId 피드 항목별로 보고서를 분류합니다. 각 행과 집계 측정항목은 피드 항목별로 여러 행으로 분할됩니다. 이 열은 각 행의 DS 피드 항목 행 ID를 반환합니다. 세그먼트 ID
feedId 피드 항목별로 보고서를 분류합니다. 각 행과 집계 측정항목은 피드 항목별로 여러 행으로 분할됩니다. 이 열은 각 행의 DS 피드 테이블 ID를 반환합니다. 세그먼트 ID
feedType 피드 항목별로 보고서를 분류합니다. 각 행과 집계 측정항목은 피드 항목별로 여러 행으로 분할됩니다. 이 열은 각 행의 피드 항목 유형을 반환합니다. 세그먼트 Feed type