Abfragen erstellen und ausführen

Abfrage erstellen

Hinweis: Nicht alle Nutzer können Abfragen erstellen und bearbeiten. Weitere Informationen zur Zugriffssteuerung in Ads Data Hub

1. Gehen Sie in Ads Data Hub zum Tab Abfragen.
2. Klicken Sie auf + Abfrage erstellen. Die Seite Abfragevorlagen zur Analyse wird geöffnet.
3. Optional: Für eine Vorschau des SQL-Codes der Vorlage klicken Sie auf  Maximieren.
4. Klicken Sie auf Vorlage verwenden, um die gewünschte Vorlage auszuwählen, oder auf Leere Vorlage, um bei null anzufangen.
5. Geben Sie einen Namen für den Bericht ein.
6. Erstellen oder bearbeiten Sie die Abfrage 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.
7. Optional: Konfigurieren Sie die Parameter.
8. Optional: Konfigurieren Sie die Zusammenfassung herausgefilterter Zeilen.
9. Klicken Sie auf Speichern.

Parameter

Parameter bieten Flexibilität, beispielsweise, wenn Sie dieselbe Abfrage für verschiedene Kampagnen ausführen möchten. Anstatt doppelte Abfragen zu erstellen oder die Kampagnen-IDs vor jeder Ausführung hartzucodieren, können Sie einen Parameter konfigurieren, mit dem bei einer Abfrage 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 Abfragen wiederverwenden, ohne sie bearbeiten zu müssen. Parameter sind auf die Abfrage beschränkt, in der sie erstellt wurden. Daher können Sie einen Parameternamen in anderen Abfragen wiederverwenden.

Parametertypen

Die folgenden Parametertypen sind zulässig:

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

Parameter erstellen

1. Öffnen Sie eine gespeicherte Abfrage oder erstellen Sie eine neue.
2. Klicken Sie auf Eigenschaften > Parameter > Parameter hinzufügen.
3. Geben Sie in das Feld Name einen Namen ein. Mit diesem Namen wird im Abfragetext auf den Parameter verwiesen.
4. 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.
5. Optional: Wiederholen Sie die Schritte 2 bis 4, bis Sie alle gewünschten Parameter hinzugefügt haben.
6. Klicken Sie auf „Speichern“.

Parameter verwenden

Verwenden Sie im Abfragetext das SQL-Standardformat für Parameter. Dabei wird dem Parameternamen ein @ vorangestellt. Im folgenden Beispiel enthält die Abfrage 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

1. Öffnen Sie die Abfrage mit dem Parameter, den Sie löschen möchten.
2. Wechseln Sie zum Tab Eigenschaften.
3. Klicken Sie auf der Karte Parameter neben dem zu löschenden Parameter auf Löschen.
4. 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 Abfragen 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 Abfragejobs. 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 Abfragejobs. Ein benutzerdefinierter Parameter mit diesem Namen wird ignoriert und durch die im Dialogfeld Neuer Job festgelegten Werte ersetzt.
time_zone	string Die Zeitzone des Abfragejobs. 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 einer Abfrage, z. B. in WHERE-Klauseln, lassen sich vermeiden. Verwenden Sie time_zone, um einen Abgleich für die im Dialogfeld Neuer Job festgelegten Zeitzone durchzuführen. 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.

Hinweis: Die Aggregationsanforderungen gelten für die Zusammenfassungen herausgefilterter Zeilen selbst. Wenn eine Zusammenfassung der herausgefilterten Zeilen die Aggregationsanforderungen nicht erfüllt, wird auch sie herausgefiltert.

Abfrage bearbeiten

1. Gehen Sie in Ads Data Hub zum Tab Abfragen.
2. Klicken Sie auf den Namen der Abfrage, die Sie bearbeiten möchten.
3. Bearbeiten Sie die Abfrage.
4. Klicken Sie auf Speichern.

Abfrage ausführen

Wichtig: Sie sollten Ihre {Abfragen} in der Sandbox erstellen und testen, bevor Sie sie für echte Daten verwenden. Weitere Informationen zum Erstellen von Abfragen in Ads Data Hub

Bevor Sie eine Abfrage 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. Gehen Sie in Ads Data Hub zum Tab Abfragen.
2. Klicken Sie auf den Namen der Abfrage, die Sie ausführen möchten.
3. Klicken Sie auf Ausführen ().
   • Oben auf der Seite wird die Anzahl der Bytes angezeigt, die die Abfrage voraussichtlich verwenden wird.
4. 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.
5. Falls Sie eine Match-Table verwenden, wählen Sie sie im Drop-down-Menü Match-Table von aus.
6. Geben Sie im Feld Zieltabelle an, wo die Abfrageergebnisse gespeichert werden sollen.
7. Geben Sie ein Start- und ein Enddatum ein, um den Zeitraum für die Abfrage festzulegen.
8. Geben Sie eine Zeitzone ein. Sie sollte der Zeitzone der Kaufplattform entsprechen.
9. Optional: Geben Sie Werte für definierte Parameter ein.
10. Klicken Sie auf Ausführen.

Ergebnisse ansehen

Nachdem die Abfrage 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.