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. |