Przydatny asystent analityczny potrzebuje odpowiedzi, kt\u00f3re mo\u017cna sprawdzi\u0107. Ten tutorial pyta Analytics Advisor o sesje wed\u0142ug kana\u0142\u00f3w, dodaje okres por\u00f3wnawczy i kontroluje liczby przez jednoznaczne zapytanie Data API. Wynikiem jest ma\u0142a analiza z zapisanymi wej\u015bciami i wynikami, a nie bezkrytycznie przyj\u0119te wyja\u015bnienie.<\/p>\n
Dokumentacja sprawdzona: 25 wrze\u015bnia 2026 r.<\/strong> Metoda chat nale\u017cy do wczesnej wersji v1alpha. Dost\u0119pno\u015b\u0107 i uprawnienia wymagaj\u0105 sprawdzenia dla konkretnej us\u0142ugi GA4. 27 wrze\u015bnia 2026 r. trzy udokumentowane zapytania API wykonano z wiersza polece\u0144 dla autoryzowanej us\u0142ugi GA4. Strukturalna tabela dla okresu 1\u20137 wrze\u015bnia by\u0142a dok\u0142adnie zgodna ze wszystkimi czterema wierszami grup kana\u0142\u00f3w z runReport; warto\u015bci us\u0142ugi nie s\u0105 tutaj publikowane. [1]<\/a><\/p>\n Przyk\u0142ad por\u00f3wnuje 1\u20137 wrze\u015bnia 2026 r. z 25\u201331 sierpnia 2026 r. Oba okresy maj\u0105 siedem dni i taki sam uk\u0142ad dni tygodnia. Metryka to Kana\u0142 to grupa atrybucyjna, nie osoba ani bud\u017cet kampanii. Pierwsze pytanie celowo dotyczy liczby, a nie przyczyny. Ni\u017cszy wynik mo\u017ce uzasadnia\u0107 analiz\u0119, ale sam nie dowodzi wp\u0142ywu okre\u015blonego dzia\u0142ania marketingowego.<\/p>\n Przyk\u0142ad dzia\u0142a w Bash z zainstalowanymi gcloud, curl i jq. Projekt Cloud wymaga w\u0142\u0105czonego Analytics Data API. Zalogowane konto potrzebuje dost\u0119pu do us\u0142ugi GA4 i uprawnienia do korzystania z projektu rozliczaj\u0105cego limity. Identyfikator projektu Cloud i numeryczny identyfikator us\u0142ugi Analytics to r\u00f3\u017cne warto\u015bci.<\/p>\n Chat wymaga Aktualne wersje Cloud CLI mog\u0105 blokowa\u0107 te zakresy Analytics dla wbudowanego klienta OAuth. W docelowym projekcie Cloud nale\u017cy utworzy\u0107 klienta OAuth typu aplikacja komputerowa, pobra\u0107 plik JSON i przekaza\u0107 go przez Poprawna odpowied\u017a mo\u017ce zawiera\u0107 bloki tekstu i tabel. Zapis ca\u0142ej odpowiedzi zachowuje kontekst. Brak tabeli nie oznacza tabeli z zerami. Symboli walut, procent\u00f3w i sformatowanych warto\u015bci nie nale\u017cy bez wyja\u015bnienia zamienia\u0107 w same liczby. Struktura odpowiedzi i pola sesji maj\u0105 osobn\u0105 dokumentacj\u0119. [2]<\/a><\/p>\n Nast\u0119pne polecenie odczytuje identyfikator sesji z odpowiedzi; jego brak zatrzymuje skrypt. Potem nast\u0119puje pytanie o wcze\u015bniejszy okres. Przy kolejnych krokach \u017ar\u00f3d\u0142em identyfikatora jest najnowsza odpowied\u017a. R\u00f3\u017cne us\u0142ugi, klienci i konteksty uprawnie\u0144 wymagaj\u0105 oddzielnego przechowywania sesji.<\/p>\n Kontekst sesji \u0142\u0105czy pytania, ale nie zast\u0119puje jednoznacznych dat i definicji. \u201eOrganic Search spad\u0142\u201d opisuje wynik. \u201eNowa strona docelowa spowodowa\u0142a spadek\u201d wymaga dodatkowych dowod\u00f3w. Zachowanie obu pyta\u0144 pozwala sprawdzi\u0107 t\u0119 r\u00f3\u017cnic\u0119.<\/p>\n Drugie zapytanie API pobiera bezpo\u015brednio oba okresy, ten sam wymiar i t\u0119 sam\u0105 metryk\u0119. Powstaje niezale\u017cny raport zamiast pro\u015bby, aby asystent potwierdzi\u0142 w\u0142asn\u0105 odpowied\u017a. API raportowe opisuje zakresy dat, nag\u0142\u00f3wki, liczb\u0119 wierszy i metadane. [3]<\/a><\/p>\n Kolejno\u015b\u0107 nag\u0142\u00f3wk\u00f3w okre\u015bla interpretacj\u0119 warto\u015bci w wierszach. Przy wielu zakresach dodatkowy wymiar okresu rozr\u00f3\u017cnia przedzia\u0142y. Por\u00f3wnanie wy\u0142\u0105cznie wed\u0142ug pozycji wiersza jest niew\u0142a\u015bciwe: kana\u0142y mog\u0105 mie\u0107 inn\u0105 kolejno\u015b\u0107 lub nie wyst\u0119powa\u0107. R\u00f3\u017cnica dla kana\u0142u to warto\u015b\u0107 bie\u017c\u0105ca minus poprzednia. Zmiana procentowa wymaga poprzedniej warto\u015bci r\u00f3\u017cnej od zera; brak wiersza nie jest zmierzon\u0105 warto\u015bci\u0105 zerow\u0105.<\/p>\n Inspektor odpowiedzi GA4 API<\/a> przyjmuje zapisany Dokumentacja analizy obejmuje dwa pytania, dwie odpowiedzi chat, \u017c\u0105danie raportu, odpowied\u017a raportow\u0105 i czas pobrania. Dost\u0119p powinien odpowiada\u0107 poufno\u015bci danych us\u0142ugi. Informacja Google o prywatno\u015bci wskazuje mo\u017cliwo\u015b\u0107 przetwarzania rozm\u00f3w przez ludzi w celu ulepszania produktu. Nazwy klient\u00f3w i poufne plany kampanii nie powinny trafia\u0107 do pytania dotycz\u0105cego samych liczb. [5]<\/a><\/p>\n Ko\u0144cowym wynikiem jest udokumentowana liczba z wyja\u015bnieniem rozbie\u017cno\u015bci. Wynik mo\u017ce te\u017c brzmie\u0107 \u201enie uda\u0142o si\u0119 odtworzy\u0107\u201d. Obie mo\u017cliwo\u015bci s\u0105 bardziej u\u017cyteczne ni\u017c niepoparta dowodami rekomendacja zmiany bud\u017cetu reklamowego.<\/p>\n Powtarzalne por\u00f3wnanie kana\u0142\u00f3w przez properties.chat, kontekst sesji, limity oraz oddzielne zapytanie kontrolne runReport.<\/p>\n","protected":false},"author":1,"featured_media":20691,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[],"class_list":["post-20611","post","type-post","status-publish","format-standard","hentry","category-digital-analytics-pl"],"yoast_head":"\n1. Zdefiniowanie ograniczonego pytania<\/h2>\n
sessions<\/code>, a grupowanie to sessionDefaultChannelGroup<\/code>. Nazwy pochodz\u0105 ze schematu API. [4]<\/a> Konkretne daty eliminuj\u0105 zmienny sens okre\u015blenia \u201eostatni tydzie\u0144\u201d.<\/p>\n2. Autoryzacja i zapis pierwszej odpowiedzi<\/h2>\n
analytics.chatbot.read<\/code>, a p\u00f3\u017aniejsza kontrola raportu analytics.readonly<\/code>. Przyk\u0142ad prosi o oba zakresy. Dane uwierzytelniaj\u0105ce pozostaj\u0105 w lokalnym procesie logowania gcloud; nie nale\u017c\u0105 do kodu artyku\u0142u ani publicznej strony. [1]<\/a>[3]<\/a><\/p>\n--client-id-file<\/code>. Google dokumentuje ten parametr dla zakres\u00f3w spoza domy\u015blnego zestawu Cloud. [6]<\/a><\/p>\n# Bash; gcloud, curl and jq required\nset -euo pipefail\nexport PROJECT_ID='REPLACE_WITH_CLOUD_PROJECT'\nexport PROPERTY_ID='REPLACE_WITH_NUMERIC_PROPERTY_ID'\nexport OAUTH_CLIENT_FILE='REPLACE_WITH_DOWNLOADED_DESKTOP_CLIENT_JSON'\ngcloud auth application-default login --client-id-file=\"$OAUTH_CLIENT_FILE\" --scopes=\"https:\/\/www.googleapis.com\/auth\/cloud-platform,https:\/\/www.googleapis.com\/auth\/analytics.chatbot.read,https:\/\/www.googleapis.com\/auth\/analytics.readonly\"\ngcloud auth application-default set-quota-project \"$PROJECT_ID\"\n\ncat > question.json <<'JSON'\n{\n \"userQuery\": \"For 2026-09-01 through 2026-09-07, report sessions by sessionDefaultChannelGroup. Use these exact dates and API field names. State any limitation and do not infer causes.\",\n \"returnPropertyQuota\": true\n}\nJSON\ncurl --fail-with-body --silent --show-error \\\n \"https:\/\/analyticsdata.googleapis.com\/v1alpha\/properties\/${PROPERTY_ID}:chat\" \\\n -H \"Authorization: Bearer $(gcloud auth application-default print-access-token)\" \\\n -H \"x-goog-user-project: ${PROJECT_ID}\" \\\n -H \"Content-Type: application\/json\" \\\n --data-binary @question.json -o answer.json\njq '{sessionId, blocks, propertyQuota}' answer.json<\/code><\/pre>\n3. Kolejne pytanie w zwr\u00f3conej sesji<\/h2>\n
SESSION_ID=$(jq -er '.sessionId | strings | select(length > 0)' answer.json)\njq -n --arg sid \"$SESSION_ID\" '{\n sessionId: $sid,\n userQuery: \"Compare those sessions by sessionDefaultChannelGroup with 2026-08-25 through 2026-08-31. Show both totals and absolute differences. Separate observations from hypotheses.\",\n returnPropertyQuota: true\n}' > followup.json\ncurl --fail-with-body --silent --show-error \\\n \"https:\/\/analyticsdata.googleapis.com\/v1alpha\/properties\/${PROPERTY_ID}:chat\" \\\n -H \"Authorization: Bearer $(gcloud auth application-default print-access-token)\" \\\n -H \"x-goog-user-project: ${PROJECT_ID}\" \\\n -H \"Content-Type: application\/json\" \\\n --data-binary @followup.json -o followup-answer.json\njq '{sessionId, blocks, propertyQuota}' followup-answer.json<\/code><\/pre>\n4. Odtworzenie liczby przez runReport<\/h2>\n
cat > report-request.json <<'JSON'\n{\n \"dateRanges\": [\n {\"startDate\":\"2026-09-01\",\"endDate\":\"2026-09-07\",\"name\":\"current\"},\n {\"startDate\":\"2026-08-25\",\"endDate\":\"2026-08-31\",\"name\":\"previous\"}\n ],\n \"dimensions\": [{\"name\":\"sessionDefaultChannelGroup\"}],\n \"metrics\": [{\"name\":\"sessions\"}],\n \"limit\": \"1000\",\n \"returnPropertyQuota\": true\n}\nJSON\ncurl --fail-with-body --silent --show-error \\\n \"https:\/\/analyticsdata.googleapis.com\/v1beta\/properties\/${PROPERTY_ID}:runReport\" \\\n -H \"Authorization: Bearer $(gcloud auth application-default print-access-token)\" \\\n -H \"x-goog-user-project: ${PROJECT_ID}\" \\\n -H \"Content-Type: application\/json\" \\\n --data-binary @report-request.json -o report-response.json\njq '{dimensionHeaders,metricHeaders,rows,rowCount,metadata,propertyQuota}' report-response.json<\/code><\/pre>\n5. Kontrola ogranicze\u0144 przed wykorzystaniem wyniku<\/h2>\n
report-response.json<\/code> do kontroli metadanych i limit\u00f3w. Nie obs\u0142uguje odpowiedzi chat. Wynik asystenta jest por\u00f3wnywany z raportem oddzielnie. Informacje o progach, pr\u00f3bkowaniu lub niepe\u0142nej paginacji musz\u0105 pozosta\u0107 widoczne w analizie.<\/p>\nreturnPropertyQuota<\/code> prosi o stan limit\u00f3w chat, ale nie rezerwuje pojemno\u015bci. Brak obiektu limit\u00f3w oznacza niewiadom\u0105, a nie brak ogranicze\u0144. B\u0142\u0119dy logowania, uprawnie\u0144 i limit\u00f3w wymagaj\u0105 zanotowania przed ponowieniem. Automatyczne powtarzanie pyta\u0144 mo\u017ce zu\u017cywa\u0107 dodatkowy limit i przynosi\u0107 inne odpowiedzi. [1]<\/a><\/p>\n6. Zapis wyniku mo\u017cliwego do sprawdzenia<\/h2>\n
\u0179r\u00f3d\u0142a<\/h2>\n
\n