키워드의 실적 측정항목 및 구성 속성입니다.
이 보고서는 비동기식 요청에 의해서만 반환될 수 있습니다 (즉, Reports.request() 메서드를 통해).
발췌 요청
일반 Reports.request() 요청 본문을 보내지만 "reportType": "keyword"
를 지정합니다.
{ ... "reportType": "keyword", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
보고서에서 반환 또는 필터링하려는 각 열에 대해 아래 표에 나열된 columnName
를 지정합니다.
선택사항으로 headerText, startDate, endDate를 지정할 수도 있습니다.
일부 열은 필터링할 수 없습니다. 아래 표의 '필터링 가능'을 참조하세요.
columnName | 설명 | 동작 | 유형 | 필터링 가능 |
---|---|---|---|---|
status |
키워드 상태: Active , Paused 또는 Removed 캠페인, 광고그룹, 키워드 및 광고는 각각 자체 상태가 있습니다. 상태를 참고하세요. |
속성 | Status |
예 |
engineStatus |
외부 엔진 계정에 있는 키워드의 추가 상태입니다. 가능한 외부 상태는 criterion rarely served , criterion below first page bid , criterion low quality score , 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 |
예 |
keywordId |
DS 키워드 ID 0 값은 키워드가 기여 분석 대상이 아님을 나타냅니다. | 속성 | ID |
예 |
keywordMatchType |
키워드 검색 유형: Broad , Exact , Phrase 또는 Content . |
속성 | Match type |
예 |
keywordText |
키워드 텍스트. | 속성 | String |
예 |
keywordEngineId |
외부 엔진 계정의 키워드 ID입니다. | 속성 | ID |
예 |
keywordMaxCpc |
광고그룹의 최대 CPC를 재정의하고 이 키워드에 대한 광고를 클릭할 경우 지불할 최대 금액을 설정합니다. 이 입력란이 비어 있으면 키워드는 광고그룹의 최대 CPC를 사용합니다. | 속성 | Money |
예 |
effectiveKeywordMaxCpc |
키워드에 적용되는 최대 CPC (최대 클릭당비용)입니다. 이 값은 광고그룹의 최대 CPC와 같은 값이거나, 키워드가 광고그룹의 설정을 재정의하는 경우에는 키워드 자체의 최대 CPC가 됩니다. | 속성 | Money |
예 |
keywordLandingPage |
사용자가 광고를 클릭한 후 방문하는 최종 URL입니다. 방문 페이지 및 클릭서버 URL을 참고하세요. | 속성 | String |
예 |
keywordClickserverUrl |
DS가 활동을 추적하는 데 사용하는 URL입니다. 광고를 클릭하는 사용자는 먼저 클릭서버 URL을 방문한 다음 최종 방문 페이지로 리디렉션됩니다. 방문 페이지 및 클릭서버 URL을 참고하세요. | 속성 | String |
예 |
isDisplayKeyword |
디스플레이 및 게재위치 보고에 사용되는 자리표시자 키워드인지 여부를 나타냅니다. | 속성 | Boolean |
예 |
keywordMaxBid |
DS 입찰 전략에서 이 키워드를 관리하는 경우 입찰 전략에서 이 한도를 초과하는 입찰가를 절대로 책정하지 않습니다. 키워드에 입찰 전략 적용을 참조하세요. | 속성 | Money |
예 |
keywordMinBid |
이 키워드가 DS 입찰 전략으로 관리되는 경우 입찰 전략이 이 한도보다 낮은 입찰가를 낮추지 않습니다. 키워드에 입찰 전략 적용을 참조하세요. | 속성 | Money |
예 |
keywordUrlParams |
방문 페이지에 URL 매개변수가 추가되었습니다. URL 매개변수 추가하기를 참고하세요. | 속성 | String |
예 |
bingKeywordParam2 |
Bing Ads 키워드의 Param2 | 속성 | String |
예 |
bingKeywordParam3 |
Bing Ads 키워드의 Param3 | 속성 | String |
예 |
keywordLabels |
이 키워드에 직접 할당된 라벨 이름입니다. 상속된 라벨은 포함되지 않습니다. | 속성 | String list |
예 |
qualityScoreCurrent |
Google Ads 및 Bing Ads만 해당 키워드에 대한 엔진 품질평가점수 (QS)의 최신 값입니다. 이 열은 보고서 기간에 관계없이 항상 키워드의 최신 QS를 보고합니다. | 속성 | Integer |
예 |
topOfPageBidCurrent |
(Google Ads만 해당) 광고가 검색결과 위의 최상위 게재순위에 정기적으로 게재되기 위해 필요한 예상 CPC 입찰가입니다. 이 열에는 보고서의 기간에 관계없이 현재 필요한 CPC가 항상 보고됩니다. | 속성 | 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 |
예 |
qualityScoreAvg |
Google Ads 및 Bing Ads만 해당 보고서 범위의 모든 요일 및 키워드에 대한 엔진 품질평가점수 (QS)의 노출 가중치 적용 평균입니다. | 측정항목 | Number |
예 |
topOfPageBidAvg |
(Google Ads만 해당) 보고서 기간 동안 광고가 검색결과 위의 최상위 게재순위에 정기적으로 게재되는 데 필요한 평균 CPC 입찰가의 근사치입니다. | 측정항목 | Money |
예 |
date |
보고서를 일별로 분류합니다. 각 행과 해당 측정항목의 집계 측정항목이 하루에 하나씩 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 날짜를 반환합니다. | 세그먼트 | Date |
예 |
monthStart |
보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 매월 하나씩, 여러 개의 행으로 분할됩니다. 이 열은 각 행에서 매월 1일을 반환합니다. | 세그먼트 | Date |
예 |
monthEnd |
보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 매월 하나씩, 여러 개의 행으로 분할됩니다. 이 열은 각 행에서 매월 말일을 반환합니다. | 세그먼트 | Date |
예 |
quarterStart |
보고서를 분기별로 분류합니다. 각 행과 집계된 측정항목은 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 첫날을 반환합니다. | 세그먼트 | Date |
예 |
quarterEnd |
보고서를 분기별로 분류합니다. 각 행과 집계된 측정항목은 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 말일을 반환합니다. | 세그먼트 | Date |
예 |
weekStart |
보고서를 주 (일요일~토요일)로 분류하고, 각 행과 해당 측정항목의 집계 측정항목을 주당 하나씩 여러 행으로 나눕니다. 이 열은 각 행의 첫 번째 날 (일요일)을 반환합니다. | 세그먼트 | Date |
예 |
weekEnd |
보고서를 주 (일요일~토요일)로 분류하고, 각 행과 해당 측정항목의 집계 측정항목을 주당 하나씩 여러 행으로 나눕니다. 이 열은 각 행의 마지막 날 (토요일)을 반환합니다. | 세그먼트 | Date |
예 |
yearStart |
보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목은 연 1회씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 첫날을 반환합니다. | 세그먼트 | Date |
예 |
yearEnd |
보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목은 연 1회씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 마지막 날을 반환합니다. | 세그먼트 | 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 |
예 |
ad |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행에 있는 광고의 이름을 반환합니다. | 세그먼트 | String |
예 |
adId |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행에 광고의 DS ID를 반환합니다. | 세그먼트 | ID |
예 |
isUnattributedAd |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 이 행의 측정항목이 특정 광고와 관련이 있는지 여부를 나타냅니다. | 세그먼트 | Boolean |
예 |
adHeadline |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행에 있는 광고의 제목을 반환합니다. | 세그먼트 | String |
예 |
adHeadline2 |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 행은 각 행에 광고의 제목 2를 반환합니다. 일부 엔진에서는 사용할 수 없습니다. | 세그먼트 | String |
예 |
adHeadline3 |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행에 광고의 제목 3을 반환합니다. 일부 엔진에서는 사용할 수 없습니다. | 세그먼트 | String |
예 |
adDescription1 |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행에서 광고의 내용 입력란 1을 반환합니다. | 세그먼트 | String |
예 |
adDescription2 |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행에 광고의 내용 입력란 2를 반환합니다. | 세그먼트 | String |
예 |
adDisplayUrl |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행에 광고의 표시 URL을 반환합니다. | 세그먼트 | String |
예 |
adLandingPage |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행에 광고의 방문 페이지를 반환합니다. | 세그먼트 | String |
예 |
adType |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 광고 유형(Text 또는 Product )을 반환합니다. |
세그먼트 | Ad type |
예 |
adPromotionLine |
보고서를 광고별로 분류합니다. 각 행과 집계된 측정항목은 각 광고에 대해 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행에 제품 광고의 프로모션 행을 반환합니다. | 세그먼트 | String |
예 |