Отфильтрованные отчеты

Новый API отчетов Search Ads 360 теперь доступен. Новый API обеспечивает повышенную гибкость для создания пользовательских отчетов и интеграции данных в ваши приложения и процессы отчетности. Узнайте больше о переходе и использовании нового API отчетов Search Ads 360 .

По умолчанию ваш отчет будет содержать все данные в пределах 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 столбца, API Search Ads 360 преобразует 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 в отчете по ключевым словам , отчет будет содержать только ключевые слова, для которых не указана максимальная цена за клик. 0
isNotNull Столбец должен содержать значение. 0
startsWith

Столбец должен начинаться с одной из строк в списке фильтра.

Действительно только для String столбцов.

 переменная
containsSubstring

Столбец должен содержать всю или часть одной из строк, указанных в списке фильтра.

Например, фильтр containsSubstring со значениями:
["ham", "cheese"]
вернет строки с этим значением:
ham burger
cheese burger

но не будет возвращать строки с этими значениями:
lobster roll
lettuce
hig h am plitude ( high amplitude включает подстроку «h am», но все символы, включая пробелы, оцениваются фильтром)

Действительно только для String столбцов.

 переменная
doesNotContainSubstring

Столбец не должен содержать ни одной строки из списка фильтра.

Например, фильтр doesNotContainSubstring со значениями:
["ham", "cheese"]
вернет строки с этим значением:
lobster roll
lettuce

но не будет возвращать строки с этими значениями:
бургер с ветчиной
чизбургер

Действительно только для String столбцов.

 переменная
containsElement

Столбец должен содержать хотя бы одно из значений в списке фильтра. Допустимо только для столбцов со списком типов данных (например, String list ).

Например, в отчете campaign используется фильтр containsElement со значениями:
["foo", "bar"]
фильтрация по столбцу effectiveLabels вернет только кампании, помеченные foo , bar или обоими.

 переменная