Actuals Report

Headers

Accept-Language

string

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

Content-Type

string

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

Authorization

string

API 요청에 사용하는 키값입니다. 을 확인하여 획득할 수 있습니다.

Path Params

app_name

필수string

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

Body Params

from

필수string

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

YYYY-MM-DD 형태입니다.
에어브릿지 앱의 타임존이 적용된 날짜이어야 합니다.
현재로부터 365일 전까지 설정할 수 있습니다.

필수string

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

YYYY-MM-DD 형태입니다.
에어브릿지 앱의 타임존이 적용된 날짜이어야 합니다.
현재 날짜까지 설정할 수 있으며 최대 조회 기간은 92일입니다.

groupBys

필수string[]

리포트 그룹바이.

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

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

metrics

필수string[]

리포트 메트릭.

메트릭으로 다양한 광고 성과 데이터를 조회할 수 있습니다. 액츄얼스 리포트에서 선택할 수 있는 전체 메트릭 리스트는 리포트 메트릭에서 확인할 수 있습니다.

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

filters

필수object[]

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

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

sorts

필수object[]

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

option

object

추가 옵션을 설정할 수 있습니다.

Request

12345
curl -X POST 'https://api.airbridge.io/reports/api/v7/apps/{app_name}/actuals/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","groupBys":["event_source","event_type","event_category"],"metrics":["app_events"],"filters":[{"dimension":"channel","filterType":"IN","values":["App"]}],"sorts":[{"fieldName":"event_type","isAscending":true}]}'

Payload

123456789101112131415161718192021222324252627
{
  "from": "2022-11-04",
  "to": "2022-11-11",
  "groupBys": [
    "event_source",
    "event_type",
    "event_category"
  ],
  "metrics": [
    "app_events"
  ],
  "filters": [
    {
      "dimension": "channel",
      "filterType": "IN",
      "values": [
        "App"
      ]
    }
  ],
  "sorts": [
    {
      "fieldName": "event_type",
      "isAscending": true
    }
  ]
}

`#{"style":{"minWidth":"130px"}}` `PENDING`	데이터 집계를 위한 준비를 하고 있습니다.
`RUNNING`	데이터를 집계중입니다.
`SUCCESS`	집계가 완료되어 결과값을 반환합니다.
`FAILURE`	요청이 실패하였습니다.
`CANCELED`	요청이 취소되었습니다.

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

PENDING

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

RUNNING

데이터를 집계중입니다.

SUCCESS

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

FAILURE

요청이 실패하였습니다.

CANCELED

요청이 취소되었습니다.

`#{"style":{"minWidth":"130px"}}` `PENDING`	데이터 집계를 위한 준비를 하고 있습니다
`RUNNING`	데이터를 집계중입니다
`SUCCESS`	집계가 완료되어 결과값을 반환합니다
`FAILURE`	알 수 없는 이유로 요청이 실패하였습니다
`CANCELED`	요청이 취소되었습니다

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

PENDING

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

RUNNING

데이터를 집계중입니다

SUCCESS

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

FAILURE

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

CANCELED

요청이 취소되었습니다

`#{"style":{"minWidth":"310px"}}` `MEDIA_PARTNER_DATA_FILTERED_BY_CHANNEL`	미디어 파트너 권한으로 요청을 하여, 데이터 중 볼 수 없는 매체의 데이터를 제외하였습니다.
`AGG_DATA_MASKING_BY_FACEBOOK`	페이스북 개인정보 보호 정책으로 인해 일부 데이터가 제거되거나 가려졌습니다.
`EXCEEDED_LIMIT_ON_MAX_ROW_COUNT`	요청에 해당하는 결과값이 10,000건을 넘습니다. Raw Data Export를 사용해 데이터를 추출하는 것을 권장합니다.
`SAN_PERIOD_LIMIT`	페이스북 등 Self-Attributed Network에 기여된 데이터 중 175일 이전의 데이터를 제거하였습니다.

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

MEDIA_PARTNER_DATA_FILTERED_BY_CHANNEL

미디어 파트너 권한으로 요청을 하여, 데이터 중 볼 수 없는 매체의 데이터를 제외하였습니다.

AGG_DATA_MASKING_BY_FACEBOOK

페이스북 개인정보 보호 정책으로 인해 일부 데이터가 제거되거나 가려졌습니다.

EXCEEDED_LIMIT_ON_MAX_ROW_COUNT

요청에 해당하는 결과값이 10,000건을 넘습니다. Raw Data Export를 사용해 데이터를 추출하는 것을 권장합니다.

SAN_PERIOD_LIMIT

페이스북 등 Self-Attributed Network에 기여된 데이터 중 175일 이전의 데이터를 제거하였습니다.

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

