오디언스

상태를 변경하려면 Token을 사용해야 합니다. 자세한 내용은 Token을 확인하세요.

이 장에서는 Advanced Performance Reporting API를 소개합니다.

리포트 데이터 조회 시점 가이드라인

데이터 업데이트 규칙:

• 시간별 데이터: 일반적으로 처리에 2-3시간이 걸립니다.
• 일별 데이터(T+1): 일반적으로 처리에 2-4시간이 걸립니다.

권장 조회 시간:

• 시간별 데이터: 대상 시간으로부터 2.5시간 후에 가져오는 것을 권장합니다.
• 일별 데이터: 다음 날 03:00 이후에 조회하는 것을 권장합니다.

예시:

• 1월 1일 10:00:00-10:59:59 데이터를 조회하는 경우 → 권장 시점: 1월 1일 12:30 이후.
• 1월 1일 전체 일별 데이터를 조회하는 경우 → 권장 시점: 1월 2일 03:00 이후.

dimension_option 파라미터를 조정하여 특정 차원을 조회할 수 있습니다. 이 인터페이스 호출은 두 단계로 나뉩니다.

1. 먼저 parameter type = 1로 설정하고 인터페이스를 호출해야 합니다. 시스템은 서버에서 비동기적으로 데이터를 생성합니다.
   인터페이스가 code = 200을 반환하면 데이터가 성공적으로 생성된 것입니다.

1.1 요청 후 데이터가 생성될 때까지 기다려야 합니다. type = 1로 동일한 요청을 계속 보낼 수 있으며(Token은 업데이트해야 함), 이를 통해 데이터 생성 정보를 확인할 수 있습니다.

1.2 인터페이스가 code=200을 반환하면 데이터가 성공적으로 생성되었음을 의미합니다.

1.3 현재 날짜의 데이터를 조회하는 경우 데이터가 불완전할 수 있습니다. 데이터는 시간 단위로 업데이트되므로, 데이터가 준비될 때까지 n시간 기다린 뒤 type=1로 다시 요청하여 데이터를 업데이트하고 최신 데이터 생성 정보를 받은 다음, type=2를 사용해 데이터를 업데이트할지 판단할 수 있습니다.

1.4 데이터 생성 정보는 Response(type=1)를 참고하세요.

2. 데이터가 생성된 후 parameter type = 2로 설정하고 인터페이스를 다시 호출하면 데이터를 직접 다운로드할 수 있습니다.

2.1 데이터가 아직 생성되지 않은 경우, type = 2 인터페이스 호출 시 200이 아닌 코드가 반환됩니다.

2.2 데이터가 생성된 경우, type = 2 인터페이스는 파일 바이트 스트림(Content-Type: application / octet-stream)을 직접 반환합니다.

2.3 데이터는 "\t"로 열이 구분되고 "\n"으로 행이 구분됩니다.

2.4 반환되는 데이터는 현재 요청의 전체 데이터이며, 증분 데이터만 반환하는 것이 아닙니다.

요청 주소

https://ss-api.mintegral.com/api/v2/reports/data

요청 메서드

GET

요청 예시

GET /api/v2/reports/data?start_time=2024-06-01&end_time=2024-06-01&type=1&dimension_option=Offer
HTTP/1.1 Host: ss-api.mintegral.com

요청 파라미터

반환 파일 헤더(fields)(type=2)

응답(type=1)

응답(type=2이며 반환 코드가 200이 아닌 경우)

응답 예시

{
  "code": 200,
  "msg": "success",
  "data": {
    "hours": 24,
    "is_complete": true
  }
}