Rapports filtrés

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

Par défaut, votre rapport contient toutes les données du champ d'application reportScope spécifié par votre requête. Si vous souhaitez qu'un rapport ne contienne que les données correspondant à un ensemble de critères, vous pouvez y ajouter un ou plusieurs filtres. Seules les lignes correspondant à tous les filtres sont renvoyées.

Par exemple, vous pouvez demander un rapport sur tous les mots clés d'une agence. Vous pouvez ensuite spécifier un filtre afin que seuls les mots clés dont les URL de page de destination commencent par "www.example.com" et "www.autre-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 censées figurer 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 documentation de référence sur les types de rapports, chaque colonne indique si la valeur est Filterable.

Opérateurs de filtres

Tous les filtres sont sensibles à la casse. Autrement dit, un filtre avec "www.Sprockets.com" ne correspondra pas à une colonne contenant "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 figurant dans 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 false en une valeur numérique 0 et true en 1. Si vous spécifiez ce filtre pour une colonne String, l'API compare l'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 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 en 1. Si vous spécifiez ce filtre pour une colonne String, l'API compare l'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'une des valeurs de 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 en 1. Si vous spécifiez ce filtre pour une colonne String, l'API compare l'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'une des valeurs de 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 en 1. Si vous spécifiez ce filtre pour une colonne String, l'API compare l'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 ne contiendra que les mots clés sans 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 la liste du filtre.

Par exemple, un filtre containsSubstring avec les valeurs suivantes:
["ham", "cheese"]
affiche les lignes avec la valeur suivante:
hamburger
cheeseburger

mais ne renverra pas les 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 suivantes:
["ham", "cheese"]
affichera les lignes avec la valeur suivante:
lobster roll
lettuce

mais ne renvoie pas les lignes contenant les valeurs suivantes:
hamburger
cheeseburger

Valide uniquement pour les colonnes String.

variable
containsElement

La colonne doit contenir au moins une des valeurs figurant dans la liste du filtre. Uniquement valide pour les colonnes dont les types de données sont des listes (par exemple, String list).

Par exemple, dans un rapport campaign, un filtre containsElement avec les valeurs suivantes:
["foo", "bar"]
le filtrage sur la colonne effectiveLabels n'affiche que les campagnes associées aux libellés foo et bar, ou aux deux.

variable