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.

Reports

Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.

Rappresentazioni delle risorse

Un report di DoubleClick Search. Questo oggetto contiene la richiesta di report, alcuni metadati di report, come il codice valuta, e le righe o i file di report generati.

{
  "kind": "doubleclicksearch#report",
  "id": string,
  "isReportReady": boolean,
  "request": {
    "reportScope": {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "adGroupId": long,
      "keywordId": long,
      "adId": long
    },
    "reportType": string,
    "columns": [
      {
        "columnName": string,
        "savedColumnName": string,
        "customDimensionName": string,
        "customMetricName": string,
        "headerText": string,
        "startDate": string,
        "endDate": string,
        "groupByColumn": boolean,
        "platformSource": string,
        "productReportPerspective": string
      }
    ],
    "timeRange": {
      "startDate": string,
      "endDate": string,
      "changedMetricsSinceTimestamp": datetime,
      "changedAttributesSinceTimestamp": datetime
    },
    "filters": [
      {
        "column": {
          "columnName": string,
          "savedColumnName": string,
          "customDimensionName": string,
          "customMetricName": string,
          "headerText": string,
          "startDate": string,
          "endDate": string,
          "groupByColumn": boolean,
          "platformSource": string,
          "productReportPerspective": string
        },
        "operator": string,
        "values": [
          (value)
        ]
      }
    ],
    "orderBy": [
      {
        "column": {
          "columnName": string,
          "savedColumnName": string,
          "customDimensionName": string,
          "customMetricName": string,
          "headerText": string,
          "startDate": string,
          "endDate": string,
          "groupByColumn": boolean,
          "platformSource": string,
          "productReportPerspective": string
        },
        "sortOrder": string
      }
    ],
    "includeDeletedEntities": boolean,
    "includeRemovedEntities": boolean,
    "verifySingleTimeZone": boolean,
    "downloadFormat": string,
    "statisticsCurrency": string,
    "startRow": integer,
    "rowCount": integer,
    "maxRowsPerFile": integer
  },
  "statisticsCurrencyCode": string,
  "statisticsTimeZone": string,
  "rowCount": integer,
  "files": [
    {
      "url": string,
      "byteCount": long
    }
  ],
  "rows": [
    {
      (key): (value)
    }
  ]
}

