보고서 유형: 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 교차 환경 Campaign Manager 작업의 총 개수입니다. 측정항목 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 보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 월별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 월의 첫 번째 날을 반환합니다. 세그먼트 Date
monthEnd 보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 월별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 월의 마지막 날을 반환합니다. 세그먼트 Date
quarterStart 보고서를 분기별로 분류합니다. 각 행과 해당 집계 측정항목이 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 첫날을 반환합니다. 세그먼트 Date
quarterEnd 보고서를 분기별로 분류합니다. 각 행과 해당 집계 측정항목이 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 중 마지막 날을 반환합니다. 세그먼트 Date
weekStart 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 해당 집계 측정항목이 매주 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 첫 번째 날 (일요일)을 반환합니다. 세그먼트 Date
weekEnd 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 해당 집계 측정항목이 매주 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 마지막 날 (토요일)을 반환합니다. 세그먼트 Date
yearStart 보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목이 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 첫 번째 날을 반환합니다. 세그먼트 Date
yearEnd 보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목이 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 중 마지막 날을 반환합니다. 세그먼트 Date
deviceSegment 보고서를 기기별로 분류합니다. 각 행과 해당 집계 측정항목이 기기 세그먼트당 최대 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 기기 세그먼트를 반환합니다. 세그먼트 Device segment
floodlightGroup 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 그룹당 하나씩). 이 열은 각 행의 플러드라이트 그룹 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String
floodlightGroupId 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 그룹당 하나씩). 이 항목은 각 행의 DS 플러드라이트 그룹 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 ID
floodlightGroupTag 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 그룹당 하나씩). 이 열은 각 행의 플러드라이트 그룹 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String
floodlightActivity 플러드라이트 활동별로 보고서 분류하기 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 활동당 하나씩). 이 열은 각 행의 플러드라이트 활동 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String
floodlightActivityId 플러드라이트 활동별로 보고서 분류하기 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 활동당 하나씩). 이 열은 각 행의 DS 플러드라이트 활동 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 ID
floodlightActivityTag 플러드라이트 활동별로 보고서 분류하기 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 활동당 하나씩). 이 열은 각 행의 플러드라이트 활동 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 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