Фильтрация

Параметр строки запроса filter ограничивает данные, возвращаемые в отчете API хостов AdSense. При его использовании вы указываете параметр, по которому следует выполнять фильтрацию, затем выражение фильтра.

Запросы с фильтром ограничивают строки, которые включаются в результат. Все строки проверяются фильтром: если строка ему соответствует, то она сохраняется, а если нет – опускается.

  • Кодирование URL. Клиентские библиотеки автоматически кодируют операторы фильтра. Однако, если запросы направляется непосредственно протоколу, это необходимо сделать вручную, как показано в таблице ниже.
  • Приоритетность фильтрации. Фильтрация выполняется до суммирования по каким-либо параметрам, поэтому возвращенные показатели представляют собой сводные данные только по релевантным параметрам.

Синтаксис фильтра

Для одиночного фильтра используется форма:

name operator expression

В этом синтаксисе:

  • name – название того параметра, по которому должна выполняться фильтрация (например, AD_CLIENT_ID, если требуется фильтрация по идентификатору рекламного клиента).
  • operator – определяет тип используемого соответствия фильтру.
  • expression – определяет значения, включаемые в результаты.

Операторы фильтра

Есть два оператора фильтра. Для включения в строки запросов URL операторы должны быть закодированы.

Оператор Описание Закодированный вид Пример
== Точное соответствие %3D%3D Выбор показателей, в которых название страны имеет значение Canada:
filter=COUNTRY_NAME%3D%3DCanada
=@ Содержит строку %3D@ Выбор показателей, в которых название страны содержит значение United (например, United States и United Kingdom):
filter=COUNTRY_NAME%3D@United

Выражения фильтра

Необходимо знать несколько важных правил относительно выражений фильтра:

  • Недопустимые в URL символы. Недопустимые символы, такие как &, должны быть закодированы обычным способом. За вас это сделают клиентские библиотеки, так что вам не придется беспокоиться о кодировании, если вы направляете запросы напрямую протоколу.
  • Недопустимые в выражениях символы. При использовании в выражениях запятой и обратной косой черты перед ними необходимо ставить символ обратной косой черты.
    • обратная косая черта \\
    • запятая \,

Примечание. Важно маскировать символы обратной косой черты перед запятыми. Это позволит избежать двойной маскировки.

Объединение фильтров

Фильтры можно объединять с помощью логических операторов OR и AND.

Логическая схема OR

Логическая схема OR определяется с помощью запятой (,) в выражении фильтра.

Пример (необходимо использовать кодировку URL)

Код страны – US или (OR) UK:
COUNTRY_CODE==US,COUNTRY_CODE==UK

Логическая схема AND

Логическая схема AND реализуется с помощью нескольких параметров фильтра (которые передаются в имеющийся массив фильтров в клиентских библиотеках).

Пример:

Код страны – US и (AND) код товара – AFC:
filter=COUNTRY_CODE%3D%3DUS&filter=PRODUCT_CODE%3D%3DAFC

Объединение логических схем AND и OR

Логические схемы AND и OR можно объединить в одном выражении.

Примечание. Перед объединением в логическое выражение AND каждый фильтр анализируется отдельно.

Пример:

Код страны – US или (OR) UK и (AND) код товара – AFC:
filter=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filter=PRODUCT_CODE%3D%3DAFC

Дополнительная информация

Оставить отзыв о...

Текущей странице
AdSense Host API
AdSense Host API