필터링된 보고서

이제 새 Search Ads 360 Reporting API를 사용할 수 있습니다. 새로운 API는 맞춤 보고서를 작성하고 보고 애플리케이션에 데이터를 통합할 수 있는 유연성 향상 프로세스입니다 새 Search Ads 360 보고서로 이전하고 이를 사용하는 방법 자세히 알아보기 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가 false을 0의 숫자 값으로 변환하고 true에서 1로 변경합니다. 만약 String 열에 이 필터를 지정하면 API는 사전순으로 표시합니다.

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

 1
greaterThan

열에는 필터의 목록입니다.

Boolean 열에 이 필터를 지정하면 API가 false를 변환합니다. 0의 숫자 값으로 변환하고 true에서 1로 변경합니다. 만약 String 열에 이 필터를 지정하면 API는 사전순으로 표시합니다.

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

1
lessThanOrEqual

열에는 다음 중 하나보다 작거나 같은 값이 포함되어야 합니다. 값이 표시됩니다.

Boolean 열에 이 필터를 지정하면 API가 false를 변환합니다. 0의 숫자 값으로 변환하고 true에서 1로 변환합니다. 만약 String 열에 이 필터를 지정하면 API는 사전순으로 표시합니다.

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

1
greaterThanOrEqual

열에는 다음 중 하나 이상의 값이 포함되어야 합니다. 값이 표시됩니다.

Boolean 열에 이 필터를 지정하면 API가 false를 변환합니다. 0의 숫자 값으로 변환하고 true에서 1로 변경합니다. 만약 String 열에 이 필터를 지정하면 API는 사전순으로 표시합니다.

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

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

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

String 열에서만 유효합니다.

가변
containsSubstring

열에는 필터의 목록입니다.

예를 들어 containsSubstring 필터에 다음 값이 있다고 가정합니다.
["ham", "cheese"]
다음 값을 가진 행이 반환됩니다.
hamburger
cheeseburger

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

String 열에서만 유효합니다.

가변
doesNotContainSubstring

열에는 필터 목록의 문자열이 포함되어서는 안 됩니다.

예를 들어 doesNotContainSubstring 필터에 값이
인 경우 ["ham", "cheese"]
다음 값을 가진 행이 반환됩니다.
lobster roll
lettuce

다음 값이 있는 행은 반환하지 않습니다.
햄버거
치즈버거

String 열에서만 유효합니다.

가변
containsElement

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

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

가변