{"title":"Funnel","description":"Measure conversion through ordered event steps, inspect where users drop off, and verify a funnel insight against its SQL results.","order":700,"askSuggestions":["How do I limit how long users have to complete a funnel?","Why do fewer users than expected reach my funnel steps?","When should I use retention instead of a funnel?"],"navigation":true,"body":{"code":"var Component=(()=>{var f=Object.create;var o=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var m=Object.getPrototypeOf,y=Object.prototype.hasOwnProperty;var v=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports),w=(t,e)=>{for(var r in e)o(t,r,{get:e[r],enumerable:!0})},h=(t,e,r,s)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let i of g(e))!y.call(t,i)&&i!==r&&o(t,i,{get:()=>e[i],enumerable:!(s=p(e,i))||s.enumerable});return t};var x=(t,e,r)=>(r=t!=null?f(m(t)):{},h(e||!t||!t.__esModule?o(r,\"default\",{value:t,enumerable:!0}):r,t)),S=t=>h(o({},\"__esModule\",{value:!0}),t);var d=v((j,c)=>{c.exports=_jsx_runtime});var C={};w(C,{default:()=>u,frontmatter:()=>b});var n=x(d()),b={title:\"Funnel\",description:\"Measure conversion through ordered event steps, inspect where users drop off, and verify a funnel insight against its SQL results.\",order:700,askSuggestions:[\"How do I limit how long users have to complete a funnel?\",\"Why do fewer users than expected reach my funnel steps?\",\"When should I use retention instead of a funnel?\"]};function l(t){let e={a:\"a\",h1:\"h1\",h2:\"h2\",li:\"li\",ol:\"ol\",p:\"p\",strong:\"strong\",...t.components},{DocsPreviewDocument:r,DocsPreviewSection:s,Screenshot:i}=e;return r||a(\"DocsPreviewDocument\",!0),s||a(\"DocsPreviewSection\",!0),i||a(\"Screenshot\",!0),(0,n.jsxs)(r,{anchors:\"funnel-insights create-a-funnel verify-the-definition\",children:[(0,n.jsxs)(s,{sectionId:\"funnel-insights\",anchors:\"\",ancestors:\"\",index:\"0\",children:[(0,n.jsx)(e.h1,{id:\"funnel-insights\",children:\"Funnel insights\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Measure how users progress through ordered events, such as \",(0,n.jsx)(e.strong,{children:\"Product Viewed \\u2192 Added to Cart \\u2192 Purchase Completed\"}),\". Use a funnel to find where users drop off between steps.\"]}),`\n`,(0,n.jsxs)(e.p,{children:[\"You need \",(0,n.jsx)(e.a,{href:\"/docs/product-analytics/track\",children:\"tracked events\"}),\" for each step and a consistent \",(0,n.jsx)(e.a,{href:\"/docs/product-analytics/identify\",children:\"user identity\"}),\" across them.\"]}),`\n`]}),(0,n.jsxs)(s,{sectionId:\"create-a-funnel\",anchors:\"\",ancestors:\"\",index:\"1\",children:[(0,n.jsx)(e.h2,{id:\"create-a-funnel\",children:\"Create a funnel\"}),`\n`,(0,n.jsxs)(e.ol,{children:[`\n`,(0,n.jsxs)(e.li,{children:[\"Open \",(0,n.jsx)(e.strong,{children:\"Insights\"}),\" and create an insight.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[\"Choose \",(0,n.jsx)(e.strong,{children:\"Funnel\"}),\" as the insight type.\"]}),`\n`,(0,n.jsx)(e.li,{children:\"Add at least two event steps in the order you want to measure.\"}),`\n`,(0,n.jsxs)(e.li,{children:[\"Add event-property or user-trait filters where needed, and set the date range. Use \",(0,n.jsx)(e.strong,{children:\"Completed within\"}),\" to limit how long users have to complete the funnel.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[\"Inspect the chart, open \",(0,n.jsx)(e.strong,{children:\"Results\"}),\" for the underlying rows, and use \",(0,n.jsx)(e.strong,{children:\"SQL\"}),\" to review the generated query.\"]}),`\n`,(0,n.jsx)(e.li,{children:\"Save the insight when the steps, filters, and results match the journey you want to measure.\"}),`\n`]}),`\n`,(0,n.jsx)(i,{story:\"charts-funnelchart--single-series\",caption:\"Funnel insight showing step-by-step conversion in the chart preview\",width:\"1536\",height:\"762\"}),`\n`]}),(0,n.jsxs)(s,{sectionId:\"verify-the-definition\",anchors:\"\",ancestors:\"\",index:\"2\",children:[(0,n.jsx)(e.h2,{id:\"verify-the-definition\",children:\"Verify the definition\"}),`\n`,(0,n.jsx)(e.p,{children:\"Check that each event represents the intended action, that the same user identifier is available across steps, and that the date range and conversion window match your question. Review the number of users at each step before interpreting the conversion rate.\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"For return behavior after an initial event, use \",(0,n.jsx)(e.a,{href:\"/docs/product-analytics/retention\",children:\"Retention\"}),\". For an event metric over time, use \",(0,n.jsx)(e.a,{href:\"/docs/product-analytics/segmentation\",children:\"Segmentation\"}),\".\"]}),`\n`,(0,n.jsxs)(e.p,{children:[\"To investigate a result directly, \",(0,n.jsx)(e.a,{href:\"/docs/product-analytics/query\",children:\"query product data with SQL\"}),\" using the \",(0,n.jsx)(e.a,{href:\"/docs/product-analytics/data-model\",children:\"Product Analytics data model\"}),\".\"]})]})]})}function u(t={}){let{wrapper:e}=t.components||{};return e?(0,n.jsx)(e,{...t,children:(0,n.jsx)(l,{...t})}):l(t)}function a(t,e){throw new Error(\"Expected \"+(e?\"component\":\"object\")+\" `\"+t+\"` to be defined: you likely forgot to import, pass, or provide it.\")}return S(C);})();\n;return Component;"},"_id":"docs/product-analytics/funnel.mdx","_raw":{"sourceFilePath":"docs/product-analytics/funnel.mdx","sourceFileName":"funnel.mdx","sourceFileDir":"docs/product-analytics","contentType":"mdx","flattenedPath":"docs/product-analytics/funnel"},"type":"Docs","path":"/product-analytics/funnel","level":2,"parent":"product-analytics"}