유료 및자연 보고서는 Google에 광고를 게재하거나, Google에서 사이트에 대한 무료 (자연) 검색결과를 표시하도록 트리거했거나 이 두 가지를 모두 수행한 검색어를 보여줍니다. 보고하려는 엔진 계정에 대해 이미 유료 및 무료 검색 결과 보고서를 설정한 경우에만 보고서가 결과를 반환합니다.
이 보고서는 비동기식 요청 (즉, Reports.request() 메서드를 통해 전달될 수 있습니다.
요청 발췌문
정기적으로
Reports.request()
요청 본문이지만 "reportType": "paidAndOrganic"를 지정하세요.
{
...
"reportType": "paidAndOrganic",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
보고서에서 반환하거나 필터링하려는 각 열에 대해
아래 표에 나열된 columnName를 지정해야 합니다.
원하는 경우
headerText,
startDate,
및 endDate를 선택합니다.
일부 열은 필터링할 수 없습니다. 자세한 내용은 '필터링 가능' 를 참조하세요.
columnName | 설명 | 동작 | 유형 | 필터링 가능 |
|---|---|---|---|---|
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 |
예 |
searchQuery |
Google 사용자가 입력한 검색어입니다. | 속성 | String |
예 |
serpType |
Google 사용자가 클릭한 검색결과 유형입니다. 가능한 값은 다음과 같습니다.
|
속성 | SERP type |
예 |
paidClicks |
사용자가 검색어를 입력한 후 광고를 클릭한 횟수입니다. | 측정항목 | Integer |
예 |
organicClicks |
사용자가 searchQuery를 입력한 후 사이트의 무료 검색결과를 클릭한 횟수입니다. | 측정항목 | Integer |
예 |
paidAndOrganicClicks |
사용자가 검색어를 입력한 후 광고 또는 사이트의 무료 검색결과에 대한 클릭수입니다. | 측정항목 | Integer |
예 |
paidImpressions |
사용자가 검색어를 입력한 후 검색결과 페이지 또는 Google 네트워크의 웹사이트에 광고가 게재된 횟수입니다. | 측정항목 | Integer |
예 |
organicQueries |
사용자가 searchQuery를 입력하고 사이트에서 자연 검색결과를 하나 이상 본 총 횟수입니다. | 측정항목 | Integer |
예 |
paidAndOrganicQueries |
사용자가 searchQuery를 입력하고 사이트에서 광고 또는 자연 검색 결과를 하나 이상 본 총 횟수입니다. | 측정항목 | Integer |
예 |
paidCtr |
광고 클릭률(CTR)은 광고를 본 사용자가 검색어를 입력한 후 해당 광고를 클릭하는 빈도입니다. | 측정항목 | Number |
예 |
organicCtr |
사이트에 대한 무료 검색결과를 본 사용자가 무료 결과를 클릭하여 사이트를 방문하게 되는 비율입니다. | 측정항목 | Number |
예 |
paidAndOrganicCtr |
사이트에 대한 광고나 무료 검색결과를 본 사용자가 이 두 가지를 클릭하여 사이트를 방문하게 되는 비율입니다. | 측정항목 | Number |
예 |
paidAvgPos |
사용자가 searchQuery를 입력한 후 광고가 게재되는 평균 게재순위 | 측정항목 | Number |
예 |
organicAvgPos |
사이트에 대한 무료 검색결과의 평균 최상위 게재순위입니다. | 측정항목 | Number |
예 |
paidCostPerClick |
광고의 평균 클릭당비용입니다. 광고 클릭이 발생할 때마다 광고주가 지불하는 평균 금액입니다. | 측정항목 | Money |
예 |
date |
보고서를 일수별로 분류합니다. 각 행과 해당 집계 측정항목이 날짜별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 날짜를 반환합니다. | 세그먼트 | Date |
예 |
monthStart |
보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 월별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 월의 첫 번째 날을 반환합니다. | 세그먼트 | Date |
예 |
monthEnd |
보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 월별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 월의 마지막 날을 반환합니다. | 세그먼트 | Date |
예 |
quarterStart |
보고서를 분기별로 분류합니다. 각 행과 해당 집계 측정항목이 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 첫날을 반환합니다. | 세그먼트 | Date |
예 |
quarterEnd |
보고서를 분기별로 분류합니다. 각 행과 해당 집계 측정항목이 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 중 마지막 날을 반환합니다. | 세그먼트 | Date |
예 |
weekStart |
보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 해당 집계 측정항목이 매주 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 첫 번째 날 (일요일)을 반환합니다. | 세그먼트 | Date |
예 |
weekEnd |
보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 해당 집계 측정항목이 매주 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 마지막 날 (토요일)을 반환합니다. | 세그먼트 | Date |
예 |
yearStart |
보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목이 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 첫 번째 날을 반환합니다. | 세그먼트 | Date |
예 |
yearEnd |
보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목이 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 중 마지막 날을 반환합니다. | 세그먼트 | Date |
예 |
campaign |
캠페인별로 보고서 분류하기 각 행과 해당 집계 측정항목은 보고서 범위의 각 캠페인에 하나씩 여러 행으로 분할됩니다. 이 열은 캠페인 이름을 반환합니다. | 세그먼트 | String |
예 |
campaignId |
캠페인별로 보고서 분류하기 각 행과 해당 집계 측정항목은 보고서 범위의 각 캠페인에 하나씩 여러 행으로 분할됩니다. 이 열은 DS 캠페인 ID를 반환합니다. | 세그먼트 | ID |
예 |
adGroup |
광고그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목은 보고서 범위의 각 광고 그룹마다 하나씩 여러 행으로 분할됩니다. 이 열에는 광고 그룹 이름이 반환됩니다. | 세그먼트 | String |
예 |
adGroupId |
광고그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목은 보고서 범위의 각 광고 그룹마다 하나씩 여러 행으로 분할됩니다. 이 항목은 DS 광고그룹 ID를 반환합니다. | 세그먼트 | ID |
예 |
keywordId |
키워드별로 보고서 분류하기 각 행과 해당 집계 측정항목은 보고서 범위의 각 키워드마다 하나씩 여러 행으로 분할됩니다. 이 항목은 DS 키워드 ID를 반환합니다. | 세그먼트 | ID |
예 |
keywordMatchType |
키워드별로 보고서 분류하기 각 행과 해당 집계 측정항목은 보고서 범위의 각 키워드마다 하나씩 여러 행으로 분할됩니다. 이 열은 키워드 검색 유형을 반환합니다. | 세그먼트 | Match type |
예 |
keywordText |
키워드별로 보고서 분류하기 각 행과 해당 집계 측정항목은 보고서 범위의 각 키워드마다 하나씩 여러 행으로 분할됩니다. 이 열은 키워드 텍스트를 반환합니다. | 세그먼트 | String |
예 |