필터링된 보고서

이제 새 Search Ads 360 Reporting API를 사용할 수 있습니다. 새로운 API를 사용하면 더욱 유연하게 맞춤 보고서를 작성하고, 데이터를 보고 애플리케이션 및 프로세스에 통합할 수 있습니다. 새 Search Ads 360 Reporting API로 이전하고 이를 사용하는 방법에 대해 자세히 알아보세요.

기본적으로 보고서에는 요청에서 지정한 reportScope 내의 모든 데이터가 포함됩니다. 보고서에 기준 집합과 일치하는 데이터만 포함하려는 경우 보고서에 필터를 하나 이상 추가할 수 있습니다. 모든 필터를 충족하는 행만 반환됩니다.

예를 들어 대행사의 모든 키워드에 대한 보고서를 요청할 수 있습니다. 그런 다음 방문 페이지 URL이 www.example.com과 www.another-example.com으로 시작하는 키워드만 보고서에 표시되도록 필터를 지정할 수 있습니다.

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

각 필터는 필터링할 열, 연산자, 지정된 열에 있어야 하는 값 목록을 지정합니다.

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]
참고: 일부 열은 필터링할 수 없습니다. 보고서 유형 참조에서 각 열은 Filterable인지 여부를 나타냅니다.

필터 연산자

모든 필터는 대소문자를 구분합니다. 즉, 'www.Sprockets.com'이 있는 필터는 'www.sprockets.com'이 포함된 열과 일치하지 않습니다.

운영자 설명 지원되는 값 수
equals 열이 지정된 값과 정확하게 일치해야 합니다. 1
notEquals 열은 지정된 값과 일치하지 않아야 합니다. 1
in

열이 필터 목록에 있는 값 중 하나와 정확하게 일치해야 합니다.

목록 데이터 유형 (예: String list)에는 유효하지 않습니다.

가변
lessThan

열에는 지정된 값보다 작은 값이 포함되어야 합니다.

Boolean 열에 이 필터를 지정하면 Search Ads 360 API가 false0의 숫자 값으로, true1로 변환합니다. String 열에 이 필터를 지정하면 API가 사전순서를 비교합니다.

목록 데이터 유형 (예: String list)에는 유효하지 않습니다.

1
greaterThan

열에는 필터 목록의 값보다 큰 값이 포함되어야 합니다.

Boolean 열에 이 필터를 지정하면 API는 false0의 숫자 값으로, true1로 변환합니다. String 열에 이 필터를 지정하면 API가 사전순서를 비교합니다.

목록 데이터 유형 (예: String list)에는 유효하지 않습니다.

1
lessThanOrEqual

열에는 필터 목록의 값 중 하나 이하의 값이 포함되어야 합니다.

Boolean 열에 이 필터를 지정하면 API는 false0의 숫자 값으로, true1로 변환합니다. String 열에 이 필터를 지정하면 API가 사전순서를 비교합니다.

목록 데이터 유형 (예: String list)에는 유효하지 않습니다.

1
greaterThanOrEqual

열에는 필터 목록에 있는 값 중 하나 이상의 값이 포함되어야 합니다.

Boolean 열에 이 필터를 지정하면 API는 false0의 숫자 값으로, true1로 변환합니다. String 열에 이 필터를 지정하면 API가 사전순서를 비교합니다.

목록 데이터 유형 (예: String list)에는 유효하지 않습니다.

1
isNull 열은 비어 있어야 합니다. 예를 들어 키워드 보고서에서 keywordMaxCpc 열에 isNull을 지정하면 보고서에 최대 CPC를 지정하지 않은 키워드만 포함됩니다. 0
isNotNull 열에 값이 포함되어야 합니다. 0
startsWith

열은 필터 목록에 있는 문자열 중 하나로 시작해야 합니다.

String 열에만 유효합니다.

가변
containsSubstring

열에는 필터의 목록에 지정된 문자열 중 일부 또는 전체가 포함되어야 합니다.

예를 들어 값이
["ham", "cheese"]
containsSubstring 필터는 다음 값이 있는 행을 반환합니다.
hamburger
cheeseburger

다음 값이 있는 행은 반환하지 않습니다.
lobster roll
lettuce
high amplitude (high amplitude에는 하위 문자열 'h am'가 포함되지만 공백을 포함한 모든 문자는 필터에 의해 평가됩니다.)

String 열에만 유효합니다.

가변
doesNotContainSubstring

열은 필터의 목록에 있는 문자열을 포함할 수 없습니다.

예를 들어 값이
["ham", "cheese"]
doesNotContainSubstring 필터는 값이 다음과 같은 행을 반환합니다.
lobster roll
lettuce

하지만 다음 값이 포함된 행은 반환하지 않습니다.
hamburger
cheeseburger

String 열에만 유효합니다.

가변
containsElement

열에는 필터 목록의 값이 하나 이상 포함되어야 합니다. 목록 데이터 유형 (예: String list)이 있는 열에만 유효합니다.

예를 들어 campaign 보고서에서 값이 다음과 같은 containsElement 필터:
["foo", "bar"]
effectiveLabels 열을 필터링하면 foo, bar 또는 둘 다로 라벨이 지정된 캠페인만 반환됩니다.

가변