Berichterstellung

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

Berichte und Suche im Vergleich

Für die Berichterstellung gibt es zwei Hauptmethoden. Beide akzeptieren die gleichen Arten von Abfragen und unterscheiden sich hauptsächlich in der Art und Weise, 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()

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

AdsApp.search()

Es wird eine Liste von GoogleAdsRow-Objekten mit verschiedenen Feldern zurückgegeben, von denen jedes untergeordnete Felder haben kann. Sie würden also auf row.campaign.id und row.metrics.impressions zugreifen, um die Daten abzurufen. Dies ist im Allgemeinen nützlicher, wenn Sie die Daten programmatisch verarbeiten möchten und einige Felder möglicherweise nur im Format search verfügbar sind, wenn sie nicht in eine flache Darstellung konvertiert werden können.

Hinweis: Bei Verwendung von AdsApp.search werden die zurückgegebenen Felder in lowerCamelCase zurückgegeben, obwohl 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 Dokumentation zu AdsApp.report.

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

Weitere Informationen zu allen möglichen Einstellungen finden Sie in der vollständigen Dokumentation zu Adsapp.search.