Berichterstellung

Berichte enthalten Informationen zu allen verschiedenen Ressourcen in Ihrem Konto. Sie können Informationen zu Kampagnen, Anzeigengruppen und ihren Statistiken, zum Änderungsverlauf Ihres Kontos und mehr abrufen. Die Berichtsinfrastruktur wird von der Google Ads API unterstützt und verwendet GAQL, um anzugeben welche Felder, Messwerte und Bedingungen Sie festlegen möchten.

Bericht im Vergleich zur Suche

Es gibt zwei Hauptmechanismen für die Berichterstellung. Beide akzeptieren dieselben Arten von Abfragen und unterscheiden sich hauptsächlich darin, wie sie die Ergebnisse zurückgeben.

In beiden Fällen verwenden wir die folgende Abfrage:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0

AdsApp.report()

Dadurch wird eine flache, wörterbuchähnliche Darstellung Ihrer Suchergebnisse zurückgegeben. Sie können auf Felder zugreifen, als würden Sie ein Wörterbuch verwenden, z. B. row["campaign.id"] und row["metrics.impressions"] direkt. Mit diesem Format können Sie die Ergebnisse mit der Methode exportToSheet() direkt in eine Tabelle exportieren. Dies ist nicht das Standardformat, in dem Ergebnisse von der Google Ads API zurückgegeben werden. In einigen Fällen sind einige Felder in diesem Format möglicherweise nicht verfügbar. Verwenden Sie in diesem Fall stattdessen search.

AdsApp.search()

Dadurch wird eine Liste von GoogleAdsRow-Objekten zurückgegeben, die verschiedene Felder enthalten, von denen jedes Unterfelder haben kann. Sie greifen also auf row.campaign.id und row.metrics.impressions zu, um die Daten abzurufen. Dies ist im Allgemeinen nützlicher, wenn Sie die Daten programmatisch verarbeiten möchten. Einige Felder sind möglicherweise nur im search-Format verfügbar, wenn sie nicht in eine flache Darstellung konvertiert werden können.

Hinweis: Bei Verwendung von AdsApp.search werden die zurückgegebenen Felder in lowerCamelCase angegeben, obwohl sie in underscore_case in der Abfrage angegeben sind. Wenn Ihr Feld in der Abfrage beispielsweise campaign.start_date ist, verwenden Sie campaign.startDate, um das Ergebnis aus der Zeile abzurufen.

Beispiel für einen Bericht

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

Ausführliche Informationen zur Verwendung dieser Ansicht finden Sie in der AdsApp.report Dokumentation.

Beispiel für eine Suche

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

Alle möglichen Einstellungen finden Sie in der vollständigen Adsapp.search Dokumentation.