Statistiche

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

Per ottenere i dati sulle prestazioni per un'entità, ad esempio una campagna o una parola chiave, chiamare il metodo dell'entità getStats . È tuttavia possibile chiamare getStats solo se il selettore usato per ottenere l'entità include uno dei forDateRange metodi nella relativa catena.

Il selettore campagna seguente usa la versione di che usa intervalli di forDateRange date predefiniti, ad esempio LAST_WEEK o LAST_MONTH. L'altra versione consente di specificare l'intervallo di dati usando date specifiche.

Utilizzo di esempio:

    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 del tasso di impressioni superiore.
getAverageCpc	Doppia	Ottiene il costo medio per clic.
getAverageCpm	Doppia	Ottiene il costo medio per mille impressioni.
getAveragePosition	Doppia	Questo metodo non è più disponibile a partire dal 31 marzo 2021.
getClickConversionRate	Doppia	Usare 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	Usare invece il metodo getConversions().
getCost	Doppia	Ottiene il costo (spesa) nella valuta del conto.
getCtr	Doppia	Ottiene la frequenza di clic.
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 di impressioni superiore.

getAbsoluteTopImpressionRate

Ottiene la frequenza con cui l'annuncio si trovava nella prima posizione di tutti i risultati, come percentuale delle impressioni totali.

Restituisce

Tipo	Descrizione
Doppia	Con quale frequenza il tuo annuncio si trovava nella prima posizione di tutti i risultati, come percentuale delle tue impressioni totali.

getAverageCpc

Ottiene il costo medio per clic.

Restituisce

Tipo	Descrizione
Doppia	Costo medio per clic.

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 posizionati gli annunci.

Nota

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

Restituisce

Tipo	Descrizione
Doppia	Posizione media in cui sono stati posizionati 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, compreso 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, compreso 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 può 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 del conto.

Restituisce

Tipo	Descrizione
Doppia	Costo nella valuta del conto.

getCtr

Ottiene la frequenza di clic.

Restituisce

Tipo	Descrizione
Doppia	Frequenza 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	Il ritorno sulla spesa pubblicitaria, calcolato come (ricavi/spesa) * 100.

getRevenue

Ottiene i ricavi segnalati dall'inserzionista.

Restituisce

Tipo	Descrizione
Doppia	I ricavi segnalati dall'inserzionista.

getTopImpressionRate

Ottiene la percentuale di volte in cui l'annuncio viene visualizzato nella linea principale, il posizionamento superiore in cui gli annunci vengono visualizzati sopra i risultati della ricerca, fuori dalle impressioni totali.

Restituisce

Tipo	Descrizione
Doppia	La percentuale di volte in cui il tuo annuncio viene visualizzato nella linea principale, il posizionamento superiore in cui gli annunci vengono visualizzati sopra i risultati della ricerca, fuori dalle tue impressioni totali.