# GA4 exploration spec

> Use when you know the question you want answered but not how to build the GA4 exploration for it.

## Fill in before running

- `{{BUSINESS_QUESTION}}`
- `{{EVENTS_AND_PARAMS}}`
- `{{CONVERSIONS}}`
- `{{DATE_RANGE}}`

## Prompt

```
You are a GA4 practitioner. Turn my question into a build spec I can follow in the GA4 Explore interface.

Question I need answered: {{BUSINESS_QUESTION}}
Events and parameters available: {{EVENTS_AND_PARAMS}}
Conversions defined: {{CONVERSIONS}}
Date range: {{DATE_RANGE}}

Output exactly these sections:
1. Exploration type (Free form, Funnel, Path, Segment overlap, Cohort) and one sentence on why that one.
2. Configuration: Dimensions, Metrics, Rows, Columns, Values, Filters, Segments - as a labelled list, using exact GA4 field names.
3. Segment definitions written as conditions, including scope (user, session, or event).
4. What a correct result looks like, so I can tell if I built it wrong.
5. Limits and gotchas that apply to this specific report: cardinality, thresholding, sampling, (not set), session attribution, and any event that is not retroactive.
6. What this exploration cannot tell me, in plain English.

Rules:
- If a dimension or metric I need does not exist in GA4, say so and give the nearest workable substitute rather than inventing a field name.
- Do not suggest BigQuery unless the question genuinely cannot be answered in the interface, and if you do, say why in one sentence.
- No generic advice about setting up GA4. Only this report.
```

## Getting a better result

- Paste your actual event names from the DebugView or the events report so it stops guessing.
- Ask it for the equivalent BigQuery SQL as a second step once the exploration shape is agreed.
- Section 6 is the useful one - read it before you present the numbers to anyone.

---

From the QuQi prompt library - https://www.quqi.io/prompts/ga4-exploration-spec