Nome proprietà	Valore	Descrizione
`files[]`	`list`	Solo report asincrono. Contiene un elenco di file di report generati una volta completato il report.
`files[].byteCount`	`long`	Le dimensioni del file di questo report in byte.
`files[].url`	`string`	Utilizza questo URL per scaricare il file del report.
`id`	`string`	Solo report asincrono. ID del report.
`isReportReady`	`boolean`	Solo report asincrono. True se e solo se il report è stato completato correttamente e i file del report sono pronti per essere scaricati.
`kind`	`string`	Identifica come risorsa di report. Valore: la stringa fissa `doubleclicksearch#report`.
`request`	`nested object`	La richiesta che ha creato il report. I campi facoltativi non specificati nella richiesta originale vengono compilati con valori predefiniti.
`request.columns[]`	`list`	Le colonne da includere nel report. Sono incluse sia le colonne di DoubleClick Search sia le colonne salvate. Per le colonne di DoubleClick Search, è richiesto solo il parametro `columnName`. Per le colonne salvate è richiesto solo il parametro `savedColumnName`. Impossibile impostare `columnName` e `savedColumnName` nella stessa stanza. Il numero massimo di colonne per richiesta è 300.
`request.columns[].columnName`	`string`	Nome di una colonna di DoubleClick Search da includere nel report.
`request.columns[].customDimensionName`	`string`	Segmenta un report in base a una dimensione personalizzata. Il report deve limitare l'ambito a un inserzionista o a un livello inferiore e la dimensione personalizzata deve essere già impostata in DoubleClick Search. Il nome della dimensione personalizzata visualizzato in DoubleClick Search è sensibile alle maiuscole. Se utilizzato in un report sulle conversioni, restituisce il valore della dimensione personalizzata specificata per la conversione specificata, se impostato. Questa colonna non segmenta il report sulle conversioni.
`request.columns[].customMetricName`	`string`	Nome di una metrica personalizzata da includere nel report. Il report deve limitare l'ambito a un inserzionista o a un livello inferiore e la metrica personalizzata deve essere già impostata in DoubleClick Search. Il nome della metrica personalizzata che compare in DoubleClick Search è sensibile alle maiuscole.
`request.columns[].endDate`	`string`	Giorno inclusivo nel formato AAAA-MM-GG. Se specificato, sostituisce l'intervallo di tempo complessivo del report solo per questa colonna. Devono essere forniti insieme a `startDate`.
`request.columns[].groupByColumn`	`boolean`	Solo report sincrono. Imposta `true` per raggruppare in base a questa colonna. Il valore predefinito è `false`.
`request.columns[].headerText`	`string`	Testo utilizzato per identificare questa colonna nell'output del report; se non specificato, il valore predefinito è `columnName` o `savedColumnName`. In questo modo puoi evitare conflitti tra le colonne di DoubleClick Search e le colonne salvate con lo stesso nome.
`request.columns[].platformSource`	`string`	La piattaforma utilizzata per fornire i dati per la dimensione personalizzata. I valori accettati sono "floodlight".
`request.columns[].productReportPerspective`	`string`	Restituisce le metriche solo per un tipo specifico di attività del prodotto. I valori accettati sono: "`sold`": restituisce le metriche solo per i prodotti venduti "`advertised`": restituisce le metriche solo per i prodotti pubblicizzati in una campagna Shopping che potrebbero o meno essere stati venduti
`request.columns[].savedColumnName`	`string`	Nome di una colonna salvata da includere nel report. Il report deve limitare l'ambito all'inserzionista o a un livello inferiore e questa colonna salvata deve essere già creata nell'interfaccia utente di DoubleClick Search.
`request.columns[].startDate`	`string`	Data inclusiva nel formato AAAA-MM-GG. Se specificato, sostituisce l'intervallo di tempo complessivo del report solo per questa colonna. Devono essere forniti insieme a `endDate`.
`request.downloadFormat`	`string`	Formato in cui deve essere restituito il report. Attualmente sono supportati i criteri `csv` o `tsv`.
`request.filters[]`	`list`	Un elenco di filtri da applicare al report. Il numero massimo di filtri per richiesta è 300.
`request.filters[].column`	`nested object`	Colonna in base alla quale eseguire il filtro. Può essere una colonna di DoubleClick Search o una colonna salvata.
`request.filters[].column.columnName`	`string`	Nome di una colonna di DoubleClick Search da includere nel report.
`request.filters[].column.customDimensionName`	`string`	Segmenta un report in base a una dimensione personalizzata. Il report deve limitare l'ambito a un inserzionista o a un livello inferiore e la dimensione personalizzata deve essere già impostata in DoubleClick Search. Il nome della dimensione personalizzata visualizzato in DoubleClick Search è sensibile alle maiuscole. Se utilizzato in un report sulle conversioni, restituisce il valore della dimensione personalizzata specificata per la conversione specificata, se impostato. Questa colonna non segmenta il report sulle conversioni.
`request.filters[].column.customMetricName`	`string`	Nome di una metrica personalizzata da includere nel report. Il report deve limitare l'ambito a un inserzionista o a un livello inferiore e la metrica personalizzata deve essere già impostata in DoubleClick Search. Il nome della metrica personalizzata che compare in DoubleClick Search è sensibile alle maiuscole.
`request.filters[].column.endDate`	`string`	Giorno inclusivo nel formato AAAA-MM-GG. Se specificato, sostituisce l'intervallo di tempo complessivo del report solo per questa colonna. Devono essere forniti insieme a `startDate`.
`request.filters[].column.groupByColumn`	`boolean`	Solo report sincrono. Imposta `true` per raggruppare in base a questa colonna. Il valore predefinito è `false`.
`request.filters[].column.headerText`	`string`	Testo utilizzato per identificare questa colonna nell'output del report; se non specificato, il valore predefinito è `columnName` o `savedColumnName`. In questo modo puoi evitare conflitti tra le colonne di DoubleClick Search e le colonne salvate con lo stesso nome.
`request.filters[].column.platformSource`	`string`	La piattaforma utilizzata per fornire i dati per la dimensione personalizzata. I valori accettati sono "floodlight".
`request.filters[].column.productReportPerspective`	`string`	Restituisce le metriche solo per un tipo specifico di attività del prodotto. I valori accettati sono: "`sold`": restituisce le metriche solo per i prodotti venduti "`advertised`": restituisce le metriche solo per i prodotti pubblicizzati in una campagna Shopping che potrebbero o meno essere stati venduti
`request.filters[].column.savedColumnName`	`string`	Nome di una colonna salvata da includere nel report. Il report deve limitare l'ambito all'inserzionista o a un livello inferiore e questa colonna salvata deve essere già creata nell'interfaccia utente di DoubleClick Search.
`request.filters[].column.startDate`	`string`	Data inclusiva nel formato AAAA-MM-GG. Se specificato, sostituisce l'intervallo di tempo complessivo del report solo per questa colonna. Devono essere forniti insieme a `endDate`.
`request.filters[].operator`	`string`	Operatore da utilizzare nel filtro. Consulta il riferimento ai filtri per un elenco degli operatori disponibili.
`request.filters[].values[]`	`list`	Un elenco di valori in base ai quali filtrare il valore della colonna. Il numero massimo di valori di filtro per richiesta è 300.
`request.includeDeletedEntities`	`boolean`	Determina se le entità rimosse devono essere incluse nel report. Il valore predefinito è `false`. Deprecato, usa `includeRemovedEntities`.
`request.includeRemovedEntities`	`boolean`	Determina se le entità rimosse devono essere incluse nel report. Il valore predefinito è `false`.
`request.maxRowsPerFile`	`integer`	Solo report asincrono. Il numero massimo di righe per file di report. Un report di grandi dimensioni viene suddiviso in più file in base a questo campo. I valori accettati sono compresi tra `1000000` e `100000000` (inclusi).
`request.orderBy[]`	`list`	Solo report sincrono. Un elenco di colonne e direzioni che definiscono l'ordinamento da eseguire sulle righe del report. Il numero massimo di ordini per richiesta è 300.
`request.orderBy[].column`	`nested object`	Colonna su cui eseguire l'ordinamento. Può essere una colonna definita da DoubleClick Search o una colonna salvata.
`request.orderBy[].column.columnName`	`string`	Nome di una colonna di DoubleClick Search da includere nel report.
`request.orderBy[].column.customDimensionName`	`string`	Segmenta un report in base a una dimensione personalizzata. Il report deve limitare l'ambito a un inserzionista o a un livello inferiore e la dimensione personalizzata deve essere già impostata in DoubleClick Search. Il nome della dimensione personalizzata visualizzato in DoubleClick Search è sensibile alle maiuscole. Se utilizzato in un report sulle conversioni, restituisce il valore della dimensione personalizzata specificata per la conversione specificata, se impostato. Questa colonna non segmenta il report sulle conversioni.
`request.orderBy[].column.customMetricName`	`string`	Nome di una metrica personalizzata da includere nel report. Il report deve limitare l'ambito a un inserzionista o a un livello inferiore e la metrica personalizzata deve essere già impostata in DoubleClick Search. Il nome della metrica personalizzata che compare in DoubleClick Search è sensibile alle maiuscole.
`request.orderBy[].column.endDate`	`string`	Giorno inclusivo nel formato AAAA-MM-GG. Se specificato, sostituisce l'intervallo di tempo complessivo del report solo per questa colonna. Devono essere forniti insieme a `startDate`.
`request.orderBy[].column.groupByColumn`	`boolean`	Solo report sincrono. Imposta `true` per raggruppare in base a questa colonna. Il valore predefinito è `false`.
`request.orderBy[].column.headerText`	`string`	Testo utilizzato per identificare questa colonna nell'output del report; se non specificato, il valore predefinito è `columnName` o `savedColumnName`. In questo modo puoi evitare conflitti tra le colonne di DoubleClick Search e le colonne salvate con lo stesso nome.
`request.orderBy[].column.platformSource`	`string`	La piattaforma utilizzata per fornire i dati per la dimensione personalizzata. I valori accettati sono "floodlight".
`request.orderBy[].column.productReportPerspective`	`string`	Restituisce le metriche solo per un tipo specifico di attività del prodotto. I valori accettati sono: "`sold`": restituisce le metriche solo per i prodotti venduti "`advertised`": restituisce le metriche solo per i prodotti pubblicizzati in una campagna Shopping che potrebbero o meno essere stati venduti
`request.orderBy[].column.savedColumnName`	`string`	Nome di una colonna salvata da includere nel report. Il report deve limitare l'ambito all'inserzionista o a un livello inferiore e questa colonna salvata deve essere già creata nell'interfaccia utente di DoubleClick Search.
`request.orderBy[].column.startDate`	`string`	Data inclusiva nel formato AAAA-MM-GG. Se specificato, sostituisce l'intervallo di tempo complessivo del report solo per questa colonna. Devono essere forniti insieme a `endDate`.
`request.orderBy[].sortOrder`	`string`	La direzione di ordinamento, ovvero `ascending` o `descending`.
`request.reportScope`	`object`	reportScope è un insieme di ID utilizzati per determinare quale sottoinsieme di entità verrà restituito nel report. È richiesta la derivazione completa degli ID dal livello con ambito più basso desiderato fino all'agenzia.
`request.reportScope.adGroupId`	`long`	ID gruppo di annunci DS.
`request.reportScope.adId`	`long`	ID annuncio DS.
`request.reportScope.advertiserId`	`long`	ID inserzionista DS.
`request.reportScope.agencyId`	`long`	ID agenzia DS.
`request.reportScope.campaignId`	`long`	ID campagna DS.
`request.reportScope.engineAccountId`	`long`	ID account motore DS.
`request.reportScope.keywordId`	`long`	ID parola chiave di DS.
`request.reportType`	`string`	Determina il tipo di righe restituite nel report. Ad esempio, se specifichi `reportType: keyword`, ogni riga del report conterrà dati relativi a una parola chiave. Consulta la sezione Tipi di report per conoscere le colonne disponibili per ciascun tipo.
`request.rowCount`	`integer`	Solo report sincrono. Il numero massimo di righe da restituire. vengono eliminate altre righe. I valori accettati sono compresi tra `0` e `10000` (inclusi). Il valore predefinito è `10000`.
`request.startRow`	`integer`	Solo report sincrono. Indice in base zero della prima riga da restituire. I valori accettati sono compresi tra `0` e `50000` (inclusi). Il valore predefinito è `0`.
`request.statisticsCurrency`	`string`	Specifica la valuta in cui verrà restituito il valore monetario. I valori possibili sono: `usd`, `agency` (valido se l'ambito del report è un'agenzia o un livello inferiore), `advertiser` (valido se l'ambito del report è * inserzionista o un livello inferiore) o `account` (valido se l'ambito del report è un account motore o un livello inferiore).
`request.timeRange`	`object`	Se in un report vengono richieste metriche, questo argomento verrà utilizzato per limitare le metriche a un intervallo di tempo specifico.
`request.timeRange.changedAttributesSinceTimestamp`	`datetime`	Timestamp UTC inclusivo in formato RFC, ad esempio `2013-07-16T10:16:23.555Z`. Consulta ulteriori riferimenti sul funzionamento dei report sugli attributi modificati.
`request.timeRange.changedMetricsSinceTimestamp`	`datetime`	Timestamp UTC inclusivo in formato RFC, ad esempio `2013-07-16T10:16:23.555Z`. Consulta ulteriori riferimenti sul funzionamento dei report sulle metriche modificate.
`request.timeRange.endDate`	`string`	Data inclusiva nel formato AAAA-MM-GG.
`request.timeRange.startDate`	`string`	Data inclusiva nel formato AAAA-MM-GG.
`request.verifySingleTimeZone`	`boolean`	Se `true`, il report viene creato solo se tutti i dati statistici richiesti provengono da un unico fuso orario. Il valore predefinito è `false`.
`rowCount`	`integer`	Il numero di righe del report generate dal report, escluse le intestazioni.
`rows[]`	`list`	Solo report sincrono. Righe del report generate.
`rows[].(key)`	`any value`	Indica le colonne rappresentate in questa riga. Ciò significa che ogni chiave corrisponde a una colonna con una cella non vuota in questa riga.
`statisticsCurrencyCode`	`string`	Il codice valuta di tutti i valori monetari prodotti nel report, inclusi i valori impostati dagli utenti (ad es. le impostazioni dell'offerta per parola chiave) e le metriche (ad es. costo ed entrate). Il codice valuta di un report è determinato dal campo `statisticsCurrency` della richiesta di report.
`statisticsTimeZone`	`string`	Se tutte le statistiche del report provengono dallo stesso fuso orario, In caso contrario, il campo non viene impostato.

Metodi

genera: Genera e restituisce immediatamente un report.
trova: Sondaggi per lo stato di una richiesta di report.
getFile: Scarica un file di report con codifica UTF-8.
getIdMappingFile: Scarica un file CSV (codificato in UTF-8) contenente mappature degli ID tra la precedente esperienza e il nuovo Search Ads 360. Per l'inserzionista richiesto, il file include tutte le entità secondarie (ad es. account motore, campagne, gruppi di annunci e così via) presenti sia nella precedente esperienza sia nel nuovo Search Ads 360.
richiesta: Inserisce una richiesta di report nel sistema di segnalazione.