Retention Report

    리텐션 리포트(Retention Report)는 유저가 얼마나 자주 서비스로 돌아왔는지를 측정할 수 있는 통계 리포트입니다. 에어브릿지 사용자는 특정 이벤트를 기준으로 설치 또는 딥링크로 유입된 유저의 일자별(Day N) 서비스 사용 빈도를 조회할 수 있습니다. 집계된 리텐션 성과는 광고 캠페인 최적화 등에 활용할 수 있습니다.


    리포트 생성하기

    POST

    https://api.airbridge.io/reports/api/v5/apps/{app_name}/retention/query

    Retention Report 데이터를 요청합니다.

    Request

    Path Params

    app_name
    필수string

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

    Body Params

    from
    필수string

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

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

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

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

    to
    필수string

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

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

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

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

    granularity
    필수enum

    분석할 기간의 주기.

    ENUM VALUES
    day

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

    week

    주별로 데이터를 분석합니다. 월요일부터 일요일까지를 한 주로 보고 계산합니다.

    month

    월별로 데이터를 분석합니다. 1일부터 말일을 한달로 계산합니다. 예를 들어 3월 10일부터 4월 10일까지 조회한다면 3/10~3/31, 04/01~04/10로 계산합니다.

    startEvent
    필수enum

    유저를 유입시킨 이벤트.

    ENUM VALUES
    app_installs

    Installs (App). 선택 기간 내 Install 한 사용자 (Unique Install)

    app_deeplink_opens

    Deeplink Opens (App). 선택 기간 내 Deeplink Open 한 사용자 (Unique Deeplink Open)

    returnEvents
    필수string[]

    스타트 이벤트를 실행한 유저의 리텐션을 판단하는 기준이 되는 이벤트.

    에어브릿지 스탠다드 이벤트와 1번 이상 수집된 커스텀 이벤트를 사용할 수 있습니다. any_event로 모든 이벤트를 리턴 이벤트로 설정할 수 있습니다.

    measurementOption
    필수enum

    User Journey를 바라보는 관점에서 리텐션을 분석할 수 있도록 설정. 참고

    ENUM VALUES
    general_retention

    General. 스타트 이벤트의 리턴 이벤트 대한 기여를 Lifetime으로 보아 분석 기간 전체의 사용자 Engagement를 확인하는 용도로 사용할 수 있습니다. 한 리턴 이벤트가 둘 이상 스타트 이벤트의 리텐션으로 계산될 수 있습니다.

    confined_retention

    Confined. 리턴 이벤트에 대한 기여를 새로운 스타트 이벤트가 발생하기 전 까지로 한정하여 보아 각 스타트 이벤트별 사용자의 Engagement를 ‘General’ 옵션보다 조금 더 엄밀하게 확인하는 용도로 사용할 수 있습니다.

    groupBy
    object

    그룹바이는 조회할 메트릭의 수치를 나누는 기준입니다. 조회에 사용할 그룹바이 항목 혹은 코호트를 설정할 수 있습니다.

    groupBy.fields
    string[]

    리포트 그룹바이.

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

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

    filters
    object[]

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

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

    filters[0].field
    필수string

    필터를 지정할 그룹바이.

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

    filters[0].filterType
    필수enum

    필터에 적용할 연산자.

    ENUM VALUES
    IN

    속해있다. 리텐션 리포트에서는 같다(is, =)에 대응합니다.

    NOT IN

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

    EXIST

    값이 존재한다. (exists)

    NOT EXIST

    값이 존재하지 않는다. (does not exist)

    filters[0].values
    string[]

    필터에 적용할 값.

    sorts
    필수object[]

    '그룹바이' 또는 '메트릭'을 기준으로 리포트 데이터를 정렬할 수 있습니다.

    sorts[0].fieldName
    필수string

    정렬에 사용할 그룹바이 또는 메트릭.

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

    sorts[0].isAscending
    필수boolean

    정렬 기준의 오름차순(A-Z) 여부. (기본값: true)

    keyword
    string

    group by를 필터링 할 수 있는 값.

    pagination
    object
    pagination.skip
    필수integer

    skip할 row의 수.

    pagination.size
    필수integer

    query 할 row의 수. 기본값: 100

    Response

    200 SUCCESS

    400 ERROR


    리포트 가져오기

    GET

    https://api.airbridge.io/reports/api/v5/apps/{app_name}/retention/query/{task_id}

    비동기 요청 상태 정의

    비동기 요청 상태는 API 요청 결과의 task.status로 확인할 수 있습니다. 요청 상태는 아래와 같이 정의하고 있습니다.

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

    PENDING

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

    RUNNING

    데이터를 집계중입니다

    SUCCESS

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

    FAILURE

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

    CANCELED

    요청이 취소되었습니다

    알립니다

    isMasked가 true이면 해당 cell의 값은 숨겨진 수치입니다.

    페이스북 개인정보 보호 정책으로 인해 페이스북 광고 노출이 1,000건 이하이거나 페이스북으로 기여된 설치수가 100건 이하인 데이터는 해당 수치를 보여주지 않습니다.

    마스킹된 값이 있을 경우 notification 이 제공됩니다.

    Request

    Path Params

    app_name
    필수string

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

    task_id
    필수string

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

    Query Params

    skip
    string

    skip할 row 수.

    size
    string

    결과를 받아올 row 수.

    Response

    200 (리포트 생성중)SUCCESS

    200 (리포트 생성완료)SUCCESS

    404 ERROR

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

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