Berichte erstellen und ausführen

In diesem Leitfaden erfahren Sie, wie Sie Berichte erstellen und ausführen sowie die Ergebnisse ansehen.

Bericht erstellen

Analysten und Superuser können Berichte erstellen und bearbeiten. Weitere Informationen zur Zugriffssteuerung in Ads Data Hub

  1. Öffnen Sie in Ads Data Hub die Seite Berichte.
  2. Klicken Sie auf + Bericht erstellen. Die Seite Neuen Bericht erstellen wird geöffnet.
    • Sie können Vorlagen filtern, indem Sie die Suche verwenden, Produktsymbole auswählen und die gewünschten Optionen aus dem Drop-down-Menü auswählen.
  3. Wählen Sie eine Vorlage aus und klicken Sie auf Vorlage verwenden oder auf SQL, um von null anzufangen.
    • Klicken Sie auf expand_content Maximieren, um eine Vorschau der Vorlagendetails und des SQL-Codes zu sehen.
  4. Klicken Sie auf Abfrage bearbeiten, um den Bericht zu bearbeiten. Mit dem Abfrageeditor können Sie Folgendes tun:
    • Passen Sie den Bericht mit BigQuery-kompatiblem SQL-Code an.
    • Konfigurieren Sie die Parameter auf dem Tab Eigenschaften.
    • Auf dem Tab Google-Tabellen finden Sie eine Liste der verfügbaren Tabellen und Felder.
    • Auf dem Tab „Eigene Tabellen“ finden Sie eine Liste der importierten selbst erhobenen Tabellen und ihrer Schemas.
    • Klicken Sie auf Ausführen, um die SQL-Abfrage auszuführen. Aus dem SQL-Abfrageeditor gestartete Ausführungen werden nicht in den Ausführungsverlauf eines Berichts aufgenommen und sind auf der Seite Startseite nicht im Bereich Letzte Aktivitäten zu sehen.
    • Klicken Sie auf Fertig, um die Änderungen an der Abfrage zu bestätigen und zur Seite „Berichtseinrichtung“ zurückzukehren.
  5. Geben Sie einen Namen für den Bericht ein.
  6. Legen Sie gegebenenfalls die Parameterwerte auf der Karte „Einrichtung“ fest.
  7. Konfigurieren Sie die Eingabe und Ausgabe für Jobs, die für diesen Bericht ausgeführt werden:
    • Wählen Sie im Feld Anzeigendaten von eine Datenquelle aus. Es sollte die Ads Data Hub-Konto-ID sein, die den Anzeigendaten zugeordnet ist, die Sie abfragen möchten. Wenn Sie Sandbox-Daten abfragen möchten, wählen Sie „ADH Sandbox Customer“ aus.
    • Falls Sie eine Match-Table verwenden, wählen Sie sie im Feld Match-Table-Konto aus.
    • Wählen Sie einen Zeitraum und eine Zeitzone für den Bericht aus. Die Zeitzone des Berichts muss mit der Zeitzone des verknüpften Google Ads-Kontos übereinstimmen. Hinweis: Benutzerdefinierte Zeiträume für den Abfragetest werden nur unterstützt, wenn Sie die Abfrage über den SQL-Editor ausführen.
    • Optional: Ändern Sie Ihre Datenschutzeinstellungen und konfigurieren Sie die Zusammenfassung herausgefilterter Zeilen.
    • Wählen Sie das BigQuery-Projekt, das Dataset und die Tabelle aus, in denen die Berichtsergebnisse gespeichert werden sollen.
  8. Optional: Legen Sie fest, dass der Bericht nach einem Zeitplan erstellt wird.
  9. Klicken Sie auf Speichern.

Parameter

