보고서 유형: 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