Report filtrati

La nuova API Search Ads 360 Reporting è ora disponibile. La nuova API fornisce Maggiore flessibilità per la creazione di report personalizzati e l'integrazione dei dati nelle applicazioni di generazione dei report e processi. Scopri di più sulla migrazione e sull'utilizzo dei nuovi report di Search Ads 360 tramite Google Cloud.

Per impostazione predefinita, il report conterrà tutti i dati in reportScope che specificate dalla tua richiesta. Se desideri che un report contenga solo i dati che corrispondono a un insieme di di classificazione, puoi aggiungere uno o più filtri a un report. Solo le righe che soddisfano tutti i filtri vengono restituiti.

Ad esempio, puoi richiedere un report su tutte le parole chiave di un'agenzia. Poi puoi specificare un filtro in modo che solo le parole chiave con URL pagina di destinazione che iniziano con www.example.com e www.another-example.com vengono visualizzati nel report.

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

Ogni filtro specifica una colonna da filtrare, un operatore e un elenco di valori che devono trovarsi nella colonna specificata:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]
Nota: alcune colonne non possono essere filtrate. Nella sezione Tipi di report, ogni colonna indica se è Filterable.

Operatori di filtro

Tutti i filtri sono sensibili alle maiuscole. Vale a dire, un filtro con "www.Sprockets.com" non corrisponderà una colonna che contiene "www.sprockets.com".

Operatore Descrizione Numero di valori supportati
equals La colonna deve corrispondere esattamente al valore specificato. 1
notEquals La colonna non deve corrispondere al valore specificato. 1
in

La colonna deve corrispondere esattamente a uno dei valori nell'elenco del filtro.

Non valido per i tipi di dati dell'elenco (ad esempio String list).

variabile
lessThan

La colonna deve contenere un valore inferiore a quello specificato.

Se specifichi questo filtro per una colonna Boolean, l'API Search Ads 360 converte false in un valore numerico di 0 e da true a 1. Se specifichi questo filtro per una colonna String, l'API confronta in ordine grammaticale.

Non valido per i tipi di dati dell'elenco (ad esempio String list).

 1
greaterThan

La colonna deve contenere un valore maggiore di uno dei valori in nell'elenco del filtro.

Se specifichi questo filtro per una colonna Boolean, l'API converte false in un valore numerico di 0 e da true a 1. Se specifichi questo filtro per una colonna String, l'API confronta in ordine grammaticale.

Non valido per i tipi di dati dell'elenco (ad esempio String list).

1
lessThanOrEqual

La colonna deve contenere un valore minore o uguale a uno dei valori valori nell'elenco del filtro.

Se specifichi questo filtro per una colonna Boolean, l'API converte false in un valore numerico di 0 e da true a 1. Se specifichi questo filtro per una colonna String, l'API confronta in ordine grammaticale.

Non valido per i tipi di dati dell'elenco (ad esempio String list).

1
greaterThanOrEqual

La colonna deve contenere un valore maggiore o uguale a uno dei valori valori nell'elenco del filtro.

Se specifichi questo filtro per una colonna Boolean, l'API converte false in un valore numerico di 0 e da true a 1. Se specifichi questo filtro per una colonna String, l'API confronta in ordine grammaticale.

Non valido per i tipi di dati dell'elenco (ad esempio String list).

1
isNull La colonna deve essere vuota. Ad esempio, se specifichi isNull per la colonna keywordMaxCpc in un report sulle parole chiave, il report conterrà solo le parole chiave che non hanno specificato un CPC max. 0
isNotNull La colonna deve contenere un valore. 0
startsWith

La colonna deve iniziare con una delle stringhe nell'elenco del filtro.

Valido solo per String colonne.

variabile
containsSubstring

La colonna deve contenere tutte o parte di una delle stringhe specificate nel nell'elenco di filtri.

Ad esempio, un filtro containsSubstring con i valori:

["ham", "cheese"] restituirà le righe con questo valore:

hamburger cheeseburger

ma non restituirà le righe con questi valori:

lobster roll lettuce
high amplitude (high amplitude include la sottostringa "h am", ma tutti i caratteri, inclusi gli spazi, vengono valutati dal filtro)

Valido solo per String colonne.

variabile
doesNotContainSubstring

La colonna non deve contenere nessuna delle stringhe nell'elenco del filtro.

Ad esempio, un filtro doesNotContainSubstring con i valori:

["ham", "cheese"] restituirà le righe con questo valore:

lobster roll lettuce

ma non restituirà le righe con questi valori:
hamburger
hamburger al formaggio

Valido solo per String colonne.

variabile
containsElement

La colonna deve contenere almeno uno dei valori nell'elenco del filtro. Valido solo per le colonne con tipi di dati di elenco (ad esempio String list).

Ad esempio, in un report campaign, un filtro containsElement con i valori:

["foo", "bar"] filtrando in base alla colonna effectiveLabels. restituirà solo le campagne etichettate con foo, bar o entrambe.

variabile