Statistiche

Contiene i metodi per accedere ai dati sulle prestazioni di un'entità.

Per ottenere dati sulle prestazioni per un'entità, ad esempio una campagna o una parola chiave, chiamare il metodo dell'entità getStats . Ma puoi chiamare getStats solo se il selettore che hai usato per ottenere l'entità include uno dei forDateRange metodi nella sua catena.

Il selettore della campagna seguente usa la versione che usa intervalli di forDateRange date predefiniti come LAST_WEEK o LAST_MONTH. L'altra versione consente di specificare l'intervallo di dati utilizzando date specifiche.

Esempio di utilizzo:

    var campaign = AdsApp.campaigns()
        .forDateRange("LAST_WEEK")
        .get()
        .next();
    var stats = campaign.getStats();
    var conversionRate = stats.getConversionRate();
    var convertedClicks = stats.getConversions();
    // etc.

Metodi

Nome metodo	Tipo restituito	Descrizione
getAbsoluteTopImpressionRate	doppia	Ottiene la percentuale assoluta della percentuale di impressioni.
getAverageCpc	doppia	Ottiene il cost per click medio.
getAverageCpm	doppia	Ottiene il costo medio per mille impressioni.
getAveragePosition	doppia	Questo metodo non è più disponibile a partire dal 31 marzo 2021.
getClickConversionRate	doppia	Utilizzate invece il metodo getConversionRate()).
getClicks	long	Ottiene il numero di clic.
getConversionRate	doppia	Ottiene il tasso di conversione per i clic.
getConversions	long	Ottiene il numero di clic convertiti.
getConvertedClicks	long	(Utilizzate invece il metodo getConversions().
getCost	doppia	Ottiene il costo (spesa) nella valuta dell'account.
getCtr	doppia	Ottiene il tasso di click-through.
getImpressions	long	Ottiene il numero di impressioni.
getReturnOnAdSpend	long	Ottiene il ritorno sulla spesa pubblicitaria.
getRevenue	long	Ottiene i ricavi segnalati dall'inserzionista.
getTopImpressionRate	doppia	Ottiene la percentuale della percentuale di impressioni più alta.

getAbsoluteTopImpressionRate

Ottiene la frequenza con cui l'annuncio è stato nella prima posizione di tutti i risultati come percentuale del numero totale di impressioni.

Restituisce

Tipo	Descrizione
doppia	Frequenza di visualizzazione dell'annuncio nella prima posizione di tutti i risultati come percentuale del numero totale di impressioni.

getAverageCpc

Ottiene il cost per click medio.

Restituisce

Tipo	Descrizione
doppia	Cost per click medio.

getAverageCpm

Ottiene il costo medio per mille impressioni.

Restituisce

Tipo	Descrizione
doppia	Costo medio per mille impressioni.

getAveragePosition

Ottiene la posizione media in cui sono stati inseriti gli annunci.

Nota

Questo metodo non è più disponibile a partire dal 31 marzo 2021.

Restituisce

Tipo	Descrizione
doppia	Posizione media in cui sono stati inseriti gli annunci.

getClickConversionRate

Ottiene il tasso di conversione per i clic.

Nota

Poiché questo metodo potrebbe essere deprecato in una versione futura, usare invece il metodo getConversionRate .

Restituisce

Tipo	Descrizione
doppia	Tasso di conversione per i clic, nell'intervallo 0..1.

getClicks

Ottiene il numero di clic.

Restituisce

Tipo	Descrizione
long	Numero di clic.

getConversionRate

Ottiene il tasso di conversione per i clic.

Restituisce

Tipo	Descrizione
doppia	Tasso di conversione per i clic, nell'intervallo 0..1.

getConversions

Ottiene il numero di clic convertiti.

Restituisce

Tipo	Descrizione
long	Numero di clic convertiti.

getConvertedClicks

Ottiene il numero di clic convertiti.

Nota

Poiché questo metodo potrebbe essere deprecato in una versione futura, usare invece il metodo getConversions .

Restituisce

Tipo	Descrizione
long	Numero di clic convertiti.

getCost

Ottiene il costo (spesa) nella valuta dell'account.

Restituisce

Tipo	Descrizione
doppia	Costo nella valuta dell'account.

getCtr

Ottiene il tasso di click-through.

Restituisce

Tipo	Descrizione
doppia	La velocità di clic, nell'intervallo 0..1.

getImpressions

Ottiene il numero di impressioni.

Restituisce

Tipo	Descrizione
long	Numero di impressioni.

getReturnOnAdSpend

Ottiene il ritorno sulla spesa pubblicitaria.

Restituisce

Tipo	Descrizione
doppia	L'utile sulla spesa per annunci, calcolato come (ricavi/spese) * 100.

getRevenue

Ottiene i ricavi segnalati dall'inserzionista.

Restituisce

Tipo	Descrizione
doppia	I ricavi riportati dall'inserzionista.

getTopImpressionRate

Ottiene la percentuale di volte in cui l'annuncio è stato visualizzato nella linea principale, la posizione principale in cui gli annunci vengono visualizzati sopra i risultati della ricerca, rispetto alle impressioni totali.

Restituisce

Tipo	Descrizione
doppia	Percentuale di volte in cui l'annuncio è stato visualizzato nella linea principale, la posizione principale in cui gli annunci vengono visualizzati sopra i risultati della ricerca, rispetto alle impressioni totali.