Raw Data

    에어브릿지로 트래킹한 광고 성과의 로우 데이터(Raw Data)는 에어브릿지 대시보드 [Raw Data] 메뉴에서 CSV 파일로 다운로드할 수 있습니다. 로우 데이터는 에어브릿지 대시보드 [App Raw Data]와 [Web Raw Data]에서 확인할 수 있습니다.

    Raw Data 추출 요청하기

    POST

    https://api.airbridge.io/log-export/api/v3/apps/{app_name}/{type}/request

    Raw Data 추출을 요청합니다.

    rate limit : 하루 100개로 제한됩니다.

    Request

    Body Params

    dateRange
    필수object

    데이터 추출 기간을 설정합니다.

    dateRange.start
    필수string

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

    • YYYY-MM-DD HH:mm:ss 형태입니다.

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

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

    dateRange.end
    필수string

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

    • YYYY-MM-DD HH:mm:ss 형태입니다.

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

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

    events
    필수string[]

    추출하고자 하는 이벤트. Event (App Event Key, Web Event Key)

    properties
    필수string[]

    포함할 Property. (App Event Properties, Web Event Properties)

    filters
    object[]

    'Properties'로 제공하는 항목들에 대한 필터.

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

    filters[0].field
    string

    필터를 지정할 Property 필드.

    filters[0].condition
    object
    filters[0].condition.type
    필수enum

    필터에 적용할 연산자.

    ENUM VALUES
    equal

    같다.

    not_equal

    같지 않다.

    in

    속해있다.

    not_in

    속해있지 않다.

    exist

    값이 존재한다.

    not_exist

    값이 존재하지 않는다.

    lt

    작다.

    lte

    작거나 같다.

    gt

    크다.

    gte

    크거나 같다.

    between

    사이에 있다.

    filters[0].condition.value
    필수string

    필터에 적용할 값. 타입이 "equal", "not_equal", "lt", "lte", "gt", "gte" 일 때 사용합니다.

    filters[0].condition.values
    필수string[]

    필터에 적용할 값. 타입이 "in", "not_in"일 경우 사용합니다.

    filters[0].condition.start
    필수string

    타입이 between일 경우 시작일.

    filters[0].condition.end
    필수string

    타입이 between일 경우 종료일.

    Request
    12
    curl -X POST 'https://api.airbridge.io/log-export/api/v3/apps/{app_name}/{type}/request' \
  -d '{"dateRange":{"start":"2023-01-01 01:00:00","end":"2023-01-07 01:00:00"},"events":["app_install"],"properties":["channel"]}'
    Payload
    123456789101112
    {
  "dateRange": {
    "start": "2023-01-01 01:00:00",
    "end": "2023-01-07 01:00:00"
  },
  "events": [
    "app_install"
  ],
  "properties": [
    "channel"
  ]
}

    Response

    200SUCCESS

    404ERROR

    Response
    123456
    {
  "at": 1541410684717,
  "data": {
    "reportID": 2500
  }
}
    Response
    123456
    {
  "type": "about:blank",
  "title": "Not Found",
  "status": 404,
  "traceId": "1-000000-000000000000000"
}

    Raw Data 추출 결과 가져오기

    GET

    https://api.airbridge.io/log-export/api/v3/apps/{app_name}/request/{report_id}

    Raw Data 추출 결과를 다운로드 할 수 있는 URL을 가져옵니다.

    Request

    Headers

    Accept-Language
    string

    API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.

    Content-Type
    string

    리소스의 미디어 타입을 나타냅니다. 기본값으로 application/json을 사용합니다.

    Authorization
    string

    API 요청에 사용하는 키값입니다. 키값 생성 및 조회 방법을 확인하여 획득할 수 있습니다.

    Path Params

    app_name
    필수string

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

    Request
    1234
    curl -X GET 'https://api.airbridge.io/log-export/api/v3/apps/{app_name}/request/{report_id}' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'

    Response

    200SUCCESS

    Response
    12345
    {
  "data": {
    "url": "https://ab180-athena.s3.amazonaws.com/workgroup/..."
  }
}

    도움이 되었나요?

    더 필요한 내용이 있나요?