보고서 유형: productGroup

제품 그룹에 대한 실적 측정항목 및 구성 속성 제품 그룹 보고서는 키워드 보고서와 몇 가지 차이점이 있습니다. 자세히 알아보기

이 보고서는 비동기식 요청 (즉, Reports.request() 메서드를 통해 전달될 수 있습니다.

요청 발췌문

정기적으로 Reports.request() 요청 본문이지만 "reportType": "productGroup"를 지정하세요.

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

보고서에서 반환하거나 필터링하려는 각 열에 대해 아래 표에 나열된 columnName를 지정해야 합니다. 원하는 경우 headerText, startDate, 및 endDate를 선택합니다. 일부 열은 필터링할 수 없습니다. 자세한 내용은 '필터링 가능' 를 참조하세요.

columnName설명동작유형필터링 가능
status 제품 그룹의 상태입니다. 항상 Active입니다. 속성 Status
engineStatus 외부 엔진 계정에 있는 제품 그룹의 추가 상태입니다. 외부 계정 유형에 따라 가능한 상태는 review, campaign paused 등입니다. 속성 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
adGroup 광고그룹 이름: 속성 String
adGroupId DS 광고그룹 ID 속성 ID
adGroupStatus 이 항목이 포함된 광고그룹의 상태입니다. 속성 Status
productGroupId DS 제품 그룹 ID입니다. DS는 이러한 ID를 생성하며, 결과 제품 그룹 트리가 변경되지 않아도 변경될 수 있습니다. 자세히 알아보기 속성 ID
productGroup 제품 그룹을 정의하는 데 사용된 기준입니다(예: AND(CATEGORY="Electronics",BRAND = "example"). 속성 String 아니요
productGroupPartitionType Subdivided, Excluded, Biddable 중 제품 그룹의 파티션 유형입니다. 속성 Product group partition type
productGroupLandingPage 제품 그룹 방문 페이지 방문 페이지 및 클릭서버 URL을 참조하세요. 속성 String
productGroupClickserverUrl DS가 활동을 추적하는 데 사용하는 URL입니다. 광고를 클릭하는 사용자는 먼저 클릭서버 URL을 방문한 다음 최종 방문 페이지로 리디렉션됩니다. 방문 페이지 및 클릭서버 URL을 참조하세요. 속성 String
productGroupMaxCpc 이 제품 그룹에 설정된 최대 CPC가 있는 경우 이를 반환합니다. 이 제품 그룹에 최대 CPC가 설정되지 않은 경우 이 입력란은 비어 있고 제품 그룹은 광고 그룹의 최대 CPC 설정을 상속합니다. 속성 Money
effectiveProductGroupMaxCpc 이 제품 그룹에 적용되는 최대 CPC (클릭당비용)입니다. 이 값은 광고그룹의 최대 CPC와 같은 값이거나 제품 타겟이 광고그룹의 설정을 재정의하는 경우 제품 타겟의 자체 최대 CPC입니다. 속성 Money
productGroupMaxBid 이 제품 그룹이 DS 입찰 전략으로 관리되는 경우 입찰 전략에서 이 한도를 초과하여 입찰가를 높이지 않습니다. 제품 그룹에 입찰 전략 적용하기를 참고하세요. 속성 Money
productGroupMinBid 이 제품 그룹이 DS 입찰 전략으로 관리되는 경우 입찰 전략은 입찰가를 이 한도 미만으로 낮추지 않습니다. 제품 그룹에 입찰 전략 적용하기를 참고하세요. 속성 Money
effectiveBidStrategyId 이 항목에 할당되었거나 이 항목에서 상속한 입찰 전략의 DS ID입니다. 속성 ID
effectiveBidStrategy 이 항목에 할당되거나 이 항목에서 상속한 입찰 전략의 이름입니다. 속성 String
bidStrategyInherited 이 항목의 입찰 전략이 상속되는지 여부를 나타냅니다. 속성 Boolean
effectiveLabels 이 제품 그룹에 상속되었거나 직접 할당된 모든 라벨의 이름입니다. 속성 String list
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
date 보고서를 일수별로 분류합니다. 각 행과 해당 집계 측정항목이 날짜별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 날짜를 반환합니다. 세그먼트 Date
monthStart 보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 월별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 월의 첫 번째 날을 반환합니다. 세그먼트 Date
monthEnd 보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 월별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 월의 마지막 날을 반환합니다. 세그먼트 Date
quarterStart 보고서를 분기별로 분류합니다. 각 행과 해당 집계 측정항목이 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 첫날을 반환합니다. 세그먼트 Date
quarterEnd 보고서를 분기별로 분류합니다. 각 행과 해당 집계 측정항목이 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 중 마지막 날을 반환합니다. 세그먼트 Date
weekStart 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 해당 집계 측정항목이 매주 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 첫 번째 날 (일요일)을 반환합니다. 세그먼트 Date
weekEnd 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 해당 집계 측정항목이 매주 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 마지막 날 (토요일)을 반환합니다. 세그먼트 Date
yearStart 보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목이 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 첫 번째 날을 반환합니다. 세그먼트 Date
yearEnd 보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목이 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 중 마지막 날을 반환합니다. 세그먼트 Date
deviceSegment 보고서를 기기별로 분류합니다. 각 행과 집계 측정항목이 기기 세그먼트당 최대 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 기기 세그먼트를 반환합니다. 세그먼트 Device segment