Skip to main content
비동기 요청 상태 정의
비동기 요청 상태는 API 요청 결과의 task.status로 확인할 수 있습니다.
PENDING데이터 집계를 위한 준비를 하고 있습니다
RUNNING데이터를 집계중입니다
SUCCESS집계가 완료되어 결과값을 반환합니다
FAILURE알 수 없는 이유로 요청이 실패하였습니다
CANCELED요청이 취소되었습니다
안내 메세지(Notification) 정의
집계 과정에서 일부 데이터를 제거하거나 가려졌을 경우(마스킹), notification[0].code에 해당 사유를 확인할 수 있습니다.
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일 이전의 데이터를 제거하였습니다.
메타 개인정보보호정책메타 개인정보보호정책에 따라 에어브릿지 리포트에 설정한 조회 기간 동안 발생한 일부 메타 비즈니스(facebook.business) 데이터가 마스킹됩니다. isMasked가 true면 마스킹된 데이터입니다.메타 개인정보보호정책에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

Try API Request

GET

Request


Headers

string
API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.
string
리소스의 미디어 타입을 나타냅니다. 기본값으로 application/json을 사용합니다.
string
API 요청에 사용하는 키값입니다. 키값 생성 및 조회 방법을 확인하여 획득할 수 있습니다.

Path Params

string
필수
에어브릿지 앱 이름(App Name)
string
필수
‘리포트 생성하기’ API의 결과값에서 반환한 task_id입니다.

Query Params

number
결과값에서 건너뛸 Row의 수.결과값에서 처음 N개의 Row를 제외하고 가져옵니다.기본값은 0 입니다.
number
반환할 Row 수.skip으로 건너뛴 결과의 다음부터 N개의 Row를 가져옵니다.기본값은 100입니다.예시) ?skip=200&size=100이면 처음 200개를 건너뛰고 201번쨰부터 300번째 까지의 Row를 가져옵니다.
string
GroupBy에서 필터링할 검색 키워드.
boolean
대시보드에서 Actuals Report에 대한 값을 표현해 줄 때 사용하는 포맷 정보를 포함할지 여부를 결정합니다.true일 경우 viewFormat 필드에 (메타 애즈 마스킹과 같은) 포맷 정보가 “{value}”, “{value} +α”, “Privacy Block” 등 과 같은 형태로 추가됩니다.기본값은 false 입니다.

Response


200

비동기 요청을 처리하는 중입니다. 해당 API를 주기적으로 폴링(Polling)하여 결과를 확인할 수 있으며, 요청 상태는 요청 상태는 task.status로 확인할 수 있습니다.

200

데이터 집계가 완료된 결과를 반환합니다. statusSUCCESS일 경우, actuals에 데이터 및 메타데이터, 메세지 등을 담아 전송합니다.