POST /api/v1/client-api/metrics/funnel/

Retrieve funnel data

Copy as Markdown

Retrieves funnel data to track user progression through specific stages of a conversion process.

Rate limit: 2 requests per second.

Request body

filtersobjectrequired
datearray of stringrequired

Enter the date or time period for which you want to retrieve chart data

compare_datearray of string

Enter the comparison date or time period

storearray of string

Filter by the app store where the purchase was made

countryarray of string

Filter by the 2-letter country code where the purchase took place

store_product_idarray of string

Unique identifier of a product from the app store

durationarray of string

Specify the subscription duration

attribution_sourcearray of string

The source integration for attribution

attribution_statusarray of string

Indicates if the attribution is organic or non-organic

attribution_channelarray of string

Marketing channel that led to the transaction

attribution_campaignarray of string

Marketing campaign that brought the transaction

attribution_adgrouparray of string

Attribution ad group that brought the transaction

attribution_adsetarray of string

Attribution ad set that led to the transaction

attribution_creativearray of string

Specific visual or text elements in an ad or campaign tracked to measure effectiveness

offer_categoryarray of string

Specify the offer categories you want to retrieve data for

offer_typearray of string

Specify the offer types you want to retrieve data for

offer_idarray of string

Specify the specific offers you want to retrieve data for

period_unitstring

Specify the time interval for aggregating analytics data

One of: "day", "week", "month", "quarter", "year"

show_value_asstring

Specify how values are displayed

One of: "absolute", "relative", "both"

segmentationstring

Sets the basis for segmentation

formatstring

Specify the export file format

One of: "json", "csv"

Responses

Funnel data retrieved successfully

Schema

Response containing funnel analysis data showing user progression through conversion stages

dataarray of object

Array of funnel segments showing different stages of the conversion process

titlestring

Display title for this funnel segment

typestring

Type of funnel segment ('total' for aggregated data)

valuesarray of object

Array of funnel values showing progression through stages

periodinteger

Period number in the funnel (-2 = Install, -1 = Paywall displayed, etc.)

titlestring

Display title for this funnel stage

valueinteger

Number of users who reached this stage

value_relativenumber

Percentage of users who reached this stage relative to the first stage

relative_changesnumber

Change in conversion rate compared to previous period

following_changesobject

Information about users who dropped off after this stage

titlestring

Title for the drop-off stage

valueinteger

Number of users who dropped off

value_relativenumber

Percentage of users who dropped off

churn_reason_titlestring

Title describing the reason for churn at this stage

churn_reasonsarray of object

Array of specific churn reasons

valuesarray of object

Additional nested values for this funnel stage

Example 
{
  "data": [
    {
      "title": "Total",
      "type": "total",
      "values": [
        {
          "period": -2,
          "title": "Install",
          "value": 2,
          "value_relative": 100,
          "relative_changes": 0,
          "following_changes": {
            "title": "Drop off",
            "value": 2,
            "value_relative": 100
          },
          "churn_reason_title": "",
          "churn_reasons": [],
          "values": []
        },
        {
          "period": -1,
          "title": "Paywall displayed",
          "value": 0,
          "value_relative": 0,
          "relative_changes": 0,
          "following_changes": {
            "title": "Drop off",
            "value": 0,
            "value_relative": 0
          },
          "churn_reason_title": "",
          "churn_reasons": [],
          "values": []
        }
      ]
    }
  ]
}

Bad Request

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

Unauthorized

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

Rate limit exceeded. Maximum 2 requests per second per API key.