Berichte erstellen und ausführen

Bericht erstellen

Gehen Sie in Ads Data Hub zum Tab Abfragen.
Klicken Sie auf + Abfrage erstellen. Die Seite Neuen Bericht erstellen wird geöffnet.
Optional: Zum Filtern von Vorlagen können Sie die Suche oder entsprechende Symbole verwenden oder die gewünschten Optionen aus dem Drop-down-Menü auswählen:
- Datenquelle
- Anwendungsfall
- Inventar
- MRC-Akkreditierung
Optional: Für eine Vorschau der Vorlagendetails und des SQL-Codes klicken Sie auf expand_content Maximieren.
Klicken Sie auf Vorlage verwenden und wählen Sie die gewünschte Vorlage aus oder aufadd_circle Hinzufügen, um bei null anzufangen.
Geben Sie einen Namen für den Bericht ein.
Erstellen oder bearbeiten Sie den Bericht mit BigQuery-kompatiblem SQL-Code. Auf dem Tab Google-Tabellen finden Sie alle Tabellen und Felder, die Sie in Ihren SQL-Code einfügen können.
Optional: Konfigurieren Sie die Parameter.
Optional: Konfigurieren Sie die Zusammenfassung herausgefilterter Zeilen.
Klicken Sie auf Speichern.

Parameter

Parameter bieten Flexibilität, beispielsweise, wenn Sie denselben Bericht für mehrere Kampagnen ausführen möchten. Anstatt doppelte Berichte zu erstellen oder die Kampagnen-IDs vor jeder Ausführung hartzucodieren, können Sie einen Parameter konfigurieren, mit dem beim Ausführen eines Berichts eine oder mehrere Kampagnen-IDs auf der Karte „Ausführen“ eingegeben werden können. Parameter sorgen für sauberen Code und verringern die Wahrscheinlichkeit, dass beim Bearbeiten Fehler eingebaut werden. Außerdem können Sie Berichte dann wiederverwenden, ohne sie bearbeiten zu müssen. Parameter sind auf den Bericht beschränkt, in dem sie erstellt wurden. Daher können Sie einen Parameternamen in anderen Berichten wiederverwenden.

Parametertypen

Die folgenden Parametertypen sind zulässig:

int64
float64
bool
string
date
timestamp
array, alle zulässigen Typen

Parameter erstellen

Öffnen Sie einen gespeicherten Bericht oder erstellen Sie einen neuen.
Klicken Sie auf Eigenschaften > Parameter > Parameter hinzufügen.
Geben Sie in das Feld Name einen Namen ein. Mit diesem Namen wird im Berichtstext auf den Parameter verwiesen.
Wählen Sie im Drop-down-Menü den Parametertyp aus.
- Wenn Sie ein Array auswählen, wird ein zusätzliches Drop-down-Menü angezeigt. Wählen Sie hier den Arraytyp aus.
Optional: Wiederholen Sie die Schritte 2 bis 4, bis Sie alle gewünschten Parameter hinzugefügt haben.
Klicken Sie auf „Speichern“.

Parameter verwenden

Verwenden Sie im Berichtstext das SQL-Standardformat für Parameter. Dabei wird dem Parameternamen ein @ vorangestellt. Im folgenden Beispiel enthält der Bericht den Parameter @campaign_ids:

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

  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

Wenn Sie die Abfrage ausführen, enthält das Dialogfeld Neuer Job das Feld Parameter. Geben Sie Werte für alle von Ihnen definierten Parameter ein.

Parameter entfernen

Öffnen Sie den Bericht mit dem Parameter, den Sie löschen möchten.
Wechseln Sie zum Tab Eigenschaften.
Klicken Sie auf der Karte Parameter neben dem zu löschenden Parameter auf Löschen.
Klicken Sie 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. Tipp: Diskrepanzen bei der Verwendung von Zeitzonen in einem Bericht, z. B. in `WHERE`-Klauseln, lassen sich vermeiden: Benutzen Sie einfach `time_zone`, um die in Neuer Job festgelegte Zeitzone zu übernehmen. Außerdem ist es wichtig, dieselbe Zeitzone wie in der Datenquelle zu verwenden.

Zusammenfassung herausgefilterter Zeilen

Zusammenfassungen herausgefilterter Zeilen enthalten Daten, die aufgrund von Datenschutzprü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.

Bericht bearbeiten

Gehen Sie in Ads Data Hub zum Tab Abfragen.
Klicken Sie auf den Namen des Berichts, den Sie bearbeiten möchten.
Bearbeiten Sie den Bericht.
Klicken Sie auf Speichern.

Bericht ausführen

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

Gehen Sie in Ads Data Hub zum Tab Abfragen.
Klicken Sie auf den Namen des Berichts, den Sie ausführen möchten.
Klicken Sie auf play_arrow Ausführen.
- Oben auf der Seite wird die Anzahl der Bytes angezeigt, die der Bericht voraussichtlich verwenden wird.
Wählen Sie im Drop-down-Menü Anzeigendaten von eine ID aus. Es sollte die 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 Drop-down-Menü Match-Table von aus.
Geben Sie im Feld Zieltabelle an, wo die Berichtsergebnisse gespeichert werden sollen.
Geben Sie ein Start- und ein Enddatum ein, um den Zeitraum für den Bericht festzulegen.
Geben Sie eine Zeitzone ein. Sie sollte der Zeitzone der Kaufplattform entsprechen.
Optional: Geben Sie Werte für definierte Parameter ein.
Klicken Sie auf Ausführen.

Ergebnisse ansehen

Nachdem der Bericht ausgeführt wurde, können Sie sich auf der Seite „Jobs“ eine Vorschau der Ergebnisse ansehen. Außerdem ist es möglich, die Daten in BigQuery, Google Tabellen 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 Tabellen 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.