Filtry w Data Studio ukrywają wiersze – ale nie zmieniają samego zapytania SQL wysyłanego do bazy danych. Gdy potrzebujesz, by użytkownik mógł przełączyć walutę, wybrać granulację czasową albo podać wartość marży używaną do obliczeń, zwykły filtr nie wystarczy. Tu wchodzą parametry – funkcja, która pozwala wstrzykiwać wartości bezpośrednio do kodu SQL w BigQuery.

1. Czym są parametry w Data Studio?

Parametr to zmienna zdefiniowana na poziomie źródła danych, której wartość użytkownik raportu może zmieniać przez specjalną kontrolkę (suwak, pole tekstowe, lista wyboru). Wartość parametru jest następnie wstawiana do zapytania SQL wykonanego przez BigQuery. Efekt: jeden raport, wiele możliwych widoków danych – bez tworzenia osobnych kopii dashboardu dla każdego działu czy scenariusza.

Parametry działają wyłącznie ze źródłami BigQuery (Custom Query) oraz Google Sheets (z pewnymi ograniczeniami). Nie są dostępne w natywnym konektorze GA4.

2. Typy parametrów

  • Text: wartość tekstowa wstawiana do klauzuli WHERE lub IN. Przykład: nazwa regionu, kod kraju, identyfikator kampanii.
  • Number: wartość liczbowa używana w obliczeniach. Przykład: zakładana marża procentowa, kurs wymiany walut, próg budżetowy.
  • Boolean: przełącznik true/false. Przykład: "pokaż / ukryj testowych użytkowników".

3. Krok po kroku: definicja i użycie parametru

Krok 1: Utwórz źródło BigQuery z Custom Query

W Data Studio dodaj nowe źródło danych → BigQuery → Custom Query. Wpisz projekt i zestaw danych, a następnie kliknij "Add a parameter" w dolnym panelu edytora SQL.

Krok 2: Zdefiniuj parametr

Podaj nazwę (np. margin_rate), typ (Number) i wartość domyślną (np. 0.30 dla 30% marży). Kliknij OK.

Krok 3: Użyj parametru w SQL

W zapytaniu SQL odwołuj się do parametru przez prefiks @:

SELECT
  product_name,
  revenue,
  cost,
  revenue - cost AS gross_profit,
  (revenue - cost) / revenue AS actual_margin,
  revenue * @margin_rate AS target_margin_value
FROM `projekt.dataset.orders`
WHERE region = @region_param
  AND DATE(order_date) BETWEEN @date_from AND @date_to

Krok 4: Dodaj kontrolkę parametru do raportu

W edytorze raportu wybierz "Dodaj kontrolkę" → "Parametr wejściowy" (Input Box) lub "Suwak zakresu" (Slider). Połącz kontrolkę z parametrem margin_rate. Teraz użytkownik może wpisać wartość, a raport przelicza wyniki na żywo.

4. Praktyczne zastosowania w B2B

Kalkulator marży i ROAS

Użytkownik podaje planowaną marżę procentową, a SQL oblicza, przy jakim ROAS kampania wychodzi na zero. Szczegółową konfigurację opisałem w: Dynamiczny kalkulator ROAS w Data Studio.

Przełączanie granulacji danych

Parametr tekstowy groupby_dim z wartościami "day", "week", "month" pozwala użytkownikowi przełączać poziom agregacji wykresu. W SQL używasz DATE_TRUNC(order_date, @groupby_dim).

Segmentacja bez osobnych raportów

Parametr region_param z listą wyboru opartą na kontrolce Select – jeden raport obsługuje wszystkie regiony sprzedaży bez duplikacji.

5. Ograniczenia i pułapki

  • Bezpieczeństwo: parametry SQL nie zastępują Row-Level Security. Użytkownik może ręcznie zmienić wartość parametru w URL. Do kontroli dostępu użyj filtrów emailowych RLS.
  • Koszt zapytań BigQuery: każda zmiana parametru uruchamia nowe zapytanie SQL. Przy parametrach tekstowych w klauzuli WHERE upewnij się, że tabela jest partycjonowana, by uniknąć pełnego skanu.
  • Brak obsługi w konektorze natywnym GA4: parametry działają tylko w BigQuery Custom Query. Jeśli używasz GA4 przez natywny konektor, parametryzacja jest niedostępna.

Powiązane artykuły