Colonne salvate

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 generare report su attività Floodlight, obiettivi di Google Analytics o KPI personalizzati, un inserzionista può accedere all'interfaccia utente di Search Ads 360 e creare una o più colonne salvate, ad esempio colonne Attività Floodlight, colonne Attività Google Analytics o colonne formula. Puoi includere una colonna salvata in una richiesta di report per scaricarne i dati o filtrare un report.

Visualizzare un elenco delle colonne salvate

Per visualizzare tutte le colonne salvate create da un inserzionista, invia una richiesta SavedColumns.list() . La risposta include savedColumnName per ogni colonna dell'inserzionista.

Richiesta di report per le colonne salvate

Per includere in una richiesta di report una colonna salvata, aggiungi una colonna con l'attributo savedColumnName impostato sul nome della colonna:

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

Quando utilizzi le colonne salvate, tieni presente che:

• Le colonne salvate sono definite a livello di inserzionista. Se includi una colonna salvata in una richiesta, request.reportScope deve specificare un inserzionista o un ambito di livello inferiore. Di conseguenza, ogni report può includere colonne salvate solo per un singolo inserzionista.

• I nomi delle colonne salvati sono sensibili alle maiuscole e alla punteggiatura. L'attributo savedColumnName deve corrispondere esattamente al nome della colonna salvata. Se il nome di una colonna salvata è identico a quello di un'altra colonna nella stessa richiesta, Search Ads 360 richiede di specificare un valore headerText univoco alternativo per una o entrambe le colonne.

• Le colonne salvate possono essere modificate o rimosse in qualsiasi momento nell'interfaccia utente di gestione della campagna di Search Ads 360; se una richiesta che specifica le colonne salvate ha esito negativo, prova a rimuovere le colonne salvate dalla richiesta e a inviarla di nuovo.

• I report incrementali non possono contenere metriche non esplicitamente supportate dall'API (ad esempio, le colonne di attività di Google Analytics). Inoltre, poiché gli utenti di Search Ads 360 possono ridefinire le colonne salvate, i report incrementali contenenti colonne salvate potrebbero non essere accurati.