보고서 유형: payAndOrganic

유료 및자연 보고서는 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 예