Statistik

Enthält die Methoden für den Zugriff auf die Leistungsdaten einer Entität.

Um Leistungsdaten für eine Entität wie eine Kampagne oder ein Schlüsselwort (Keyword) abzurufen, rufen Sie die Methode der getStats Entität auf. Sie können jedoch nur aufrufen getStats , wenn der Selektor , den Sie zum Abrufen der Entität verwendet haben, eine der forDateRange Methoden in ihrer Kette enthält.

Die folgende Kampagnenauswahl verwendet die Version, die forDateRange vordefinierte Datumsbereiche wie LAST_WEEK oder LAST_MONTH verwendet. In der anderen Version können Sie den Datenbereich mit bestimmten Datumsangaben angeben.

Anwendungsbeispiel:

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

Methoden

Methodenname Rückgabetyp Beschreibung
getAbsoluteTopImpressionRate double Ermittelt die absolut höchste Rate der Aufrufe.
getAverageCpc double Ermittelt die durchschnittlichen Kosten pro Klick.
getAverageCpm double Ermittelt die durchschnittlichen Kosten pro tausend Impressionen.
getAveragePosition double Diese Methode ist ab dem 31. März 2021 nicht mehr verfügbar.
getClickConversionRate double (Verwenden Sie stattdessen die getConversionRate()-Methode.)
getClicks long Ruft die Anzahl der Klicks ab.
getConversionRate double Ruft die Abschlussrate für Klicks ab.
getConversions long Ruft die Anzahl der Klicks ab, die konvertiert wurden.
getConvertedClicks long (Verwenden Sie stattdessen die Methode getConversions().)
getCost double Ruft die Kosten (Ausgaben) in der Währung des Kontos ab.
getCtr double Ruft die Klickrate ab.
getImpressions long Ruft die Anzahl der Aufrufe ab.
getReturnOnAdSpend long Ruft die Rendite der Anzeigenausgaben ab.
getRevenue long Ruft den vom Inserenten gemeldeten Umsatz ab.
getTopImpressionRate double Ermittelt die höchste Rate der Aufrufe.

getAbsoluteTopImpressionRate

Gibt ab, wie oft Ihre Anzeige in allen Ergebnissen an der ersten Position eingeblendet wurde, und zwar als Prozentsatz der Gesamtanzahl an Aufrufen.

Rückgabewerte

Typ Beschreibung
double Dieser Wert gibt an, wie oft Ihre Anzeige in allen Ergebnissen an der ersten Position eingeblendet wurde, und zwar als Prozentsatz der Gesamtanzahl an Aufrufen.

getAverageCpc

Ermittelt die durchschnittlichen Kosten pro Klick.

Rückgabewerte

Typ Beschreibung
double Die durchschnittlichen Kosten pro Klick.

getAverageCpm

Ermittelt die durchschnittlichen Kosten pro tausend Impressionen.

Rückgabewerte

Typ Beschreibung
double Die durchschnittlichen Kosten pro tausend Impressionen.

getAveragePosition

Ermittelt die durchschnittliche Position, an der Anzeigen geschaltet wurden.

Hinweis

Diese Methode ist ab dem 31. März 2021 nicht mehr verfügbar.

Rückgabewerte

Typ Beschreibung
double Die durchschnittliche Position, an der Anzeigen geschaltet wurden.

getClickConversionRate

Ruft die Abschlussrate für Klicks ab.

Hinweis

Da diese Methode in einer zukünftigen Version veraltet sein könnte, verwenden Sie stattdessen die getConversionRate-Methode .

Rückgabewerte

Typ Beschreibung
double Die Abschlussrate für Klicks im Bereich von 0..1.

getClicks

Ruft die Anzahl der Klicks ab.

Rückgabewerte

Typ Beschreibung
long Die Anzahl der Klicks.

getConversionRate

Ruft die Abschlussrate für Klicks ab.

Rückgabewerte

Typ Beschreibung
double Die Abschlussrate für Klicks im Bereich von 0..1.

getConversions

Ruft die Anzahl der Klicks ab, die konvertiert wurden.

Rückgabewerte

Typ Beschreibung
long Die Anzahl der Klicks, die konvertiert wurden.

getConvertedClicks

Ruft die Anzahl der Klicks ab, die konvertiert wurden.

Hinweis

Da diese Methode in einer zukünftigen Version veraltet sein könnte, verwenden Sie stattdessen die getConversions-Methode .

Rückgabewerte

Typ Beschreibung
long Die Anzahl der Klicks, die konvertiert wurden.

getCost

Ruft die Kosten (Ausgaben) in der Währung des Kontos ab.

Rückgabewerte

Typ Beschreibung
double Die Kosten in der Währung des Kontos.

getCtr

Ruft die Klickrate ab.

Rückgabewerte

Typ Beschreibung
double Die Klickrate im Bereich von 0..1.

getImpressions

Ruft die Anzahl der Aufrufe ab.

Rückgabewerte

Typ Beschreibung
long Die Anzahl der Aufrufe.

getReturnOnAdSpend

Ruft die Rendite der Anzeigenausgaben ab.

Rückgabewerte

Typ Beschreibung
double Die Rendite der Anzeigenausgaben, die als (Umsatz/Kosten) * 100 berechnet wird.

getRevenue

Ruft den vom Inserenten gemeldeten Umsatz ab.

Rückgabewerte

Typ Beschreibung
double Der vom Inserenten gemeldete Umsatz.

getTopImpressionRate

Ruft ab, wie oft Ihre Anzeige im Vergleich mit Ihren gesamten Impressionen im Hauptbereich oberhalb der Suchergebnisse eingeblendet wurde, also im oberen Bereich, an dem Anzeigen über den Suchergebnissen eingeblendet wurden.

Rückgabewerte

Typ Beschreibung
double Ein Prozentwert, der angibt, wie oft Ihre Anzeige im Vergleich mit Ihren gesamten Impressionen im Hauptbereich oberhalb der Suchergebnisse eingeblendet wurde.