Active Users Report

    액티브 유저 리포트(Active Users Report)에서는 선택한 주기에 따라 주요 마케팅 성과 지표인 DAU, WAU, MAU를 확인할 수 있는 통계 리포트입니다.


    리포트 생성하기

    POST

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

    Active Users Report 데이터를 요청합니다.

    Request

    Path Params

    app_name
    필수string

    에어브릿지 앱 이름(App Name)

    Body Params

    from
    필수string

    요청할 리포트 데이터의 시작일.

    • YYYY-MM-DD 형태입니다.

    • 에어브릿지 앱의 타임존이 적용된 날짜이어야 합니다.

    • 현재로부터 174일 전까지 설정할 수 있습니다.

    to
    필수string

    요청할 리포트 데이터의 종료일.

    • YYYY-MM-DD 형태입니다.

    • 에어브릿지 앱의 타임존이 적용된 날짜이어야 합니다.

    • 현재 날짜까지 설정할 수 있으며 최대 조회 기간은 90일입니다.

    granularity
    필수enum

    분석할 기간의 주기.

    ENUM VALUES
    day

    일별로 데이터를 분석합니다.

    week

    주별로 데이터를 분석합니다. 시작일로부터 7일 단위로 계산됩니다.

    month

    월별로 데이터를 분석합니다. 시작일로부터 다음달 같은 일자까지를 같은 달로 계산합니다. 예를 들어 3월 10일이 시작일이면 4월 10일까지를 같은 달로 봅니다.

    metrics
    필수enum[]

    리포트 메트릭.

    ENUM VALUES
    app_au

    Active Users (App). 지정한 기간동안 SDK를 통해 1회 이상 이벤트를 발생시킨 유저.

    app_pu

    Paying Users (App). 지정한 기간동안 결제 이력이 있는 유저.

    app_revenue

    Revenue (App). 앱에서 발생한 결제와 앱 내 광고 노출으로 발생한 매출액 (현지 통화기준).

    app_arpu

    ARPU (App). 유저당 평균 매출액 (현지 통화기준).

    app_arppu

    ARPPU (App). 결제 저당 평균 매출액 (현지 통화기준).

    web_au

    Active Users (Web). 1회 이상 웹 이벤트를 발생시킨 고유 유저수.

    web_pu

    Paying Users (Web). 웹 내 구매 완료 이벤트를 실행한 고유 유저수.

    web_revenue

    Revenue (Web). 웹 내 구매 완료 이벤트로 발생한 매출 합계.

    web_arpu

    ARPU (Web). 웹 내 유저(Active User)당 평균 매출액.

    web_arppu

    ARPPU (Web). 웹 내 결제 유저(Paying User)당 평균 매출액.

    groupBy
    object

    그룹바이는 조회할 메트릭의 수치를 나누는 기준입니다.

    groupBy.fields
    string[]

    리포트 그룹바이.

    세분화하여 보고자 하는 항목을 ‘그룹바이'으로 설정하여 리포트를 조회할 수 있습니다. 선택할 수 있는 리스트는 그룹바이 목록에서 확인할 수 있습니다.

    최대 4개까지 설정할 수 있습니다.

    filters
    object[]

    '그룹바이'로 제공하는 항목들에 대한 필터.

    조건을 만족하는 데이터에 대한 통계 데이터를 리포트에서 조회할 수 있습니다.

    filters[0].filterType
    필수enum

    필터에 적용할 연산자.

    ENUM VALUES
    IN

    속해있다. 액츄얼스 리포트에서는 같다(is, =)에 대응합니다.

    NOT IN

    속해있지 않다. 액츄얼스 리포트에서는 같지 않다(is not, ≠)에 대응합니다.

    LIKE

    포함한다. (contains, ∋)

    filters[0].field
    필수string

    필터를 지정할 그룹바이.

    groupBys 내에 정의된 값만 사용할 수 있습니다.

    filters[0].values
    필수string[]

    필터에 적용할 값.

    Response

    200 SUCCESS

    404 ERROR


    리포트 가져오기

    GET

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

    비동기 요청 상태

    비동기 요청 상태는 API 요청 결과의 task.status로 확인할 수 있습니다.

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

    PENDING

    데이터 집계를 위한 준비를 하고 있습니다

    RUNNING

    데이터를 집계중입니다

    SUCCESS

    집계가 완료되어 결과값을 반환합니다

    FAILURE

    알 수 없는 이유로 요청이 실패하였습니다

    CANCELED

    요청이 취소되었습니다

    Request

    Path Params

    app_name
    필수string

    에어브릿지 앱 이름(App Name)

    task_id
    필수string

    '리포트 생성하기' API에서 생성한 task_id.

    Response

    200 (리포트 생성중)SUCCESS

    200 (리포트 생성 완료)SUCCESS

    404 ERROR

    이 페이지가 도움이 되었나요?

    추가, 수정하면 좋을 내용이 있나요?