Active Users Report

    The Active Users Report allows you to view key marketing performance indicators such as DAU (Daily Active Users), WAU (Weekly Active Users), and MAU (Monthly Active Users), based on the selected period.


    Request Report

    POST

    https://api.airbridge.io/reports/api/v4/apps/{app_name}/active-users/query

    Request an Active Users Report.

    Request

    Path Params

    app_name
    Requiredstring

    Airbridge App Name. (Unique ID)

    Body Params

    from
    Requiredstring

    The start date of the report data to request.

    • The date must be in the format 'YYYY-MM-DD'

    • This date must correspond with the timezone set in the Airbridge app. 

    • The system only accepts dates within the 174 days preceding the current date. Future dates are not permitted.

    to
    Requiredstring

    The end date of the report data to request.

    • The date must be in the format 'YYYY-MM-DD'

    • This date must correspond with the timezone set in the Airbridge app.

    • The system only accepts dates up the current date. The time period available for querying is up to 90 days.

    granularity
    Requiredenum

    The analytics interval period.

    ENUM VALUES
    day

    Analyze the data by day.

    week

    Analyze the data by week. Calculated in 7 day intervals from the start date.

    month

    Analyze the data by month. Calculated the same month from the start date until the corresponding date in the subsequent month. For example, given a start date of March 10, the same month would be pretended until April 10.

    metrics
    Requiredenum[]

    Report "Metrics".

    ENUM VALUES
    app_au

    Active Users (App). Users that generated an event via SDK at least once during the designated period.

    app_pu

    Paying Users (App). Users that have a purchase history during the designated period.

    app_revenue

    Revenue (App). Revenue generated by the users who performed in-app purchase. (In local currency)

    app_arpu

    ARPU (App). ARPU is calculated by dividing total revenue by the number of Active users. (In local currency)

    app_arppu

    ARPPU (App). ARPPU is calculated by dividing total revenue by the number of paying users. (In local currency)

    web_au

    Active Users (Web). The number of unique users who performed any web event

    web_pu

    Paying Users (Web). The number of unique users who performed the Order Complete events in Web

    web_revenue

    Revenue (Web). Sum of value generated from order complete events in Web

    web_arpu

    ARPU (Web). Average revenue per user in Web

    web_arppu

    ARPPU (Web). Average revenue per paying user in Web

    groupBy
    object

    Allows you to set a group by to divide the numbers for the metric you want to see.

    groupBy.fields
    string[]

    Report "Group By".

    'Group By' is necessary when seeking a more detailed view in reports. This specification will allow reports to be grouped according to desired criteria. The 'Report GroupBys' for a comprehensive list of available options.

    The maximum threshold is 4.

    filters
    object[]

    The groupBys to filter by.

    Only values defined within groupBys can be used.

    filters[0].field
    Requiredstring

    The groupBys to filter by.

    Only values defined within groupBys can be used.

    filters[0].filterType
    Requiredenum

    The operator to apply to the filter.

    ENUM VALUES
    IN

    In. In Active Users Reports, this corresponds to equals (is, =).

    NOT IN

    Not in. In Active Users Reports, this corresponds to is not, ≠.

    LIKE

    Contains. ∋

    filters[0].values
    Requiredstring[]

    The value to apply to the filter.

    Response

    200 SUCCESS

    404 ERROR


    Get Report

    GET

    https://api.airbridge.io/reports/api/v4/apps/{app_name}/active-users/query/{task_id}

    Request status

    The status of an asynchronous request can be checked with task.status in the API request result.

    #{"style":{"minWidth":"130px"}}

    PENDING

    Data aggregation is in preparation.

    RUNNING

    Data is being aggregated.

    SUCCESS

    The aggregation is completed and returns the result.

    FAILURE

    The request has failed.

    CANCELED

    The request has been canceled.

    Request

    Path Params

    app_name
    Requiredstring

    Airbridge App Name. (Unique ID)

    task_id
    Requiredstring

    The task_id returned by the result of the 'Request Report' API.

    Response

    200 (Processing the request)SUCCESS

    200 (Completed the request processing)SUCCESS

    404 ERROR

    Was this page helpful?

    Have any questions or suggestions?