Tworzenie i generowanie raportów

Z tego przewodnika dowiesz się, jak tworzyć i generować raporty oraz jak wyświetlać wyniki.

Kluczowy termin: Zapytanie to tekst SQL, który jest podstawą raportu. Raport składa się z kilku komponentów, w tym zapytania, ustawień wejściowych i wyjściowych, harmonogramu oraz szczegółów wykonania.

Tworzenie raportu

Analitycy i superużytkownicy mogą tworzyć i edytować raporty. Dowiedz się więcej o kontroli dostępu w Centrum danych reklam.

Ważne: aby nie utracić zmian, po wprowadzeniu aktualizacji w raporcie, w tym w harmonogramach, kliknij Zapisz.

1. W Centrum danych reklam otwórz stronę Raporty.
2. Kliknij + Utwórz raport. Otworzy się strona Tworzenie nowego raportu.
   • Szablony możesz filtrować, wyszukując je, klikając ikony produktów i wybierając opcje w menu.
3. Wybierz szablon i kliknij Użyj szablonu lub kliknij SQL, aby zacząć od zera.
   • Wyświetl podgląd szczegółów i kodu SQL szablonu, klikając expand_content Rozwiń.
4. Aby edytować raport, kliknij Edytuj zapytanie. W edytorze zapytań możesz:
   • Dostosuj raport przy użyciu kodu SQL zgodnego z BigQuery.
   • Skonfiguruj parametry na karcie Właściwości.
   • Listę dostępnych tabel i pól znajdziesz na karcie Tabele Google.
   • Na karcie Tabela danych własnych możesz wyświetlić listę zaimportowanych tabel danych własnych i ich schematów.
   • Uruchom zapytanie SQL, klikając Uruchom. Pamiętaj, że wykonania zainicjowane w edytorze zapytań SQL nie są uwzględniane w historii wykonania raportu i nie będą widoczne w sekcji Ostatnia aktywność na stronie Główna.
   • Aby potwierdzić zmiany w zapytaniu i wrócić na stronę konfiguracji raportu, kliknij Gotowe.
5. Wpisz nazwę raportu.
6. W razie potrzeby ustaw wartości parametrów na karcie Konfiguracja.
7. Skonfiguruj dane wejściowe i wyjściowe dla zadań uruchamianych w tym raporcie:
   • W polu Dane reklam z wybierz źródło danych. Powinien to być identyfikator konta Centrum danych reklam powiązany z danymi reklam, których dotyczy zapytanie. (jeśli chcesz wysyłać zapytania o dane dostępne w piaskownicy, wybierz ADH Sandbox Customer).
   • Jeśli używasz tabeli odpowiedników, wybierz ją w polu Konto tabeli odpowiedników.
   • Wybierz zakres dat i strefę czasową raportu. Strefa czasowa raportu powinna być zgodna ze strefą czasową połączonego konta reklamowego, np. konta Google Ads. Uwaga: niestandardowy zakres dat na potrzeby testowania zapytań jest obsługiwany tylko wtedy, gdy zapytanie jest uruchamiane na ekranie edytora SQL.
   • Opcjonalnie: zmień ustawienia prywatności i skonfiguruj podsumowanie wierszy po zastosowaniu filtra.
   • Wybierz projekt, zbiór danych i tabelę BigQuery, w których mają być zapisywane wyniki raportu.
8. Opcjonalnie: skonfiguruj generowanie raportu według harmonogramu.
9. Kliknij Zapisz.

---

Parametry

Parametry pozwalają określić, jak ma być uruchamiany dany raport. Gdy używasz SQL do tworzenia raportu (lub edytujesz SQL w szablonie raportu), parametry umożliwiają ponowne wykorzystanie tego samego kodu SQL w różnych raportach i ustawienie różnych wartości parametrów w każdej kopii raportu. Możesz na przykład uruchomić 2 raporty, które mają to samo zapytanie SQL lub szablon, ale dotyczą różnych zestawów identyfikatorów kampanii. W tym celu skonfiguruj parametr i ustaw jego wartość w sekcji Konfiguracja na stronie szczegółów raportu. Dzięki użyciu parametrów zachowujesz przejrzystość kodu SQL, co zmniejsza szanse popełnienia błędów podczas edycji, a także umożliwia ponowne korzystanie z tego samego zapytania SQL w różnych raportach bez konieczności edytowania wartości w samym kodzie SQL.

