L'API Search Ads 360 Reporting precedente non sarà più disponibile a partire dal 30 giugno 2024. Tieni presente che l'API Search Ads 360 Conversion non è interessata e continuerà a essere supportata. Tutte le nuove implementazioni di reporting devono utilizzare la nuova API Search Ads 360 Reporting.

A partire da aprile 2024, verrà restituito un errore non supportatoApiVersion quando si richiede un report. Consulta i dettagli qui.

Ti consigliamo inoltre di eseguire la migrazione delle implementazioni esistenti di Search Ads 360 alla nuova API. Per saperne di più, consulta la guida introduttiva e la guida alla migrazione della nuova API Search Ads 360 Reporting.

Questa pagina è stata tradotta dall'API Cloud Translation.

Report filtrati

La nuova API Search Ads 360 Reporting è ora disponibile. La nuova API offre maggiore flessibilità per la creazione di report personalizzati e l'integrazione dei dati nelle applicazioni e nei processi per la generazione di report. Scopri di più sulla migrazione alla nuova API Search Ads 360 Reporting e su come utilizzarla.

Per impostazione predefinita, il report conterrà tutti i dati all'interno dell'elemento reportScope specificato nella richiesta. Se vuoi che un report contenga solo i dati che corrispondono a un insieme di criteri, puoi aggiungere uno o più filtri al report. Vengono restituite solo le righe che soddisfano tutti i filtri.

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

"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 dovrebbero essere presenti 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. Nel riferimento Tipi di report, ogni colonna indica se è Filterable.

Operatori di filtro

Tutti i filtri fanno distinzione tra maiuscole e minuscole. In altre parole, un filtro con "www.Spskus.com" non troverà una corrispondenza con una colonna che contiene "www.sprays.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 (come `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 `0` e `true` in `1`. Se specifichi questo filtro per una colonna `String`, l'API confronta l'ordine lessicografico. Non valido per i tipi di dati dell'elenco (come `String list`).	1
`greaterThan`	La colonna deve contenere un valore maggiore di uno dei valori nell'elenco del filtro. Se specifichi questo filtro per una colonna `Boolean`, l'API converte `false` in un valore numerico `0` e `true` in `1`. Se specifichi questo filtro per una colonna `String`, l'API confronta l'ordine lessicografico. Non valido per i tipi di dati dell'elenco (come `String list`).	1
`lessThanOrEqual`	La colonna deve contenere un valore inferiore o uguale a uno dei valori nell'elenco del filtro. Se specifichi questo filtro per una colonna `Boolean`, l'API converte `false` in un valore numerico `0` e `true` in `1`. Se specifichi questo filtro per una colonna `String`, l'API confronta l'ordine lessicografico. Non valido per i tipi di dati dell'elenco (come `String list`).	1
`greaterThanOrEqual`	La colonna deve contenere un valore maggiore o uguale a uno dei valori nell'elenco del filtro. Se specifichi questo filtro per una colonna `Boolean`, l'API converte `false` in un valore numerico `0` e `true` in `1`. Se specifichi questo filtro per una colonna `String`, l'API confronta l'ordine lessicografico. Non valido per i tipi di dati dell'elenco (come `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 per le quali non è stato specificato un CPC max.	0
`isNotNull`	La colonna deve contenere un valore.	0
`startsWith`	La colonna deve iniziare con una delle stringhe presenti nell'elenco del filtro. Valido solo per `String` colonne.	variabile
`containsSubstring`	La colonna deve contenere tutta o parte di una delle stringhe specificate nell'elenco del filtro. Ad esempio, un filtro `containsSubstring` con i valori `["ham", "cheese"]` restituirà righe con questo valore: `hamburger` `cheeseburger` ma non restituisce righe con questi valori: `lobster roll` `lettuce` `high amplitude` (`high amplitude` include la sottostringa "h am", ma tutti i caratteri, spazi inclusi, vengono valutati dal filtro) Valido solo per `String` colonne.	variabile
`doesNotContainSubstring`	La colonna non deve contenere nessuna delle stringhe presenti nell'elenco del filtro. Ad esempio, un filtro `doesNotContainSubstring` con i valori `["ham", "cheese"]` restituirà righe con questo valore: `lobster roll` `lettuce` ma non restituirebbe righe con questi valori: hamburger formaggioburger Valido solo per `String` colonne.	variabile
`containsElement`	La colonna deve contenere almeno uno dei valori presenti nell'elenco del filtro. Valido solo per le colonne con tipi di dati dell'elenco (come `String list`). Ad esempio, in un report `campaign`, un filtro `containsElement` con i valori `["foo", "bar"]` nella colonna `effectiveLabels` restituirà solo le campagne etichettate con `foo`, `bar` o entrambe.	variabile