filters
쿼리 문자열 매개변수는 애드센스 관리 API 보고서에 반환되는 데이터를 제한합니다. filters
매개변수를 사용하는 경우 필터링할 측정기준과 필터 표현식을 차례로 입력합니다.
필터링된 쿼리는 결과에 포함되는 행을 제한합니다. 결과의 각 행이 필터와 비교하여 테스트됩니다. 필터가 일치하면 행이 유지되고 일치하지 않으면 행이 삭제됩니다.
- URL 인코딩: 클라이언트 라이브러리는 필터 연산자를 자동으로 인코딩합니다. 하지만 프로토콜에 직접 요청하는 경우 아래 표에 표시된 대로 필터 연산자를 명시적으로 인코딩해야 합니다.
- 필터링 우선순위: 필터링은 측정기준이 집계되기 전에 실행되므로 반환된 측정항목은 관련 측정기준의 합계만 나타냅니다.
필터 구문
단일 필터는 다음 형식을 사용합니다.
name operator expression
이 구문에서 각 항목은 다음과 같습니다.
- name — 필터링할 측정기준의 이름입니다.
예:
AD_CLIENT_ID
는 광고 클라이언트 ID를 필터링합니다. - 연산자 - 사용할 필터 일치 유형을 정의합니다.
- expression - 결과에 포함할 값을 지정합니다.
보고되는 측정항목에 적용되는
모든 측정기준을 필터로 사용할 수 있지만
날짜 관련 측정기준 (DATE
, WEEK
,
MONTH
)은 예외입니다. 날짜별로 필터링하려면 대신 보고서의 기간을 지정합니다.
필터 연산자
필터 연산자에는 두 가지가 있습니다. 연산자가 URL 쿼리 문자열에 포함되려면 URL로 인코딩되어야 합니다.
운영자 | 설명 | URL 인코딩 형식 | 예 |
---|---|---|---|
== |
일치검색 | %3D%3D |
국가명이 Canada인 측정항목을 집계합니다.
filters=COUNTRY_NAME%3D%3DCanada |
=@ |
하위 문자열 포함 | %3D@ |
국가 이름에 United가 포함된 측정항목을 집계합니다. 예를 들어 United States 및 United Kingdom이 여기에 해당합니다.
filters=COUNTRY_NAME%3D@United |
필터 표현식
필터 표현식에는 몇 가지 중요한 규칙이 있습니다.
- URL 예약 문자 -
&
와 같은 문자는 일반적인 방식으로 URL 인코딩해야 합니다. 클라이언트 라이브러리에서 이 작업을 처리하므로 프로토콜을 직접 호출하는 경우에만 이 인코딩에 대해 신경 쓰면 됩니다. - 예약 문자 - 쉼표와 백슬래시는 표현식에 표시될 때 백슬래시로 이스케이프 처리되어야 합니다.
- 백슬래시
\\
- 쉼표
\,
- 백슬래시
참고: 이중 이스케이프 처리를 방지하려면 쉼표 앞에 백슬래시를 이스케이프 처리해야 합니다.
필터 결합
OR
및 AND
불리언 로직을 사용하여 필터를 결합할 수 있습니다.
OR 로직
필터 표현식에 쉼표 (,
)를 사용하여 OR
논리를 정의합니다.
예: (각각을 URL 인코딩해야 함)
국가 코드가 미국 또는 영국 중 하나임:
COUNTRY_CODE==US,COUNTRY_CODE==UK
AND 로직
AND
논리는 여러 필터 매개변수를 제공하여 실행되며, 클라이언트 라이브러리에서 일련의 필터 배열을 제공하는 것으로 해석됩니다.
예:
국가 코드가 US이고 제품 코드가 AFC인 경우:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC
AND 및 OR 로직 결합
하나의 표현식에 AND 및 OR 로직을 결합할 수 있습니다.
참고: 모든 필터가 하나의 AND 논리 표현식으로 결합되기 전에는 각 필터가 개별적으로 평가됩니다.
예:
국가 코드가 (US 또는 UK)이고 제품 코드가 AFC인 경우:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC