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