Tipo di rapporto: parola chiave

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

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

Richiedi estratto

Invia un normale messaggio di errore Reports.request() corpo della richiesta, ma specifica "reportType": "keyword". 

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

Per ogni colonna che vuoi venga restituita o filtrata nel report, specificare columnName nella tabella seguente. Puoi anche specificare headerText, startDate, ed endDate. Tieni presente che alcune colonne non possono essere filtrate. consulta la sezione "Filtrabile" nella tabella seguente.

columnNameDescrizioneComportamentoTipoFiltrabile
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 un proprio stato. Visualizza 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 e così via. 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 dell'agenzia. attributo String Sì
agencyId ID agenzia DS. attributo ID Sì
advertiser Nome dell'inserzionista. attributo String Sì
advertiserId ID inserzionista DS. attributo ID Sì
account Nome account motore. attributo String Sì
accountId ID account motore 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 di DS. Il valore 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 Sostituisce il CPC max del gruppo di annunci e imposta l'importo massimo che intendi pagare se un utente fa clic su un annuncio per questa parola chiave specifica. Se questo campo è vuoto, la parola chiave utilizzerà il CPC max del gruppo di annunci. attributo Money Sì
effectiveKeywordMaxCpc Il CPC max (costo per clic massimo) applicato a questa parola chiave. Può essere lo stesso valore del CPC max 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 visiterà dopo aver fatto clic sul tuo annuncio. Consulta URL pagina di destinazione e URL clickserver. attributo String Sì
keywordClickserverUrl L'URL che DS utilizza per monitorare l'attività. Un utente che fa clic su un annuncio visita prima l'URL clickserver e poi viene reindirizzato alla pagina di destinazione finale. Consulta 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 sui posizionamenti. attributo Boolean Sì
keywordMaxBid Se la parola chiave è gestita da una strategia di offerta di DS, la strategia di offerta non aumenterà mai le offerte oltre questo limite. Consulta Applicazione di una strategia di offerta alle parole chiave. attributo Money Sì
keywordMinBid Se la 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. Consulta Applicazione di una strategia di offerta alle parole chiave. attributo Money Sì
keywordUrlParams Parametri URL aggiuntivi aggiunti alla pagina di destinazione. Consulta la pagina Aggiungere parametri URL. attributo String Sì
bingKeywordParam2 Param2 di una parola chiave Bing Ads. attributo String Sì
bingKeywordParam3 Param3 di una parola chiave 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 riporta 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 una stima approssimativa dell'offerta CPC corrente necessaria per la pubblicazione regolare dell'annuncio nelle prime posizioni sopra i risultati di ricerca. Tieni presente che questa colonna riporta 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à o ereditato da questa entità. attributo ID Sì
effectiveBidStrategy Il nome della strategia di offerta assegnata a questa entità o ereditata da questa entità. attributo String Sì
bidStrategyInherited Indica se la strategia di offerta di questa entità viene ereditata. attributo Boolean Sì
effectiveLabels Nomi di tutte le etichette ereditate o direttamente assegnate a questa parola chiave. attributo String list Sì
dfaActions Il numero totale di azioni Campaign Manager. metrica Integer Sì
dfaRevenue Le entrate aggregate generate dalle transazioni di Campaign Manager. metrica Money Sì
dfaTransactions Il numero totale di transazioni Campaign Manager. metrica Integer Sì
dfaWeightedActions Somma ponderata delle azioni di Campaign Manager. metrica Number Sì
dfaActionsCrossEnv Il numero totale di azioni di Campaign Manager cross-environment. metrica Number Sì
dfaRevenueCrossEnv Le entrate aggregate generate dalle transazioni del gestore della campagna cross-environment. metrica Money Sì
dfaTransactionsCrossEnv Il numero totale di transazioni Campaign Manager cross-environment. metrica Number Sì
dfaWeightedActionsCrossEnv Somma ponderata delle azioni di 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 che l'inserzionista ha impostato per essere riportati 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 Conversioni dei report. 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 DS. metrica Integer Sì
qualityScoreAvg Solo Google Ads e Bing Ads. La media ponderata in base alle impressioni del punteggio di qualità del motore per tutti i giorni e le parole chiave nell'ambito del report. metrica Number Sì
topOfPageBidAvg Solo Google Ads. Offre una stima approssimativa dell'offerta CPC media necessaria durante l'intervallo di tempo del rapporto affinché gli annunci vengano pubblicati regolarmente nelle prime posizioni sopra i risultati di ricerca. metrica Money Sì
date Segmenta il report in base ai giorni; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni giorno. Questa colonna restituisce la data di ogni riga. segmento Date Sì
monthStart Segmenta il report per mesi; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni mese. Questa colonna restituisce il primo giorno del mese di ogni riga. segmento Date Sì
monthEnd Segmenta il report per mesi; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni mese. Questa colonna restituisce l'ultimo giorno del mese di ogni riga. segmento Date Sì
quarterStart Segmenta il report per trimestri. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni trimestre. Questa colonna restituisce il primo giorno del trimestre di ogni riga. segmento Date Sì
quarterEnd Segmenta il report per trimestri. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni 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 relative metriche aggregate sono suddivise in più righe, una per ogni 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 relative metriche aggregate sono suddivise in più righe, una per ogni settimana. Questa colonna restituisce l'ultimo giorno (sabato) di ogni riga. segmento Date Sì
yearStart Segmenta il report per anni. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni anno. Questa colonna restituisce il primo giorno dell'anno di ogni riga. segmento Date Sì
yearEnd Segmenta il report per anni. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni anno. Questa colonna restituisce l'ultimo giorno dell'anno di ogni riga. segmento Date Sì
deviceSegment Segmenta il report per dispositivo. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni segmento di dispositivi. Questa colonna restituisce il segmento dei dispositivi di ogni riga. segmento Device segment Sì
floodlightGroup Segmenta il report per gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni gruppo Floodlight. Questa colonna restituisce il nome del gruppo Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e visite. segmento String Sì
floodlightGroupId Segmenta il report per gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni gruppo Floodlight. Questa colonna restituisce l'ID gruppo Floodlight di DS di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e visite. segmento ID Sì
floodlightGroupTag Segmenta il report per gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni gruppo Floodlight. Questa colonna restituisce il tag gruppo Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e 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, una per ogni attività Floodlight. Questa colonna restituisce il nome dell'attività Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e 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, 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 Floodlight segmentati, come clic e 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, una per ogni attività Floodlight. Questa colonna restituisce il tag attività Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e visite. segmento String Sì
ad Segmenta il report in base agli annunci. ogni riga e le relative metriche aggregate sono suddivise in più righe, 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 relative metriche aggregate sono suddivise in più righe, una per ogni annuncio. Questa colonna restituisce l'ID DS dell'annuncio in ogni riga. segmento ID Sì
isUnattributedAd Segmenta il report in base agli annunci. ogni riga e le relative metriche aggregate sono suddivise in più righe, 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 relative metriche aggregate sono suddivise in più righe, una per ogni annuncio. Questa colonna restituisce il titolo dell'annuncio in ogni riga. segmento String Sì
adHeadline2 Segmenta il report in base agli annunci. ogni riga e le relative metriche aggregate sono suddivise in più righe, 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 relative metriche aggregate sono suddivise in più righe, 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 relative metriche aggregate sono suddivise in più righe, 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 relative metriche aggregate sono suddivise in più righe, 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 relative metriche aggregate sono suddivise in più righe, una per ogni annuncio. Questa colonna restituisce l'URL di visualizzazione dell'annuncio in ogni riga. segmento String Sì
adLandingPage Segmenta il report in base agli annunci. ogni riga e le relative metriche aggregate sono suddivise in più righe, 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 relative metriche aggregate sono suddivise in più righe, una per ogni annuncio. Questa colonna restituisce il tipo di annuncio in ogni riga: Text o Product. segmento Ad type Sì
adPromotionLine Segmenta il report in base agli annunci. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni annuncio. Questa colonna restituisce la riga della promozione dell'annuncio di prodotto in ogni riga. segmento String Sì