제품 그룹에 대한 실적 측정항목 및 구성 속성 제품 그룹 보고서는 키워드 보고서와 몇 가지 차이점이 있습니다. 자세히 알아보기
이 보고서는 비동기식 요청 (즉, 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 |
예 |