Mithilfe von Parametern können Sie festlegen, wie ein bestimmter Bericht ausgeführt werden soll. Wenn Sie einen Bericht mit SQL erstellen oder den SQL-Code aus einer Berichtsvorlage bearbeiten, können Sie mithilfe von Parametern denselben SQL-Code für mehrere Berichte wiederverwenden und für jede Kopie des Berichts unterschiedliche Parameterwerte festlegen. Sie können beispielsweise zwei Berichte mit derselben SQL-Abfrage oder Vorlage für verschiedene Kampagnen-IDs ausführen. Dazu konfigurieren Sie einen Parameter und legen seinen Wert im Bereich „Einrichtung“ auf der Seite mit den Berichtsdetails fest. Parameter sorgen für sauberen SQL-Code und verringern die Wahrscheinlichkeit, dass beim Bearbeiten Fehler eingebaut werden. Außerdem können Sie dieselbe SQL-Abfrage in mehreren Berichten wiederverwenden, ohne Werte im SQL-Code bearbeiten zu müssen.

Im folgenden Beispiel enthält der Bericht den Parameter campaign_ids, der eine array von int64 Kampagnen-IDs akzeptiert:

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

Parametertypen

Die folgenden Parametertypen sind zulässig:

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • array (alle zulässigen Typen)

Berichten Parameter hinzufügen

  1. Öffnen Sie einen gespeicherten Bericht oder erstellen Sie einen neuen.
  2. Klicken Sie auf Abfrage bearbeiten.
  3. Klicken Sie unter Properties (Properties) auf Add parameter (Parameter hinzufügen).
  4. Geben Sie in das Feld Name einen Namen ein. Mit diesem Namen wird im Berichtstext auf den Parameter verwiesen.
  5. Wählen Sie im Drop-down-Menü den Parametertyp aus.
    • Wenn Sie den Arraytyp auswählen, wird ein zusätzliches Drop-down-Menü angezeigt. Wählen Sie hier den Arraytyp aus.
  6. Fügen Sie den Parameter in der SQL-Abfrage mit dem Standard-SQL-Parameterformat hinzu: @PARAMETER_NAME. Das nach diesen Schritten folgende Beispiel veranschaulicht dies.
  7. Klicken Sie auf Fertig und dann auf Speichern.

Parameter verwenden

  1. Öffnen Sie einen Bericht, für den Parameter konfiguriert sind.
  2. Geben Sie im Bereich Einrichtung Werte für alle von Ihnen definierten Parameter ein.
  3. Klicken Sie auf Speichern, um die Parameterwerte beizubehalten.

Parameter entfernen

  1. Öffnen Sie einen Bericht, für den Parameter konfiguriert sind.
  2. Klicken Sie auf Abfrage bearbeiten, um den SQL-Editor zu öffnen.
  3. Klicken Sie unter Attribute neben dem zu löschenden Parameter auf „Löschen“ Delete.
  4. Klicken Sie auf Fertig und dann auf Speichern.

Reservierte Parameter

In der folgenden Tabelle sind die für Ads Data Hub reservierten Parameter aufgeführt. Sie können diese Parameter in Ihren Berichten verwenden, aber es ist nicht möglich, einen Parameter mit demselben Namen wie ein reservierter Parameter zu erstellen.

start_date date

Das Startdatum (erster Tag eingeschlossen) des Berichtjobs. Ein benutzerdefinierter Parameter mit diesem Namen wird ignoriert und durch die im Dialogfeld Neuer Job festgelegten Werte ersetzt.
end_date date

Das Enddatum (letzter Tag eingeschlossen) des Berichtjobs. Ein benutzerdefinierter Parameter mit diesem Namen wird ignoriert und durch die im Dialogfeld Neuer Job festgelegten Werte ersetzt.
time_zone string

Die Zeitzone des Berichtsjobs. Ein benutzerdefinierter Parameter mit diesem Namen wird ignoriert und durch die im Dialogfeld Neuer Job festgelegten Werte ersetzt.

Zusammenfassung herausgefilterter Zeilen