W tym przykładzie raport zawiera parametr o nazwie campaign_ids, który akceptuje array identyfikatorów kampanii int64:

  /* 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

Typy parametrów

Dozwolone są te typy parametrów:

• int64
• float64
• bool
• string
• date
• timestamp
• array (dowolnego dozwolonego typu).

Dodawanie parametru do raportu

1. Otwórz zapisany raport lub utwórz nowy.
2. Kliknij Edytuj zapytanie.
3. W sekcji Właściwości kliknij Dodaj parametr.
4. Wypełnij pole Nazwa. Podana w nim nazwa będzie umożliwiać odwoływanie się do parametru w tekście raportu.
5. Wybierz w menu typ parametru.
   • Jeśli wybierzesz typ tablicy, wyświetli się dodatkowe menu. Wybierz w nim typ tablicy.
6. W zapytaniu SQL dodaj parametr w standardowym formacie parametrów SQL:@PARAMETER_NAME. Zobacz przykład po tych krokach.
7. Kliknij kolejno Gotowe i Zapisz.

Używanie parametru

1. Otwórz raport, w którym skonfigurowano parametry.
2. W panelu Konfiguracja wpisz wartości każdego zdefiniowanego przez siebie parametru.
3. Aby zachować wartości parametrów, kliknij Zapisz.

Usuwanie parametru

1. Otwórz raport, w którym skonfigurowano parametry.
2. Aby otworzyć edytor SQL, kliknij Edytuj zapytanie.
3. W sekcji Właściwości kliknij usuń Usuń obok parametru, który chcesz usunąć.
4. Kliknij kolejno Gotowe i Zapisz.

Zarezerwowane parametry

W tabeli poniżej znajdziesz parametry zarezerwowane przez Centrum danych reklam. Możesz ich używać w raportach, ale nie możesz tworzyć parametrów o tych samych nazwach co zarezerwowane parametry.

start_date	date Data rozpoczęcia (włącznie z tym dniem) wykonywania zadania polegającego na wygenerowaniu raportu. Zdefiniowany przez użytkownika parametr o tej nazwie zostanie zignorowany, a następnie zastąpiony wartościami określonymi w oknie Nowe zadanie.
end_date	date Data zakończenia (włącznie z tym dniem) wykonywania zadania polegającego na wygenerowaniu raportu. Zdefiniowany przez użytkownika parametr o tej nazwie zostanie zignorowany, a następnie zastąpiony wartościami określonymi w oknie Nowe zadanie.
time_zone	string Strefa czasowa zadania polegającego na wygenerowaniu raportu. Zdefiniowany przez użytkownika parametr o tej nazwie zostanie zignorowany, a następnie zastąpiony wartościami określonymi w oknie Nowe zadanie. Wskazówka: aby uniknąć rozbieżności spowodowanych używaniem w raporcie stref czasowych, np. w klauzulach WHERE, możesz użyć parametru time_zone, aby dopasować strefę czasową do strefy ustawionej w oknie Nowe zadanie. Ważne jest też, aby używać tej samej strefy czasowej co źródło danych.
params	string Przestrzeń nazw do nazywania eksportowanych tabel. Użyj tego formatu, aby utworzyć w zapytaniu symbol zastępczy, a potem podaj nazwę tabeli podczas generowania raportu: params.TABLE_NAME (nie używaj znaku @, który poprzedza inne parametry). Więcej informacji i przykłady użycia tego parametru znajdziesz w artykule Eksportowanie wielu tabel za pomocą jednego zapytania.

---

Podsumowanie wierszy po zastosowaniu filtra

Uwaga: podsumowania wierszy po zastosowaniu filtra są niepotrzebne, gdy używasz trybu szumu. Dowiedz się więcej o zaletach używania szumu zamiast sprawdzania różnic.

Podsumowania wierszy po zastosowaniu filtra zliczają dane, które zostały odfiltrowane w efekcie sprawdzania różnic. Dane z przefiltrowanych wierszy są sumowane i dodawane do wiersza zbiorczego. Odfiltrowanych danych nie można dokładniej analizować, ale za to uzyskujesz podsumowanie ilości danych, które zostały odfiltrowane z wyników. W przypadku zapytań, które korzystają z trybu prywatności sprawdzania różnic, Centrum danych reklam automatycznie włącza i konfiguruje podsumowanie wierszy po zastosowaniu filtra. Gdy zmienisz zapytanie, Centrum danych reklam automatycznie dostosuje konfigurację na podstawie wybranych kolumn. Więcej informacji o podsumowaniach wierszy po zastosowaniu filtra lub o ręcznym konfigurowaniu takiego podsumowania znajdziesz w artykule Podsumowanie wierszy po zastosowaniu filtra.

---

Edytowanie raportu

1. W Centrum danych reklam otwórz stronę Raporty.
2. Kliknij nazwę raportu, który chcesz edytować.
3. Wprowadź zmiany w raporcie. Możesz na przykład edytować SQL, zarządzać wartościami parametrów lub ustawiać harmonogram.
4. Kliknij Zapisz.

---

Generowanie raportu

Ważne: zanim wykonasz zapytania SQL na rzeczywistych danych, możesz je przetestować w piaskownicy. Więcej sprawdzonych metod tworzenia zapytań w Centrum danych reklam

Zanim wygenerujesz raport, przyznaj kontu usługi uprawnienie dataEditor do zbioru danych, który będzie zawierał dane wyjściowe powstałe po złączeniu informacji. Więcej informacji o kontroli dostępu w BigQuery

1. W Centrum danych reklam otwórz stronę Raporty.
2. Kliknij nazwę raportu, który chcesz wygenerować.
3. Kliknij Wykonaj.

Generowanie raportu zgodnie z harmonogramem

1. W Centrum danych reklam otwórz stronę Raporty.
2. Kliknij nazwę raportu, dla którego chcesz ustawić harmonogram.
   • Aby ustawić harmonogram nowego raportu, utwórz go, a następnie kliknij Zapisz.
3. Kliknij + Ustaw harmonogram.
4. W panelu Harmonogram kliknij przełącznik Zaplanuj uruchamianie tego raportu z podanymi niżej informacjami, aby go włączyć.
5. W sekcji Częstotliwość wybierz interwał i porę dnia, a następnie wpisz strefę czasową.
   • Aby zamiast tego użyć wyrażenia cron, kliknij przełącznik Ustaw harmonogram za pomocą wyrażenia cron, aby włączyć tę opcję, a następnie wpisz wyrażenie w polu.
6. Kliknij Gotowe.
7. Aby zapisać zmiany w raporcie, kliknij Zapisz.

Aby wyświetlić zaplanowane zadania na stronie Główna, na liście filtrów Właściciel wybierz Każdy.

---

Wyświetlanie wyników

Gdy zakończy się generowanie raportu, podgląd jego wyników możesz wyświetlić na stronie szczegółów raportu. Aby wyświetlić wyniki w późniejszym czasie, otwórz raport na stronie Główna. Dane te możesz też przeglądać w BigQuery, Arkuszach Google i Studiu danych.

Podgląd

W zakończonym zadaniu kliknij Podgląd. Pod zadaniem pojawi się pierwsze 20 wyników.

BigQuery

Wyniki są domyślnie eksportowane do BigQuery. Aby otworzyć BigQuery w nowym oknie, kliknij Wyświetl tabelę.

Arkusze Google i Studio danych

Otwórz menu Przeglądaj i kliknij Przeglądaj za pomocą arkuszy lub Przeglądaj w Studiu danych. Dane wyświetlą się w nowym oknie.