Skip to content

Update from code changes: document search funnel actions - #6860

Open
mintlify[bot] wants to merge 10 commits into
mainfrom
mintlify/search-funnel-acted-docs
Open

Update from code changes: document search funnel actions#6860
mintlify[bot] wants to merge 10 commits into
mainfrom
mintlify/search-funnel-acted-docs

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Document the search and assistant conversation funnels in the analytics guides, including the dashboard selector for switching between them and the interactions overview card in User engagements.

Changes

  • Explain all five search funnel stages and how to interpret drop-off.
  • Describe the actions included in the search funnel's final stage and how the time range applies.
  • Document the four assistant conversation funnel stages: started, answered, follow-up, and engaged.
  • Explain spam exclusion, post-answer engagement, selected time ranges, and session-based counting.
  • Explain how to use the User funnel selector in the Impressions section, including its default Search-to-answer view and Assistant conversation option.
  • Document the Interactions overview card with total interactions, average interactions per session, and CTA click rate.
  • Document that the User engagements Overview card appears at the top of the section, includes a period-over-period delta badge for each metric, and updates values and deltas when the analytics date range changes.
  • Add matching guidance to the French, Spanish, and Chinese translations.

Context

This documents the search funnel update shipped in the server change, the assistant conversation funnel endpoint, its dashboard selector, and the interactions overview endpoint. It also documents the User engagements Overview card, its three metrics, period-over-period delta badges, and date-range updates.

Update history

  • Initial update: documented the five-stage search funnel and post-landing actions in English, French, Spanish, and Chinese.
  • 2026-08-04: documented the four-stage assistant conversation funnel and its engagement rules in all four analytics guides. Source: https://github.com/mintlify/server/pull/7225
  • 2026-08-04: documented the Impressions User funnel selector and its Search-to-answer and Assistant conversation views in all four analytics guides. Source: https://github.com/mintlify/mint/pull/9819
  • 2026-08-05: documented the Interactions overview metrics in all four analytics guides. Source: https://github.com/mintlify/server/pull/7228
  • 2026-08-05: documented the User engagements Overview card placement, three metrics, period-over-period delta badges, and date-range updates in all four analytics guides. Source: https://github.com/mintlify/mint/pull/9824

Note

Low Risk
Documentation-only MDX changes with no application or API code.

Overview
Updates the analytics guides in English, French, Spanish, and Chinese to describe new dashboard funnel metrics and refreshes page title/description metadata (including funnel-related wording).

Assistant conversation funnel: New subsection under Assistant explains the Impressions User funnel selector (Search-to-answer vs Assistant conversation), the four stages (Started → Answered → Follow-up → Engaged), and rules for session counting, spam exclusion, and post-answer engagement.

Search funnel: New subsection under Search documents five stages from opening search through post-landing actions (CTA, contextual menu, code copy, API playground, page feedback), plus how to read drop-off and time-range behavior.

Locales mirror the same structure; ES/FR/ZH add anchor divs for funnel sections where the English page uses plain headings.

Reviewed by Cursor Bugbot for commit f4423fd. Bugbot is set up for automated code reviews on this repo. Configure here.


Note

Low Risk
Documentation-only MDX edits with no application, API, or runtime behavior changes.

Overview
Expands the analytics guides (English, French, Spanish, Chinese) to match new dashboard metrics and refreshes page title/description metadata.

Assistant: New assistant conversation funnel content covers the Impressions User funnel toggle (Search-to-answer vs Assistant conversation), four stages (Started → Answered → Follow-up → Engaged), and how to read drop-off with spam exclusion and post-answer engagement rules.

Search: New search funnel section documents five session stages through post-landing actions (CTA, contextual menu, code copy, API playground, page feedback) and time-range counting.

Impressions: New Interactions overview card explains total interactions, average interactions per session, and CTA click rate (capped at 100%).

Localized pages mirror the same structure; ES/FR/ZH use anchor divs for funnel subsections where English uses plain headings.

Reviewed by Cursor Bugbot for commit 6a48a97. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 4, 2026, 7:49 PM

@mintlify

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Aug 4, 2026, 7:49 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Updated localized analytics SEO metadata and corrected French heading punctuation

Source PRs

@mintlify

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Updated Chinese analytics description to meet minimum SEO length requirements

Source PRs

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Updated Chinese analytics SEO description metadata

Source PRs

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Added no new documentation content

Source PRs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant