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.

Tipo di report: parola chiave

Metriche sul rendimento e attributi di configurazione per le parole chiave.

Questo report può essere restituito solo da una richiesta asincrona (ovvero, tramite il metodo Reports.request()).

Richiedi estratto

Invia un corpo di richiesta Reports.request() standard, ma specifica "reportType": "keyword".

{
...
  "reportType": "keyword",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Per ogni colonna da restituire o filtrare nel report, specifica il valore columnName elencato nella tabella seguente. Facoltativamente, puoi specificare headerText, startDate ed endDate. Tieni presente che alcune colonne non possono essere filtrate; fai riferimento a "Filtrabile" nella tabella seguente.

`columnName`	Descrizione	Comportamento	Tipo	Filtrabile
`status`	Lo stato della parola chiave: `Active`, `Paused` o `Removed`. Tieni presente che le campagne, i gruppi di annunci, le parole chiave e gli annunci hanno ciascuno un proprio stato. Vedi lo stato.	attributo	`Status`	Sì
`engineStatus`	Stato aggiuntivo della parola chiave nell'account motore esterno. Gli stati possibili (a seconda del tipo di account esterno) includono `criterion rarely served`, `criterion below first page bid`, `criterion low quality score`, `review`, `campaign paused` ecc.	attributo	`String`	Sì
`creationTimestamp`	Timestamp della creazione della parola chiave, formattato in ISO 8601.	attributo	`Timestamp`	Sì
`lastModifiedTimestamp`	Timestamp della modifica più recente della parola chiave, formattato in ISO 8601.	attributo	`Timestamp`	Sì
`agency`	Nome agenzia.	attributo	`String`	Sì
`agencyId`	ID agenzia DS.	attributo	`ID`	Sì
`advertiser`	Nome inserzionista.	attributo	`String`	Sì
`advertiserId`	ID inserzionista DS.	attributo	`ID`	Sì
`account`	Nome account motore.	attributo	`String`	Sì
`accountId`	ID account motore di DS.	attributo	`ID`	Sì
`accountEngineId`	ID dell'account nell'account motore esterno.	attributo	`String`	Sì
`accountType`	Tipo di account motore: `Google AdWords`, `Bing Ads`, `Yahoo Japan Listing Ads`, `Yahoo Search Marketing`, `Yahoo Gemini`, `Baidu` o `Comparison Shopping`.	attributo	`Engine type`	Sì
`campaign`	Nome campagna.	attributo	`String`	Sì
`campaignId`	ID campagna DS.	attributo	`ID`	Sì
`campaignStatus`	Lo stato della campagna che contiene questo elemento.	attributo	`Status`	Sì
`adGroup`	Nome gruppo di annunci.	attributo	`String`	Sì
`adGroupId`	ID gruppo di annunci DS.	attributo	`ID`	Sì
`adGroupStatus`	Lo stato del gruppo di annunci che contiene questo elemento.	attributo	`Status`	Sì
`keywordId`	ID parola chiave DS. Un valore pari a 0 indica che la parola chiave non è attribuita.	attributo	`ID`	Sì
`keywordMatchType`	Tipo di corrispondenza delle parole chiave: `Broad`, `Exact`, `Phrase` o `Content`.	attributo	`Match type`	Sì
`keywordText`	Testo della parola chiave.	attributo	`String`	Sì
`keywordEngineId`	ID della parola chiave nell'account motore esterno.	attributo	`ID`	Sì
`keywordMaxCpc`	Consente di ignorare il CPC max del gruppo di annunci e di impostare l'importo massimo che intendi pagare se un utente fa clic su un annuncio per una determinata parola chiave. Se questo campo è vuoto, la parola chiave utilizzerà il CPC max del gruppo di annunci.	attributo	`Money`	Sì
`effectiveKeywordMaxCpc`	Il CPC (costo per clic massimo) massimo attivo per questa parola chiave. Può essere lo stesso valore del CPC massimo del gruppo di annunci o, se la parola chiave sostituisce l'impostazione del gruppo di annunci, il CPC max della parola chiave.	attributo	`Money`	Sì
`keywordLandingPage`	L'URL finale che un utente visita dopo aver fatto clic sul tuo annuncio. Consulta la sezione URL pagina di destinazione e URL clickserver.	attributo	`String`	Sì
`keywordClickserverUrl`	L'URL utilizzato da DS per monitorare l'attività. Un utente che fa clic su un annuncio deve prima visitare l'URL clickserver e poi essere reindirizzato alla pagina di destinazione finale. Consulta la sezione URL pagina di destinazione e URL clickserver.	attributo	`String`	Sì
`isDisplayKeyword`	Indica se si tratta di una parola chiave segnaposto utilizzata per i report sulla visualizzazione e sul posizionamento.	attributo	`Boolean`	Sì
`keywordMaxBid`	Se questa parola chiave è gestita da una strategia di offerta di DS, non aumenterà mai le offerte oltre questo limite. Vedi Applicare una strategia di offerta alle parole chiave.	attributo	`Money`	Sì
`keywordMinBid`	Se questa parola chiave è gestita da una strategia di offerta di DS, la strategia di offerta non ridurrà mai le offerte al di sotto di questo limite. Vedi Applicare una strategia di offerta alle parole chiave.	attributo	`Money`	Sì
`keywordUrlParams`	Parametri URL aggiuntivi aggiunti alla pagina di destinazione. Consulta la sezione Aggiungere parametri URL.	attributo	`String`	Sì
`bingKeywordParam2`	Param2 di una parola chiave di Bing Ads.	attributo	`String`	Sì
`bingKeywordParam3`	Param3 di una parola chiave di Bing Ads.	attributo	`String`	Sì
`keywordLabels`	Nomi delle etichette assegnate direttamente a questa parola chiave; le etichette ereditate non sono incluse.	attributo	`String list`	Sì
`qualityScoreCurrent`	Solo Google Ads e Bing Ads. Il valore più recente del punteggio di qualità (QS) del motore per una parola chiave. Tieni presente che questa colonna indica sempre il punteggio di qualità più recente per una parola chiave, indipendentemente dall'intervallo di tempo del report.	attributo	`Integer`	Sì
`topOfPageBidCurrent`	Solo Google Ads. Offre un valore approssimativo dell'offerta CPC corrente necessaria per pubblicare regolarmente l'annuncio nelle prime posizioni sopra i risultati di ricerca. Tieni presente che questa colonna indica sempre il CPC attualmente necessario, indipendentemente dall'intervallo di tempo del report.	attributo	`Money`	Sì
`effectiveBidStrategyId`	ID DS della strategia di offerta assegnata a questa entità oppure ereditata da questa entità.	attributo	`ID`	Sì
`effectiveBidStrategy`	Il nome della strategia di offerta assegnata a questa entità oppure ereditata da questa entità.	attributo	`String`	Sì
`bidStrategyInherited`	Indica se la strategia di offerta di questa entità è ereditata.	attributo	`Boolean`	Sì
`effectiveLabels`	Nomi di tutte le etichette ereditate o assegnate direttamente a questa parola chiave.	attributo	`String list`	Sì
`dfaActions`	Il numero totale di azioni di Campaign Manager.	metrica	`Integer`	Sì
`dfaRevenue`	Entrate aggregate generate dalle transazioni di Campaign Manager.	metrica	`Money`	Sì
`dfaTransactions`	Il numero totale di transazioni di Campaign Manager.	metrica	`Integer`	Sì
`dfaWeightedActions`	Somma ponderata di azioni di Campaign Manager.	metrica	`Number`	Sì
`dfaActionsCrossEnv`	Il numero totale di azioni Campaign Manager cross-environment.	metrica	`Number`	Sì
`dfaRevenueCrossEnv`	Entrate aggregate generate dalle transazioni cross-environment di Campaign Manager.	metrica	`Money`	Sì
`dfaTransactionsCrossEnv`	Il numero totale di transazioni Campaign Manager cross-environment.	metrica	`Number`	Sì
`dfaWeightedActionsCrossEnv`	Somma ponderata di azioni Campaign Manager cross-environment.	metrica	`Number`	Sì
`avgCpc`	Costo per clic medio.	metrica	`Money`	Sì
`avgCpm`	Costo per mille impressioni medio.	metrica	`Money`	Sì
`avgPos`	Posizione media.	metrica	`Number`	Sì
`clicks`	Clic aggregati.	metrica	`Integer`	Sì
`cost`	Costo aggregato pagato agli account motore.	metrica	`Money`	Sì
`ctr`	Percentuale di clic media	metrica	`Number`	Sì
`impr`	Il numero totale di impressioni.	metrica	`Integer`	Sì
`adWordsConversions`	I dati impostati dall'inserzionista per la generazione di report nella colonna Conversioni di Google Ads. Quando viene creata un'azione di conversione di Google Ads, l'inserzionista può scegliere se conteggiare queste conversioni nella colonna Report sulle conversioni.	metrica	`Number`	Sì
`adWordsConversionValue`	Valore aggregato delle conversioni di Google Ads.	metrica	`Number`	Sì
`adWordsViewThroughConversions`	Il numero totale di conversioni view-through di Google Ads.	metrica	`Integer`	Sì
`visits`	Il numero totale di visite in DS.	metrica	`Integer`	Sì
`qualityScoreAvg`	Solo Google Ads e Bing Ads. La media ponderata in base alle impressioni del punteggio di qualità (QS) del motore in tutti i giorni e tutte le parole chiave nell'ambito del report.	metrica	`Number`	Sì
`topOfPageBidAvg`	Solo Google Ads. Offre un valore approssimativo dell'offerta CPC media necessaria durante l'intervallo di tempo del report affinché gli annunci vengano visualizzati regolarmente nelle prime posizioni sopra i risultati di ricerca.	metrica	`Money`	Sì
`date`	Segmenta il report in base al giorno; ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni giorno. Questa colonna restituisce la data di ogni riga.	segmento	`Date`	Sì
`monthStart`	Segmenta il report in base ai mesi: ogni riga e le metriche aggregate vengono suddivise in più righe, una per mese. Questa colonna restituisce il primo giorno del mese di ogni riga.	segmento	`Date`	Sì
`monthEnd`	Segmenta il report in base ai mesi: ogni riga e le metriche aggregate vengono suddivise in più righe, una per mese. Questa colonna restituisce l'ultimo giorno del mese di ogni riga.	segmento	`Date`	Sì
`quarterStart`	Segmenta il report per trimestri e ogni riga e le metriche aggregate vengono suddivise in più righe, una per trimestre. Questa colonna restituisce il primo giorno del trimestre di ogni riga.	segmento	`Date`	Sì
`quarterEnd`	Segmenta il report per trimestri e ogni riga e le metriche aggregate vengono suddivise in più righe, una per trimestre. Questa colonna restituisce l'ultimo giorno del trimestre di ogni riga.	segmento	`Date`	Sì
`weekStart`	Segmenta il report per settimane (da domenica a sabato); ogni riga e le metriche aggregate vengono suddivise in più righe, una per settimana. Questa colonna restituisce il primo giorno (domenica) di ogni riga.	segmento	`Date`	Sì
`weekEnd`	Segmenta il report per settimane (da domenica a sabato); ogni riga e le metriche aggregate vengono suddivise in più righe, una per settimana. Questa colonna restituisce l'ultimo giorno (sabato) di ogni riga.	segmento	`Date`	Sì
`yearStart`	Segmenta il report in base agli anni: ogni riga e le metriche aggregate vengono suddivise in più righe, una per anno. Questa colonna restituisce il primo giorno dell'anno di ogni riga.	segmento	`Date`	Sì
`yearEnd`	Segmenta il report in base agli anni: ogni riga e le metriche aggregate vengono suddivise in più righe, una per anno. Questa colonna restituisce l'ultimo giorno dell'anno di ogni riga.	segmento	`Date`	Sì
`deviceSegment`	Segmenta il report in base al dispositivo; ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni segmento di dispositivi. Questa colonna restituisce il segmento dispositivi di ogni riga.	segmento	`Device segment`	Sì
`floodlightGroup`	Segmenta il report in base ai gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni gruppo Floodlight. Questa colonna restituisce il nome del gruppo Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite.	segmento	`String`	Sì
`floodlightGroupId`	Segmenta il report in base ai gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni gruppo Floodlight. Questa colonna restituisce l'ID del gruppo Floodlight di DS di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite.	segmento	`ID`	Sì
`floodlightGroupTag`	Segmenta il report in base ai gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni gruppo Floodlight. Questa colonna restituisce il tag di gruppo Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite.	segmento	`String`	Sì
`floodlightActivity`	Segmenta il report in base alle attività Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni attività Floodlight. Questa colonna restituisce il nome dell'attività Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite.	segmento	`String`	Sì
`floodlightActivityId`	Segmenta il report in base alle attività Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni attività Floodlight. Questa colonna restituisce l'ID attività Floodlight di DS di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite.	segmento	`ID`	Sì
`floodlightActivityTag`	Segmenta il report in base alle attività Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni attività Floodlight. Questa colonna restituisce il tag attività Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite.	segmento	`String`	Sì
`ad`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce il nome dell'annuncio in ogni riga.	segmento	`String`	Sì
`adId`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce l'ID DS dell'annuncio su ogni riga.	segmento	`ID`	Sì
`isUnattributedAd`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna indica se le metriche in questa riga non sono attribuibili a un annuncio specifico.	segmento	`Boolean`	Sì
`adHeadline`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce il titolo dell'annuncio su ogni riga.	segmento	`String`	Sì
`adHeadline2`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce il titolo 2 dell'annuncio in ogni riga. Non disponibile per alcuni motori.	segmento	`String`	Sì
`adHeadline3`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce il titolo 3 dell'annuncio in ogni riga. Non disponibile per alcuni motori.	segmento	`String`	Sì
`adDescription1`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce la riga descrittiva 1 dell'annuncio in ogni riga.	segmento	`String`	Sì
`adDescription2`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce la riga descrittiva 2 dell'annuncio in ogni riga.	segmento	`String`	Sì
`adDisplayUrl`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce l'URL di visualizzazione dell'annuncio su ogni riga.	segmento	`String`	Sì
`adLandingPage`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce la pagina di destinazione dell'annuncio in ogni riga.	segmento	`String`	Sì
`adType`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce il tipo di annuncio di ogni riga: `Text` o `Product`.	segmento	`Ad type`	Sì
`adPromotionLine`	Segmenta il report in base agli annunci: ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni annuncio. Questa colonna restituisce la riga promozionale dell'annuncio di prodotto in ogni riga.	segmento	`String`	Sì