User GuideDeveloper GuideAPI
Dashboard

    Retention Report

    The Retention Report shows how many users returned to the app a certain number of days after installing the app or opening the app through a deep link.

    You can identify the channels and campaigns that attract the most active app users. The retention data can be used for campaign optimization and ad billings.

    Request Report

    POST

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

    Request a Retention Report.

    Request

    Headers

    Accept-Language
    string

    您可指定用于 API 请求和结果返回的语言。遵守 ISO-639-1 格式。

    Content-Type
    string

    表示资源的媒体类型。默认使用 application/json。

    Authorization
    string

    用于 API 请求的键值。

    Path Params

    app_name
    Requiredstring

    Airbridge App 名称（App Name）

    Body Params

    from
    Requiredstring
    to
    Requiredstring
    granularity
    Requiredenum
    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.

    hour

    Analyze the data by hour. Only Install (App) can be set as the start event.

    minute

    Analyze the data by minute. Only Install (App) can be set as the start event.

    startEvent
    Requiredenum[]
    ENUM VALUES
    app_installs

    Installs (App). Install events that occurred within the selected time period.

    app_deeplink_opens

    Deeplink Opens (App). Deeplink Open events that occurred within the selected time period.

    app_deeplink_pageviews

    Deeplink Pageviews (App). Deeplink Pageview events that occurred within the selected time period.

    returnEvents
    Requiredenum[]
    ENUM VALUES
    app_order_complete

    Order Complete (App). Order Complete event performed within the selected time period.

    app_first_order_complete

    First Order Complete (App). First Order Complete event performed within the selected time period.

    app_ad_impression

    Ad Impression (App). Ad Impression event performed within the selected time period.

    app_ad_click

    Ad Click (App). Ad Click event performed within the selected time period.

    app_subscribe

    Subscribe (App). Subscribe event performed within the selected time period.

    measurementOption
    Requiredenum
    ENUM VALUES
    general_retention

    General. A User Journey of a unique user is initiated by the Start Event performed by that user.

    confined_retention

    Confined. A User Journey of a unique user is initiated by the Start Event performed by that user. The Airbridge Device ID is used to identify unique users.

    groupBy
    Requiredobject
    filters
    Requiredobject[]
    sorts
    Requiredobject[]
    keyword
    string
    pagination
    object
    Request
    12345
    curl -X POST 'https://api.airbridge.io/reports/api/v5/apps/{app_name}/retention/query' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}' \
  -d '{"from":"2022-11-04","to":"2022-11-11","granularity":"day","startEvent":["app_installs"],"returnEvents":["app_order_complete"],"measurementOption":"general_retention","groupBy":{"fields":["channel"]},"filters":[{"field":"campaign","filterType":"IN","values":["App"]}],"sorts":[{"fieldName":"event_type","isAscending":true}],"pagination":{"skip":0,"size":50}}'
    Payload
    123456789101112131415161718192021222324252627282930313233343536
    {
  "from": "2022-11-04",
  "to": "2022-11-11",
  "granularity": "day",
  "startEvent": [
    "app_installs"
  ],
  "returnEvents": [
    "app_order_complete"
  ],
  "measurementOption": "general_retention",
  "groupBy": {
    "fields": [
      "channel"
    ]
  },
  "filters": [
    {
      "field": "campaign",
      "filterType": "IN",
      "values": [
        "App"
      ]
    }
  ],
  "sorts": [
    {
      "fieldName": "event_type",
      "isAscending": true
    }
  ],
  "pagination": {
    "skip": 0,
    "size": 50
  }
}

    Response

    200SUCCESS

    400ERROR

    Response
    12345
    {
  "data": {
    "taskId": "5e286bd4-b4b1-4c04-8f6a-123456789abc"
  }
}

    Get Report

    GET

    https://api.airbridge.io/reports/api/v5/apps/{app_name}/retention/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

    Headers

    Accept-Language
    string

    您可指定用于 API 请求和结果返回的语言。遵守 ISO-639-1 格式。

    Content-Type
    string

    表示资源的媒体类型。默认使用 application/json。

    Authorization
    string

    用于 API 请求的键值。

    Path Params

    app_name
    Requiredstring

    Airbridge App 名称（App Name）

    task_id
    Requiredstring

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

    Query Params

    skip
    number

    The number of objects to be skipped.

    The default is 0.

    size
    number

    A limit on the number of objects to be returned.

    The default is 100.

    Request
    1234
    curl -X GET 'https://api.airbridge.io/reports/api/v5/apps/{app_name}/retention/query/{task_id}' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'

    Response

    200SUCCESS

    200SUCCESS

    404ERROR

    Response
    1234567
    {
  "task": {
    "status": "RUNNING",
    "taskId": "5e286bd4-b4b1-4c04-8f6a-670dc7ce637d",
    "endedAt": "2022-01-17T19:10:00.286939+09:00"
  }
}

    Was this page helpful?

    Have any questions or suggestions?