[DOCS-15263] Add Journey Paths Analysis chart docs (#39342)

* [DOCS-15263] Add Journey Paths Analysis chart docs

Add a new Charts page documenting Journey Paths Analysis as a
standalone chart type, update the Charts overview to list it, and
remove the now-redundant journey paths description from the Funnel
Analysis page in favor of a further reading link.

* [DOCS-15263] Restructure Journey Paths Analysis docs and add sidebar entry

Simplify the Journey Paths Analysis page into numbered steps, add a
customization callout screenshot, and add the missing sidebar nav entry.
Remove unused screenshots left over from earlier drafts.

* [DOCS-15263] Remove further reading section from Journey Paths page

The cross-links to Funnel Analysis and Pathways were carried over from
initial drafting but aren't relevant further reading for this page.

* [DOCS-15263] Add description to Journey Paths frontmatter

* [DOCS-15263] Align chart names and order with product UI

Rename sidebar nav entries and page titles for Funnel, Journey Paths,
Pathways, Retention, and Analytics to match the exact names and order
used in the product's Create New chart menu.

* [DOCS-15263] Incorporate ye-sharon's feedback

* Update Journey Paths customization screenshot

* Update Journey Paths customization screenshot

* Update hugo/content/en/product_analytics/charts/journey_paths.md

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

* Update hugo/content/en/product_analytics/charts/journey_paths.md

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

---------

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

Author: melamos

hugo/config/_default/menus/main.en.yaml

@@ -10047,26 +10047,31 @@ menu:
       parent: pa_charts
       identifier: pa_chart_basics
       weight: 101
-    - name: Pathways Diagram
-      url: product_analytics/charts/pathways
-      parent: pa_charts
-      identifier: pa_pathways
-      weight: 102
-    - name: Funnel Analysis
+    - name: Funnel
       url: product_analytics/charts/funnel_analysis
       parent: pa_charts
       identifier: pa_funnel_analysis
+      weight: 102
+    - name: Journey Paths
+      url: product_analytics/charts/journey_paths
+      parent: pa_charts
+      identifier: pa_journey_paths
       weight: 103
-    - name: Retention Analysis
+    - name: Pathways
+      url: product_analytics/charts/pathways
+      parent: pa_charts
+      identifier: pa_pathways
+      weight: 104
+    - name: Retention
       url: product_analytics/charts/retention_analysis
       parent: pa_charts
       identifier: pa_user_retention
-      weight: 104
-    - name: Analytics Explorer
+      weight: 105
+    - name: Analytics
       url: product_analytics/charts/analytics_explorer
       parent: pa_charts
       identifier: pa_analytics_explorer
-      weight: 105
+      weight: 106
     - name: Dashboards
       url: product_analytics/dashboards
       parent: product_analytics

hugo/content/en/product_analytics/charts/_index.md

@@ -1,6 +1,6 @@
 ---
 title: Charts
-description: The various Charts help you understand the path your users follow as they discover your product, service, or brand.
+description: Product Analytics charts help you understand the path your users follow as they discover your product, service, or brand.
 further_reading:
 - link: "/product_analytics/"
   tag: "Documentation"
@@ -9,36 +9,41 @@ further_reading:
 
 ## Overview
 
-Use the various charts to visualize your users' journeys from end-to-end to discover the different ways users navigate your application. You can extract the data to identify frictions in the user journey, measure the success of UI changes and inform your application design decisions. 
+Use the product analytics charts to visualize users' journeys from end-to-end to discover the different ways users navigate your application. You can extract the data to identify frictions in the user journey, measure the success of UI changes and inform your application design decisions. 
 
 ## Deciding which chart to use
 
 
-### Pathways diagram
+### Funnel
 
-{{< img src="/product_analytics/overview_pathways_ga.png" alt="Use Pathways to visualize all user journeys across your application to analyze the critical path">}}
+{{< img src="/product_analytics/overview_funnel_ga.png" alt="Understand end-to-end conversions with Funnel Analysis.">}}
 
-The [Pathways diagram][3] allows you to visualize all user journeys across your application to identify the most important contributions to a flow.
+[Funnel][2] charts help you understand the end-to-end conversion of a single essential workflow. You can view details in the side panel to understand why conversation rates are what they are.
+For example, you can determine if there was there a performance issue that caused user drop-off. Are customers experiencing an error that occurred in a recent release? Watch a Session Replay of a user who converted or dropped off to see exactly what happened.
 
+### Journey Paths
 
-### Funnel analysis
+{{< img src="product_analytics/journeys/journey_paths/pana_journey_paths_conversion_chart.png" alt="A rendered Journey Paths chart showing the top paths users take between two views" >}}
 
-{{< img src="/product_analytics/overview_funnel_ga.png" alt="Understand end-to-end conversions with Funnel Analysis.">}}
+[Journey Paths][5] diagrams let you see the most common paths users take between selected events, including view and action events, for both converted and dropped users.
 
-With [funnel analysis][2], you can understand the end-to-end conversion of a single essential workflow. You can view details in the side panel to understand why conversation rates are what they are.
-For example, you can determine if there was there a performance issue that caused user drop-off. Are customers experiencing an error that occurred in a recent release? Watch a Session Replay of a user who converted or dropped off to see exactly what happened.
+### Pathways
+
+{{< img src="/product_analytics/overview_pathways_ga.png" alt="Use Pathways to visualize all user journeys across your application to analyze the critical path">}}
+
+[Pathways][3] diagrams allow you to visualize all user journeys across your application to identify the most important contributions to a flow.
 
-### Retention Analysis
+### Retention
 
 {{< img src="/product_analytics/overview_retention_ga.png" alt="Understand end-to-end conversions with Funnel Analysis.">}}
 
-With [retention analysis][4] you can measure how often users are successfully returning to a page or to an action. This measure offers insight into overall user satisfaction with your application. 
+[Retention][4] charts visualize how often users successfully return to a page or to an action. This measure offers insight into overall user satisfaction with your application. 
 
-### Analytic Explorer
+### Analytics
 
 {{< img src="/product_analytics/overview_analytic_ga.png" alt="Understand end-to-end conversions with Funnel Analysis.">}}
 
-The [Analytics Explorer][1] contains views data aggregation to help you understand how your product is being used. You can create a widget in a dashboard out of that visualization and dive deeper into subsets of the events list depending on the interactions that the visualization enables. 
+[Analytics][1] let you explore how your product is being used. You can analyze sessions, events, and user profiles, then break down, compare, and visualize the data in a variety of chart types.
 
 
 ## Further reading
@@ -48,5 +53,6 @@ The [Analytics Explorer][1] contains views data aggregation to help you understa
 [2]: /product_analytics/charts/funnel_analysis
 [3]: /product_analytics/charts/pathways
 [4]: /product_analytics/charts/retention_analysis
+[5]: /product_analytics/charts/journey_paths
 
 

hugo/content/en/product_analytics/charts/analytics_explorer/_index.md

@@ -1,5 +1,5 @@
 ---
-title: Analytics Explorer
+title: Analytics
 description: ""
 aliases:
 - /product_analytics/analytics_explorer/

hugo/content/en/product_analytics/charts/funnel_analysis.md

@@ -1,5 +1,5 @@
 ---
-title: Funnel Analysis
+title: Funnel
 disable_toc: false
 aliases:
 - /real_user_monitoring/funnel_analysis
@@ -9,6 +9,9 @@ further_reading:
 - link: "/product_analytics/analytics_explorer/"
   tag: "Documentation"
   text: "Analytics Explorer"
+- link: "/product_analytics/charts/journey_paths/"
+  tag: "Documentation"
+  text: "Journey Paths Analysis"
 - link: https://learn.datadoghq.com/courses/getting-started-product-analytics
   tag: Learning Center
   text: Getting Started with Product Analytics
@@ -139,19 +142,15 @@ The top list visualization identifies the top values from a facet based on a cho
 
 {{< img src="product_analytics/journeys/funnel_analysis/funnel_top_list.png" alt="The top list visualization, configured to show the top four conversion sources by continent." style="width:80%;" >}}
 
-## View conversion drivers and journey paths
+## View conversion drivers
 
-To gain more context about user conversions and dropoffs, click on a funnel step to access conversion analysis and journey paths.
+To gain more context about user conversions and dropoffs, click on a funnel step to access conversion analysis.
 
 <div class="alert alert-info">Conversion analysis is in Preview.</div>
 
-- **Conversion analysis**: View conversion drivers, user journeys, available user replays for conversions and dropoffs, and user details.
-
-  {{< img src="product_analytics/journeys/funnel_analysis/funnel_analysis_side_panel.png" alt="The side panel view after clicking a funnel step, showing conversion drivers, available replays, and converted users." style="width:100%;" >}}
-
-- **Journey paths**: View conversion and dropoff user paths for the selected step sequence, including branching paths to other steps outside of the funnel.
+View conversion drivers, user journeys, available user replays for conversions and dropoffs, and user details.
 
-  {{< img src="product_analytics/journeys/funnel_analysis/funnel_journey_paths.png" alt="A journey path showing the top five dropoff paths following step 1 in the funnel." style="width:100%;" >}}
+{{< img src="product_analytics/journeys/funnel_analysis/funnel_analysis_side_panel.png" alt="The side panel view after clicking a funnel step, showing conversion drivers, available replays, and converted users." style="width:100%;" >}}
 
 ## Share a funnel
 

hugo/content/en/product_analytics/charts/journey_paths.md

@@ -0,0 +1,47 @@
+---
+title: Journey Paths
+description: See the most common paths users take between two events, including paths for sessions that dropped off before reaching the second event.
+---
+
+Journey paths show the most common paths users take between selected events.
+
+Use journey paths to:
+- See how users navigate key journeys and complete workflows.
+- Understand whether users are converting efficiently or taking unexpected detours.
+- Investigate where and why users drop off.
+
+{{< img src="product_analytics/journeys/journey_paths/pana_journey_paths_conversion_chart.png" alt="A rendered Journey Paths chart showing the top paths users take between two views." style="width:100%;" >}}
+
+## Create a journey paths chart
+
+1. In {{< ui >}}Product Analytics{{< /ui >}}, select {{< ui >}}Create New{{< /ui >}} > {{< ui >}}Journey Paths{{< /ui >}}.
+
+2. Define {{< ui >}}User steps{{< /ui >}} by selecting at least two events that you want to analyze paths between. 
+
+   For a given step, click {{< ui >}}or...{{< /ui >}} to specify multiple events, or click the filter icon to filter the step by specified properties. 
+
+3. (Optional) Filter chart results based on properties such as country or device type using {{< ui >}}Filter by{{< /ui >}} criteria.
+
+## Analyze a journey paths chart
+
+After you define steps in a journey, the chart displays the most common paths that users took between them.
+
+Each path shows the percentage and number of sessions that followed that path, and the average time spent on it. Paths with no listed events represent sessions that went directly from the start event to the end event with no intermediate views or actions in between.
+
+{{< img src="product_analytics/journeys/journey_paths/pana_journey_paths_customization.png" alt="A Journey Paths chart with numbered callouts for the converted/dropped selector, step selector, time range, event type toggles, View more, the path options menu, and the More Paths/Fewer Paths controls." style="width:100%;" >}}
+
+You can refine journey path charts in various ways to zero in on the paths you want to analyze.
+
+1. Use the {{< ui >}}Converted{{< /ui >}} / {{< ui >}}Dropped{{< /ui >}} selector to switch between paths that reached the final step and those that dropped off. Dropoff paths have no end node.
+
+2. In journeys with multiple steps, use the step selector to choose which pair of steps to analyze paths between.  
+
+3. Use the time range selector to change the period of data the chart analyzes.
+
+4. Use the {{< ui >}}Views{{< /ui >}} and {{< ui >}}Actions{{< /ui >}} toggles to control which event types appear as path nodes. Views, actions, and custom actions each display with a distinct color and icon in the diagram, so you can identify the type of event at each step of a path.
+
+5. For truncated paths, click {{< ui >}}View more{{< /ui >}} to reveal the next events in that path. Click {{< ui >}}View less{{< /ui >}} to collapse it again.
+
+6. Click an event to open a menu with options to view the session replays or the users associated with that path. Or, hold **Option** (macOS) or **Alt** (Windows/Linux) and click an event to hide it from the diagram.
+
+7. Use {{< ui >}}More Paths{{< /ui >}} and {{< ui >}}Fewer Paths{{< /ui >}} to control how many paths are displayed.

hugo/content/en/product_analytics/charts/pathways.md

@@ -1,5 +1,5 @@
 ---
-title: Pathways Diagrams
+title: Pathways
 aliases:
 - /real_user_monitoring/product_analytics/sankey
 - /product_analytics/sankey

hugo/content/en/product_analytics/charts/retention_analysis.md

@@ -1,5 +1,5 @@
 ---
-title: Retention Analysis
+title: Retention
 aliases:
 - /product_analytics/user_retention/
 - /product_analytics/charts/user_retention/