Berichterstellung

Berichte enthalten Informationen zu allen verschiedenen Ressourcen in Ihrem Konto. Sie können unter anderem Informationen zu Kampagnen, Anzeigengruppen und deren Statistiken abrufen und den Verlauf für Ihr Konto ändern. Die Berichtsinfrastruktur wird von der Google Ads API unterstützt und verwendet GAQL, um anzugeben, welche Felder, Messwerte und Bedingungen festgelegt werden sollen.

Melden und Suchen

Es gibt zwei Hauptmechanismen für die Meldung von Problemen. Beide akzeptieren dieselben Arten von Abfragen und unterscheiden sich hauptsächlich in der Art und Weise, wie die Ergebnisse zurückgegeben werden.

Für beide Fälle 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 erhalten Sie eine flache, lexikonähnliche Darstellung Ihrer Suchergebnisse. Sie können auf Felder zugreifen, als würden Sie ein Wörterbuch verwenden, z. B. direkt auf row["campaign.id"] und row["metrics.impressions"]. Mit diesem Format können Sie die Ergebnisse mit der Methode exportToSheet() direkt in eine Tabelle exportieren. Das ist nicht das native Format, in dem Ergebnisse von der Google Ads API zurückgegeben werden. Daher 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 mit verschiedenen Feldern zurückgegeben, von denen jedes Unterfelder haben kann. Sie greifen also auf row.campaign.id und row.metrics.impressions zu, um die Daten abzurufen. Das ist in der Regel 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 umgewandelt werden können.

Hinweis: Wenn Sie AdsApp.search verwenden, werden die zurückgegebenen Felder in lowerCamelCase angezeigt, auch wenn sie in der Abfrage in underscore_case angegeben sind. Wenn das 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.

Suchbeispiel

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;
}

Eine vollständige Liste der Einstellungen finden Sie in der vollständigen Dokumentation zu Adsapp.search.