Funnel Widget

이 페이지는 아직 한국어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우 언제든지 연락주시기 바랍니다.

Funnel analysis helps you track conversion rates across key workflows to identify and address any bottlenecks in end-to-end user journeys. The funnel widget visualizes conversion rates across user workflows and end-to-end user journeys.

Funnel widget visualizing drop-off rates of a user on an e-commerce site

Setup

Funnel widget setup screen

Configuration

  1. Choose the data to graph:
  2. Select View or Action and choose a query from the dropdown menu.
  3. Click the + button and select another query from the dropdown menu to visualize the funnel. See the RUM Visualize documentation for more information on visualizing Funnel analysis.

Options

Global time

On screenboards and notebooks, choose whether your widget has a custom timeframe or uses the global timeframe.

API

This widget can be used with the Dashboards API. See the following table for the widget JSON schema definition:

Expand All

항목

유형

설명

description

string

The description of the widget.

grouped_display

enum

Display mode for grouped funnel results. Allowed enum values: stacked,side_by_side

requests [required]

[object]

Request payload used to query items.

comparison_segments

[string]

Comparison segments.

comparison_time

object

Comparison time configuration for funnel widgets.

custom_timeframe

object

Custom timeframe for funnel comparison.

from [required]

double

Start of the custom timeframe.

to [required]

double

End of the custom timeframe.

type [required]

enum

Type of comparison duration. Allowed enum values: previous_timeframe,custom_timeframe,previous_day,previous_week,previous_month

query [required]

object

User journey funnel query definition.

compute

object

Compute configuration for user journey funnel.

aggregation [required]

enum

Aggregation type for user journey funnel compute. Allowed enum values: cardinality,count

metric [required]

enum

Metric for user journey funnel compute. __dd.conversion and __dd.conversion_rate accept count (unique users/sessions) and cardinality (total users/sessions) as aggregations. Allowed enum values: __dd.conversion,__dd.conversion_rate

data_source [required]

enum

Data source for user journey funnel queries. Allowed enum values: product_analytics_journey

group_by

[object]

Group by configuration.

facet [required]

string

Facet to group by.

limit

int64

Maximum number of groups.

should_exclude_missing

boolean

Whether to exclude missing values.

sort

object

Sort configuration for user journey funnel group by.

aggregation [required]

string

Aggregation type.

metric

string

Metric to sort by.

order

enum

Widget sorting methods. Allowed enum values: asc,desc

target

object

Target for user journey search.

end

string

End value.

start

string

Start value.

type [required]

string

Target type.

value

string

Target value.

search [required]

object

User journey search configuration.

expression [required]

string

Expression string.

filters

object

Filters for user journey search.

audience_filters

object

Product Analytics/RUM audience filters.

accounts

[object]

name

string

The name of the account subquery.

query

string

The query string for the account subquery.

filter_condition

string

An optional filter condition applied to the audience subquery.

segments

[object]

name

string

The name of the segment subquery.

segment_id

string

The unique identifier of the segment.

users

[object]

name

string

The name of the user subquery.

query

string

The query string for the user subquery.

graph_filters

[object]

Graph filters.

name

string

Filter name.

operator

string

Filter operator.

target

object

Target for user journey search.

end

string

End value.

start

string

Start value.

type [required]

string

Target type.

value

string

Target value.

value

int64

Filter value.

string_filter

string

String filter.

join_keys

object

Join keys for user journey queries.

primary [required]

string

Primary join key.

secondary

[string]

Secondary join keys.

node_objects [required]

object

Node objects mapping.

<any-key>

object

Base query for Product Analytics.

data_source [required]

enum

Data source for Product Analytics event queries. Allowed enum values: product_analytics

search [required]

object

Search configuration for Product Analytics event query.

query [required]

string

RUM event search query used to filter views or actions.

step_aliases

object

Step aliases mapping.

<any-key>

string

subquery_id

string

Subquery ID.

request_type [required]

enum

Request type for user journey funnel widget. Allowed enum values: user_journey_funnel

time

 <oneOf>

Time setting for the widget.

Option 1

object

Wrapper for live span

hide_incomplete_cost_data

boolean

Whether to hide incomplete cost data in the widget.

live_span

enum

The available timeframes depend on the widget you are using. Allowed enum values: 1m,5m,10m,15m,30m,1h,4h,1d,2d,1w

Show 7 more,1mo,3mo,6mo,week_to_date,month_to_date,1y,alert

Option 2

object

Used for arbitrary live span times, such as 17 minutes or 6 hours.

hide_incomplete_cost_data

boolean

Whether to hide incomplete cost data in the widget.

type [required]

enum

Type "live" denotes a live span in the new format. Allowed enum values: live

unit [required]

enum

Unit of the time span. Allowed enum values: minute,hour,day,week,month,year

value [required]

int64

Value of the time span.

Option 3

object

Used for fixed span times, such as 'March 1 to March 7'.

from [required]

int64

Start time in milliseconds since epoch.

hide_incomplete_cost_data

boolean

Whether to hide incomplete cost data in the widget.

to [required]

int64

End time in milliseconds since epoch.

type [required]

enum

Type "fixed" denotes a fixed span. Allowed enum values: fixed

title

string

The title of the widget.

title_align

enum

How to align the text on the widget. Allowed enum values: center,left,right

title_size

string

The size of the title.

type [required]

enum

Type of funnel widget. Allowed enum values: funnel

default: funnel

{
  "description": "string",
  "grouped_display": "stacked",
  "requests": [
    {
      "comparison_segments": [],
      "comparison_time": {
        "custom_timeframe": {
          "from": 0,
          "to": 0
        },
        "type": "previous_timeframe"
      },
      "query": {
        "compute": {
          "aggregation": "count",
          "metric": "__dd.conversion_rate"
        },
        "data_source": "product_analytics_journey",
        "group_by": [
          {
            "facet": "@usr.email",
            "limit": "integer",
            "should_exclude_missing": false,
            "sort": {
              "aggregation": "count",
              "metric": "@session.id",
              "order": "desc"
            },
            "target": {
              "end": "node_1",
              "start": "node_0",
              "type": "step",
              "value": "node_0"
            }
          }
        ],
        "search": {
          "expression": "node_0 -> node_1",
          "filters": {
            "audience_filters": {
              "accounts": [
                {
                  "name": "string",
                  "query": "string"
                }
              ],
              "filter_condition": "string",
              "segments": [
                {
                  "name": "string",
                  "segment_id": "string"
                }
              ],
              "users": [
                {
                  "name": "string",
                  "query": "string"
                }
              ]
            },
            "graph_filters": [
              {
                "name": "count",
                "operator": "gt",
                "target": {
                  "end": "node_1",
                  "start": "node_0",
                  "type": "step",
                  "value": "node_0"
                },
                "value": 1
              }
            ],
            "string_filter": "@session.type:user"
          },
          "join_keys": {
            "primary": "@session.id",
            "secondary": []
          },
          "node_objects": {
            "<any-key>": {
              "data_source": "product_analytics",
              "search": {
                "query": "@type:view @view.name:/home"
              }
            }
          },
          "step_aliases": {
            "<any-key>": "string"
          }
        },
        "subquery_id": "string"
      },
      "request_type": "user_journey_funnel"
    }
  ],
  "time": {
    "hide_incomplete_cost_data": false,
    "live_span": "5m"
  },
  "title": "string",
  "title_align": "string",
  "title_size": "string",
  "type": "funnel"
}

Further Reading