필터링

filter 쿼리 문자열 매개변수는 애드센스 관리 API 보고서에 반환되는 데이터를 제한합니다. filter 매개변수를 사용할 때는 필터링할 측정기준을 적용한 다음 필터 표현식을 적용합니다.

필터링된 쿼리에 따라 결과에 포함될 행이 결정됩니다. 결과에 표시되는 행은 필터와 대조한 결과 표시되는 것으로, 필터와 일치하는 행은 계속 남지만 일치하지 않는 행은 사라집니다.

  • URL 인코딩: 클라이언트 라이브러리는 필터 연산자를 자동으로 인코딩합니다. 그러나 프로토콜에 직접 요청하는 경우 아래 표에 나와 있는 것처럼 필터 연산자를 명시적으로 인코딩해야 합니다.
  • 필터링 우선순위: 필터링은 반환된 측정항목에 관련 있는 측정기준의 총합만이 반영될 수 있도록 측정기준이 집계되기 전에 실행됩니다.

필터 구문

단일 필터는 다음과 같은 형식을 사용합니다.

name operator expression

이 구문에서 각 형식의 의미는 다음과 같습니다.

  • name - 필터링을 적용할 측정기준의 이름. 예: AD_CLIENT_ID는 광고 클라이언트 ID를 필터링합니다.
  • operator - 사용할 필터링 일치 유형을 정의
  • expression - 결과에 포함할 값을 지정

필터 연산자

필터 연산자는 두 가지가 있습니다. 연산자가 URL 쿼리 문자열에 포함되려면 URL 인코딩을 거쳐야 합니다.

연산자 설명 URL 인코딩 형식
== 완전 일치 %3D%3D 국가명이 Canada인 측정항목을 집계합니다.
filter=COUNTRY_NAME%3D%3DCanada
=@ 하위 문자열 포함 %3D@ 국가명이 United인 측정항목을 집계합니다. 예를 들어 United States 및 United Kingdom과 일치합니다.
filter=COUNTRY_NAME%3D@United

필터 표현식

필터 표현식에는 중요한 규칙 2개가 있습니다.

  • URL 예약 문자 - &와 같은 문자는 일반적으로 URL 인코딩에 사용됩니다. 클라이언트 라이브러리에서 URL 인코딩을 처리하므로 프로토콜을 직접 호출할 경우에만 URL 인코딩에 주의하면 됩니다.
  • 예약 문자 - 쉼표와 역슬래시를 표현식에서 사용하려면 다음과 같이 역슬래시로 이스케이프 처리해야 합니다.
    • 역슬래시: \\
    • 쉼표: \,

참고: 이중 이스케이프 처리를 방지하려면 반드시 쉼표 앞에서 역슬래시로 이스케이프 처리를 해야 합니다.

필터 결합

ORAND 부울 논리를 이용해 필터를 결합할 수 있습니다.

OR 논리

필터 표현식에 쉼표 (,)를 이용해 OR 논리를 지정합니다.

예: (각각을 URL 인코딩해야 함)

국가 코드는 (US OR UK):
COUNTRY_CODE==US,COUNTRY_CODE==UK

AND 논리

AND 논리는 필터 매개변수를 여러 개 제공해 적용할 수 있으며, 클라이언트 라이브러리에서 일련의 필터 어레이를 제공하는 것으로 해석됩니다.

예:

국가 코드가 US이고 제품 코드가 AFC인 경우:
filter=COUNTRY_CODE%3D%3DUS&filter=PRODUCT_CODE%3D%3DAFC

AND 및 OR 논리 결합

하나의 표현식에서 AND 및 OR 논리를 결합할 수 있습니다.

참고: 모든 필터가 하나의 AND 논리 표현식으로 결합되기 전에는 각 필터가 개별적으로 평가됩니다.

예:

국가 코드가 US 또는 UK이고 제품 코드가 AFC인 경우:
filter=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filter=PRODUCT_CODE%3D%3DAFC

다음 단계