Zusammenfassungen herausgefilterter Zeilen enthalten Daten, die aufgrund von Differenzprüfungen herausgefiltert wurden. Die Daten aus herausgefilterten Zeilen werden summiert und in eine universelle Zeile eingefügt. Auch wenn die entsprechenden Daten nicht weiter analysiert werden können, erhalten Sie einen Überblick, wie viele Daten aus den Ergebnissen herausgefiltert wurden. Bei Abfragen, für die der Datenschutzmodus mit Differenzprüfungen verwendet wird, wird in Ads Data Hub automatisch eine Zusammenfassung herausgefilterter Zeilen aktiviert und konfiguriert. Während Sie die Abfrage bearbeiten, wird die Konfiguration in Ads Data Hub automatisch auf Grundlage der ausgewählten Spalten angepasst. Weitere Informationen zu Zusammenfassungen herausgefilterter Zeilen oder zur manuellen Konfiguration finden Sie unter Zusammenfassung herausgefilterter Zeilen.

Bericht bearbeiten

  1. Öffnen Sie in Ads Data Hub die Seite Berichte.
  2. Klicken Sie auf den Namen des Berichts, den Sie bearbeiten möchten.
  3. Nehmen Sie die gewünschten Änderungen am Bericht vor. Sie können beispielsweise den SQL-Code bearbeiten, Parameterwerte verwalten oder einen Zeitplan festlegen.
  4. Klicken Sie auf Speichern.

Bericht erstellen

Bevor Sie einen Bericht ausführen, müssen Sie dem Dienstkonto die Berechtigung dataEditor für das Dataset erteilen, das die Ausgabe Ihrer Joins enthalten soll. Weitere Informationen zur Zugriffssteuerung in BigQuery

  1. Öffnen Sie in Ads Data Hub die Seite Berichte.
  2. Klicken Sie auf den Namen des Berichts, den Sie ausführen möchten.
  3. Klicken Sie auf Ausführen.

Berichte nach Zeitplan ausführen

  1. Öffnen Sie in Ads Data Hub die Seite Berichte.
  2. Klicken Sie auf den Namen des Berichts, für den Sie einen Zeitplan festlegen möchten.
    • Wenn Sie einen Zeitplan für einen neuen Bericht festlegen möchten, erstellen Sie den Bericht und klicken Sie dann auf Speichern.
  3. Klicken Sie auf + Zeitplan festlegen.
  4. Aktivieren Sie im Bereich Planen die Option Ausführung dieses Berichts mit den folgenden Details planen.
  5. Wählen Sie unter Häufigkeit ein Intervall und eine Uhrzeit aus und geben Sie dann eine Zeitzone ein.
    • Wenn Sie stattdessen einen Cron-Ausdruck verwenden möchten, aktivieren Sie die Option Zeitplan mithilfe eines Cron-Ausdrucks einrichten und geben Sie den Ausdruck in das Feld ein.
  6. Klicken Sie auf Fertig.
  7. Klicken Sie auf Speichern, um die Änderungen am Bericht zu übernehmen.

Wenn Sie geplante Jobs auf der Startseite anzeigen lassen möchten,wählen Sie in der Filterliste Inhaber die Option Beliebig aus.

Ergebnisse ansehen

Nachdem der Bericht ausgeführt wurde, können Sie sich auf der Seite mit den Berichtsdetails eine Vorschau der Ergebnisse ansehen. Wenn Sie die Ergebnisse später aufrufen möchten, öffnen Sie den Bericht auf der Startseite. Außerdem ist es möglich, die Daten in BigQuery, Google Sheets oder Data Studio anzusehen.

Vorschau

Klicken Sie im abgeschlossenen Job auf Vorschau. Die ersten 20 Ergebnisse werden unter dem Job angezeigt.

BigQuery

Die Ergebnisse werden standardmäßig nach BigQuery exportiert. Klicken Sie auf Tabelle anzeigen, um BigQuery in einem neuen Fenster zu öffnen.

Google Sheets und Data Studio

Öffnen Sie das Drop-down-Menü Weitere Informationen zu Daten anzeigen und wählen Sie Mit Tabellen ansehen oder Mit Data Studio ansehen aus. Dadurch werden die Daten in einem neuen Fenster angezeigt.