{ "task": { "status": "SUCCESS", "taskId": "5e286bd4-b4b1-4c04-8f6a-670dc7ce637d", "endedAt": "2022-10-01T00:00:00+00:00" }, "actuals": { "data": { "rows": [ { "values": { "app_installs": { "value": 100, "isMasked": false, "viewFormat": "{value}" } }, "groupBys": [ "<groupBy>" ] }, { "values": { "app_installs": { "value": 13, "isMasked": true, "viewFormat": "{value} +α" } }, "groupBys": [ "<groupBy>" ] } ] }, "metadata": { "rowCount": 2 } }, "pagination": { "hasNext": true, "totalCount": 200 }, "notifications": [] }

curl -X GET 'https://api.airbridge.io/dataspec/v2/apps/{app_name}/actual-report/fields' \ -H 'Accept-Language: ko' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'

{ "data": [ { "fields": [ { "key": "event_date", "name": "Event Date", "example": "2019-05-31", "description": "이벤트 발생 날짜와 시간 (YYYY-MM-DD)", "serveToFilter": true }, { "key": "event_year", "name": "Event Year", "example": "2019", "description": "이벤트 발생 년도", "serveToFilter": true }, { "key": "event_month", "name": "Event Month", "example": "04", "description": "이벤트 발생 월", "serveToFilter": true } ], "groupName": "Event Datetime", "parentGroupName": null }, { "fields": [ { "key": "event_source", "name": "Event Source", "example": "App", "description": "Event가 발생한 소스", "serveToFilter": true }, { "key": "event_type", "name": "Event Type", "example": "Impression", "description": "Event 타입", "serveToFilter": true }, { "key": "event_category", "name": "Event Category", "example": "Move to App Store (Link)", "description": "Event 카테고리", "serveToFilter": true } ], "groupName": "Event Hierarchy", "parentGroupName": null }, { "fields": [ { "key": "channel", "name": "Channel", "example": "moloco", "description": "Touchpoints 와 Conversion이 발생한 Channel\n", "serveToFilter": true }, { "key": "campaign", "name": "Campaign", "example": "2018_summer_campaign", "description": "Touchpoints 와 Conversion이 발생한 Campaign \n(SAN Publisher 대시보드에서 입력한 값 또는 Tracking Link의 캠페인 파라미터 값)", "serveToFilter": true } ], "groupName": "Touchpoint", "parentGroupName": null } ] }

curl -X GET 'https://api.airbridge.io/dataspec/v2/apps/{app_name}/actual-report/metrics' \ -H 'Accept-Language: ko' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'

{ "data": [ { "fields": [ { "key": "touchpoints_impression_click", "name": "Touchpoints (Impression+click)", "description": "Impression 수와 Click 수의 합" }, { "key": "impressions", "name": "Impressions", "description": "Impression 수" }, { "key": "clicks", "name": "Clicks", "description": "Click 수" } ], "groupName": "Touchpoint", "parentGroupName": "Touchpoint" }, { "fields": [ { "key": "app_events", "name": "Events (App)", "description": "앱에서 발생한 이벤트 수" }, { "key": "app_event_value", "name": "Event 값 (App)", "description": "앱에서 발생한 이벤트 값의 합" } ], "groupName": "App Event", "parentGroupName": "App" }, { "fields": [ { "key": "app_installs", "name": "Installs (App)", "description": "Install 수" }, { "key": "app_first_installs", "name": "First Installs (App)", "description": "최초로 설치된 Install 수" } ], "groupName": "App Install", "parentGroupName": "App" }, { "fields": [ { "key": "app_sign_up", "name": "회원가입 (App)", "description": "앱에서 발생한 회원가입 이벤트 수" }, { "key": "app_sign_in", "name": "로그인 (App)", "description": "앱에서 로그인 이벤트 수" }, { "key": "app_sign_out", "name": "로그아웃 (App)", "description": "앱에서 로그아웃 이벤트 수" } ], "groupName": "App Standard Event", "parentGroupName": "App" } ] }

리포트 생성하기

Request

Headers

Path Params

Body Params

Response

200SUCCESS

404ERROR

리포트 가져오기

메타 개인정보보호정책

Request

Headers

Path Params

Query Params

Response

200SUCCESS

200SUCCESS

메타데이터 가져오기 (GroupBy)

Request

Headers

Path Params

Response

200SUCCESS

404ERROR

메타데이터 가져오기 (Metric)

Request

Headers

Path Params

Response

200SUCCESS

404ERROR

Actuals Reportself.__wrap_n!=1&&self.__wrap_b(":R96fnkv79uuba:",0.5)

리포트 생성하기

Request

Headers

Path Params

Body Params

Response

200SUCCESS

404ERROR

리포트 가져오기

메타 개인정보보호정책

Request

Headers

Path Params

Query Params

Response

200SUCCESS

200SUCCESS

메타데이터 가져오기 (GroupBy)

Request

Headers

Path Params

Response

200SUCCESS

404ERROR

메타데이터 가져오기 (Metric)

Request

Headers

Path Params

Response

200SUCCESS

404ERROR

Actuals Report