Berichte erstellen und ausführen

In diesem Leitfaden erfahren Sie, wie Sie Berichte erstellen und ausführen und wie Sie sich 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 Drop-down-Optionen festlegen.
  3. Wählen Sie eine Vorlage aus und klicken Sie auf Vorlage verwenden oder auf SQL, um von Grund auf neu zu beginnen.
    • Für eine Vorschau der Vorlagendetails und des SQL-Codes klicken Sie auf expand_content Maximieren.
  4. Wenn Sie den Bericht bearbeiten möchten, klicken Sie auf Abfrage bearbeiten. Mit dem Abfrageeditor haben Sie folgende Möglichkeiten:
    • Passen Sie den Bericht mit BigQuery-kompatiblem SQL-Code an.
    • Konfigurieren Sie Parameter auf dem Tab Eigenschaften.
    • Auf dem Tab Google-Tabellen finden Sie eine Liste der verfügbaren Tabellen und Felder.
    • Auf dem Tab „1P-Tabelle“ können Sie sich eine Liste der importierten 1P-Tabellen und ihrer Schemas ansehen.
    • Führen Sie die SQL-Abfrage aus, indem Sie auf Ausführen klicken. Aus dem SQL-Abfrageeditor initiierte Ausführungen werden nicht im Ausführungsverlauf eines Berichts erfasst und sind nicht im Bereich Letzte Aktivität auf der Startseite 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 Ein- 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 sollte mit der Zeitzone des verknüpften Werbekontos übereinstimmen, z. B. eines Google Ads-Kontos. Hinweis: Ein benutzerdefinierter Zeitraum für das Testen von Abfragen wird nur unterstützt, wenn Sie die Abfrage über den SQL-Editor ausführen.
    • Optional: Ändern Sie die 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 regelmäßig erstellt werden soll.
  9. Klicken Sie auf Speichern.

Parameter

Mit Parametern können Sie festlegen, wie ein bestimmter Bericht ausgeführt werden soll. Wenn Sie SQL verwenden, um einen Bericht zu erstellen (oder wenn Sie die SQL-Anweisung einer Berichtsvorlage bearbeiten), können Sie mit Parametern denselben SQL-Code für mehrere Berichte verwenden 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 Gruppen von Kampagnen-IDs ausführen, indem Sie einen Parameter konfigurieren und seinen Wert im Bereich „Einrichtung“ auf der Seite mit den Berichtsdetails festlegen. 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 selbst bearbeiten zu müssen.

Im folgenden Beispiel enthält der Bericht einen Parameter namens 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)

Parameter zu einem Bericht hinzufügen

  1. Öffnen Sie einen gespeicherten Bericht oder erstellen Sie einen neuen.
  2. Klicken Sie auf Abfrage bearbeiten.
  3. Klicken Sie unter Eigenschaften auf 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 in diesem Drop-down-Menü den Arraytyp aus.
  6. Fügen Sie den Parameter in die SQL-Abfrage ein. Verwenden Sie dazu das Standard-SQL-Parameterformat: @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.
  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.
params string

Namespace für die Benennung exportierter Tabellen. Verwenden Sie das folgende Format, um einen Platzhalter in Ihrer Abfrage zu erstellen, und geben Sie dann den Tabellennamen an, wenn Sie den Bericht ausführen: params.TABLE_NAME (verwenden Sie kein vorangestelltes @ wie bei anderen Parametern). Weitere Informationen und Beispiele zur Verwendung dieses Parameters finden Sie unter Mehrere Tabellen mit einer einzigen Abfrage exportieren.

Zusammenfassung herausgefilterter Zeilen

Vorteile der Verwendung von Noise anstelle von Differenzprüfungen

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 „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 zur Zusammenfassung herausgefilterter Zeilen oder zum manuellen Konfigurieren einer solchen Zusammenfassung 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 Ä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.

Bericht nach Zeitplan erstellen

  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. Klicken Sie im Bereich Zeitplan auf den Schalter Ausführung dieses Berichts mit den folgenden Details planen, um ihn zu aktivieren.
  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, klicken Sie auf die Ein/Aus-Schaltfläche Zeitplan mithilfe eines Cron-Ausdrucks einrichten und geben Sie den Ausdruck dann 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 Seite 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 ansehen möchten, öffnen Sie den Bericht auf der Seite 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.