• API 레퍼런스

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

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

events
필수string[]

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

properties
필수string[]

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

filters
object[]

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

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

Request
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
{ "dateRange": { "start": "2023-01-01 01:00:00", "end": "2023-01-07 01:00:00" }, "events": [ "app_install" ], "properties": [ "channel" ]}

Response

200SUCCESS

404ERROR

Response
{ "at": 1541410684717, "data": { "reportID": 2500 }}
Response
{ "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
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
{ "data": { "url": "https://ab180-athena.s3.amazonaws.com/workgroup/..." }}