Berichterstellung

Berichte enthalten Informationen zu den verschiedenen Ressourcen in Ihrem Konto. Sie können Informationen zu Kampagnen, Anzeigengruppen und deren Statistiken abrufen, Kontoverlauf und mehr. Die Berichtsinfrastruktur basiert auf der Google Ads API und verwendet GAQL, um anzugeben, welche Felder, Messwerte und Bedingungen Sie festlegen möchten.

Bericht und Suche im Vergleich

Für die Meldung gibt es zwei Hauptmechanismen. Beide akzeptieren die gleichen 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 Suche zurückgegeben Ergebnisse. Sie können auf Felder wie ein Wörterbuch zugreifen, z. B. row["campaign.id"] und row["metrics.impressions"] direkt. Mit diesem -Format können Sie die Ergebnisse direkt in eine Tabelle exportieren. Verwenden Sie dazu die exportToSheet()-Methode. Dies ist nicht das native Format, werden von der Google Ads API zurückgegeben. Daher sind in einigen Fällen einige Felder nicht verfügbar. in diesem Format. In diesem Fall sollten Sie stattdessen search verwenden.

AdsApp.search()

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

Hinweis: Bei der Verwendung von AdsApp.search liegen die zurückgegebenen Felder in lowerCamelCase, obwohl sie in underscore_case im Abfrage. Wenn das Feld in der Abfrage beispielsweise campaign.start_date lautet, gilt Folgendes: verwenden Sie campaign.startDate, um das Ergebnis aus der Zeile abzurufen.

Beispiel für 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"];
}

Werfen Sie einen Blick auf die AdsApp.report Dokumentation finden Sie alle Einzelheiten zur Verwendung dieser Ansicht.

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

Vollständige Beratung Adsapp.search Dokumentation zu allen möglichen Einstellungen.