Rapports filtrés

La nouvelle API Search Ads 360 Reporting est désormais disponible. La nouvelle API fournit Plus de flexibilité pour créer des rapports personnalisés et intégrer les données dans vos applications de reporting et processus. En savoir plus sur la migration vers la nouvelle interface Search Ads 360 Reporting et son utilisation API.

Par défaut, votre rapport inclura toutes les données comprises dans l'attribut reportScope. spécifiée par votre requête. Si vous souhaitez qu'un rapport ne contienne que les données correspondant à un ensemble de vous pouvez ajouter un ou plusieurs filtres à un rapport. Uniquement les lignes qui correspondent à tous les filtres sont renvoyés.

Par exemple, vous pouvez demander un rapport sur tous les mots clés d'une agence. Ensuite, vous pouvez spécifier un filtre afin que seuls les mots clés dont l'URL de page de destination commence par www.example.com et www.another-example.com apparaissent dans le rapport.

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

Chaque filtre spécifie une colonne à filtrer, un opérateur et une liste de valeurs qui doivent se trouver dans la colonne spécifiée:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]

Remarque: Certaines colonnes ne peuvent pas être filtrées. Dans la référence Types de rapports, chaque colonne indique si la valeur est Filterable.

Opérateurs de filtrage

Tous les filtres sont sensibles à la casse. Autrement dit, un filtre avec « www.Sprockets.com » ne correspondra pas une colonne qui contient « www.sprockets.com ».

Opérateur	Description	Nombre de valeurs acceptées
equals	La colonne doit correspondre exactement à la valeur spécifiée.	1
notEquals	La colonne ne doit pas correspondre à la valeur spécifiée.	1
in	La colonne doit correspondre exactement à l'une des valeurs de la liste du filtre. Non valide pour les types de données de liste (tels que String list).	variable
lessThan	La colonne doit contenir une valeur inférieure à la valeur spécifiée. Si vous spécifiez ce filtre pour une colonne "Boolean", l'API Search Ads 360 convertit la valeur false. en une valeur numérique de 0 et true à 1. Si vous spécifiez ce filtre pour une colonne String, l'API compare les un ordre lexicographique. Non valide pour les types de données de liste (tels que String list).	1
greaterThan	La colonne doit contenir une valeur supérieure à l'une des valeurs de la liste des filtres. Si vous spécifiez ce filtre pour une colonne Boolean, l'API convertit false. en une valeur numérique de 0 et true à 1. Si vous spécifiez ce filtre pour une colonne String, l'API compare les un ordre lexicographique. Non valide pour les types de données de liste (tels que String list).	1
lessThanOrEqual	La colonne doit contenir une valeur inférieure ou égale à l'un des dans la liste du filtre. Si vous spécifiez ce filtre pour une colonne Boolean, l'API convertit false. en une valeur numérique de 0 et true à 1. Si vous spécifiez ce filtre pour une colonne String, l'API compare les un ordre lexicographique. Non valide pour les types de données de liste (tels que String list).	1
greaterThanOrEqual	La colonne doit contenir une valeur supérieure ou égale à l'un des dans la liste du filtre. Si vous spécifiez ce filtre pour une colonne Boolean, l'API convertit false. en une valeur numérique de 0 et true à 1. Si vous spécifiez ce filtre pour une colonne String, l'API compare les un ordre lexicographique. Non valide pour les types de données de liste (tels que String list).	1
isNull	La colonne doit être vide. Par exemple, si vous spécifiez isNull Pour la colonne "keywordMaxCpc" d'un rapport sur les mots clés, le rapport contient uniquement les mots clés n'ayant pas spécifié de CPC max.	0
isNotNull	La colonne doit contenir une valeur.	0
startsWith	La colonne doit commencer par l'une des chaînes de la liste du filtre. Valide uniquement pour les colonnes String.	variable
containsSubstring	La colonne doit contenir tout ou partie de l'une des chaînes spécifiées dans les liste des filtres. Par exemple, un filtre containsSubstring avec les valeurs: ["ham", "cheese"] renverrait alors des lignes avec la valeur suivante: hamburger cheeseburger mais ne renverrait pas de lignes contenant les valeurs suivantes: lobster roll lettuce high amplitude (high amplitude inclut la sous-chaîne "h am", mais tous les caractères, y compris les espaces, sont évalués par le filtre) Valide uniquement pour les colonnes String.	variable
doesNotContainSubstring	La colonne ne doit contenir aucune des chaînes de la liste du filtre. Par exemple, un filtre doesNotContainSubstring avec les valeurs ["ham", "cheese"] renverrait alors des lignes avec la valeur suivante: lobster roll lettuce mais ne renverrait pas de lignes contenant les valeurs suivantes: hamburger cheeseburger Valide uniquement pour les colonnes String.	variable
containsElement	La colonne doit contenir au moins une des valeurs de la liste du filtre. N'est valide que pour les colonnes contenant des types de données "Liste" (par exemple, String list). Par exemple, dans un rapport campaign, Un filtre containsElement avec les valeurs suivantes: ["foo", "bar"] en filtrant sur la colonne effectiveLabels ne renverra que les campagnes associées aux libellés foo, bar ou les deux.	variable