Ein hilfreicher Analyseassistent braucht \u00fcberpr\u00fcfbare Antworten. Dieses Tutorial fragt Analytics Advisor nach Sitzungen je Kanal, erg\u00e4nzt einen Vergleichszeitraum und kontrolliert die Zahlen durch eine ausdr\u00fccklich definierte Data-API-Abfrage. Das Ergebnis ist eine kleine Untersuchung mit gespeicherten Eingaben und Ausgaben statt einer ungepr\u00fcft \u00fcbernommenen Erkl\u00e4rung.<\/p>\n
Dokumentation gepr\u00fcft: 25. September 2026.<\/strong> Der Chat-Endpunkt geh\u00f6rt zur fr\u00fchen Vorschau v1alpha. Verf\u00fcgbarkeit und Zugriff m\u00fcssen f\u00fcr die vorgesehene Property gepr\u00fcft werden. Am 27. September 2026 wurden die drei dokumentierten API-Abfragen \u00fcber die Kommandozeile gegen eine autorisierte GA4-Property ausgef\u00fchrt. Die strukturierte Tabelle f\u00fcr den 1.\u20137. September stimmte in allen vier Kanalgruppen-Zeilen exakt mit runReport \u00fcberein; Property-Werte werden hier nicht wiedergegeben. [1]<\/a><\/p>\n Das Beispiel vergleicht den 1.\u20137. September 2026 mit dem 25.\u201331. August 2026. Beide Zeitr\u00e4ume umfassen sieben Tage mit gleicher Wochentagsverteilung. Die Kennzahl hei\u00dft Ein Kanal ist eine Zuordnungsgruppe, keine Person und kein Kampagnenbudget. Die erste Frage verlangt bewusst eine Anzahl statt einer Ursache. Ein niedrigerer Wert kann eine Untersuchung begr\u00fcnden, beweist aber noch nicht, welche Marketingma\u00dfnahme ihn verursacht hat.<\/p>\n Das Beispiel l\u00e4uft in Bash mit installiertem gcloud, curl und jq. Im Cloud-Projekt muss die Analytics Data API aktiviert sein. Das angemeldete Konto ben\u00f6tigt Zugriff auf die Property und die Berechtigung zur Nutzung des Kontingentprojekts. Cloud-Projektkennung und numerische Analytics-Property-ID sind unterschiedliche Kennungen.<\/p>\n Chat ben\u00f6tigt Aktuelle Cloud-CLI-Versionen k\u00f6nnen diese Analytics-Berechtigungen f\u00fcr den eingebauten OAuth-Client blockieren. Im vorgesehenen Cloud-Projekt ist daher ein OAuth-Client vom Typ Desktop-App anzulegen, als JSON herunterzuladen und \u00fcber Eine erfolgreiche Antwort kann Text- und Tabellenbl\u00f6cke enthalten. Die vollst\u00e4ndige Speicherung erh\u00e4lt deren Zusammenhang. Eine fehlende Tabelle ist keine Tabelle voller Nullwerte. W\u00e4hrungszeichen, Prozentzeichen und formatierte Zellen sollten nicht stillschweigend in blo\u00dfe Zahlen umgewandelt werden. Antwortstruktur und Sitzungsfelder sind separat dokumentiert. [2]<\/a><\/p>\n Der n\u00e4chste Befehl liest die zur\u00fcckgegebene Sitzungskennung; fehlt sie, stoppt das Skript. Danach folgt die Frage zum fr\u00fcheren Zeitraum. F\u00fcr weitere Schritte liefert jeweils die j\u00fcngste Antwort die n\u00e4chste Sitzungskennung. Verschiedene Properties, Kunden und Berechtigungskontexte ben\u00f6tigen getrennte Sitzungsspeicher.<\/p>\n Der Sitzungskontext verbindet Fragen, ersetzt aber keine eindeutigen Zeitr\u00e4ume und Definitionen. \u201eOrganic Search ist zur\u00fcckgegangen\u201c beschreibt ein Ergebnis. \u201eDie neue Landingpage hat den R\u00fcckgang verursacht\u201c braucht zus\u00e4tzliche Belege. Die gespeicherten Fragen machen diesen Unterschied nachvollziehbar.<\/p>\n Die zweite API-Abfrage fordert beide Zeitr\u00e4ume, dieselbe Dimension und dieselbe Kennzahl direkt an. Sie erzeugt einen eigenst\u00e4ndigen Bericht. Der Assistent best\u00e4tigt damit nicht nur seine eigene Antwort. Die Berichts-API dokumentiert Zeitr\u00e4ume, Spaltenk\u00f6pfe, Zeilenzahlen und Metadaten. [3]<\/a><\/p>\n Die Reihenfolge der Spaltenk\u00f6pfe bestimmt die Interpretation der Zeilenwerte. Bei mehreren Zeitr\u00e4umen unterscheidet die zus\u00e4tzliche Zeitraumdimension die Perioden. Ein Vergleich allein nach Zeilenposition ist ungeeignet: Kan\u00e4le k\u00f6nnen anders sortiert sein oder fehlen. Je Kanal lautet die Rechnung aktuell minus vorher. Eine prozentuale \u00c4nderung ben\u00f6tigt einen vorherigen Wert ungleich null; eine fehlende Zeile ist etwas anderes als eine gemessene Null.<\/p>\n Der GA4-API-Antwortpr\u00fcfer<\/a> verarbeitet die gespeicherte Die Arbeitsunterlagen bestehen aus zwei Fragen, zwei Chat-Antworten, Berichtsanfrage und Berichtsantwort sowie dem Abrufzeitpunkt. Der Zugriff richtet sich nach der Vertraulichkeit der Property-Daten. Googles Datenschutzhinweis nennt die m\u00f6gliche Bearbeitung von Gespr\u00e4chen durch menschliche Pr\u00fcfer zur Produktverbesserung. Kundennamen und vertrauliche Kampagnenpl\u00e4ne geh\u00f6ren deshalb nicht in eine ansonsten rein zahlenbezogene Frage. [5]<\/a><\/p>\n Am Ende steht eine dokumentierte Zahl mit einer Erkl\u00e4rung m\u00f6glicher Abweichungen. Das Ergebnis kann auch \u201enicht reproduzierbar\u201c lauten. Beides ist hilfreicher als eine unbelegte Empfehlung zur \u00c4nderung des Werbebudgets.<\/p>\n Ein nachvollziehbarer Kanalvergleich mit properties.chat, Sitzungskontext, Kontingentdaten und einer unabh\u00e4ngigen runReport-Abfrage.<\/p>\n","protected":false},"author":1,"featured_media":20689,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[],"class_list":["post-20610","post","type-post","status-publish","format-standard","hentry","category-digital-analytics-de"],"yoast_head":"\n1. Eine begrenzte Berichtsfrage festlegen<\/h2>\n
sessions<\/code>, die Gruppierung sessionDefaultChannelGroup<\/code>. Diese Bezeichnungen stammen aus dem API-Schema. [4]<\/a> Feste Datumsangaben vermeiden die wechselnde Bedeutung von \u201eletzte Woche\u201c.<\/p>\n2. Zugriff einrichten und die erste Antwort speichern<\/h2>\n
analytics.chatbot.read<\/code>, die sp\u00e4tere Berichtspr\u00fcfung analytics.readonly<\/code>. Das Beispiel fordert beide an. Zugangsdaten verbleiben im lokalen gcloud-Anmeldeverfahren und geh\u00f6ren weder in Artikelcode noch in \u00f6ffentliche Webseiten. [1]<\/a>[3]<\/a><\/p>\n--client-id-file<\/code> anzugeben. Google dokumentiert diesen Parameter f\u00fcr Berechtigungen au\u00dferhalb des standardm\u00e4\u00dfigen Cloud-Umfangs. [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. In der zur\u00fcckgegebenen Sitzung nachfragen<\/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. Die Anzahl mit runReport reproduzieren<\/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. Einschr\u00e4nkungen vor der Auswertung pr\u00fcfen<\/h2>\n
report-response.json<\/code> f\u00fcr die Pr\u00fcfung von Metadaten und Kontingenten. Chat-Antworten unterst\u00fctzt er nicht. Die Assistentenausgabe wird separat mit dem Bericht verglichen. Hinweise auf Schwellen, Stichproben oder unvollst\u00e4ndige Seitennavigation m\u00fcssen in der Untersuchung sichtbar bleiben.<\/p>\nreturnPropertyQuota<\/code> fordert den Chat-Kontingentstand an und reserviert keine Kapazit\u00e4t. Fehlt das Kontingentobjekt, ist der Stand unbekannt und nicht unbegrenzt. Anmelde-, Berechtigungs- und Kontingentfehler geh\u00f6ren vor erneuten Versuchen ins Protokoll. Automatische Wiederholungen k\u00f6nnen zus\u00e4tzliche Kontingente verbrauchen und andere Antworten liefern. [1]<\/a><\/p>\n6. Ein pr\u00fcfbares Ergebnis festhalten<\/h2>\n
Quellen<\/h2>\n
\n