소개
DARO 서버는 유저가 DARO를 통해 제공되는 리워드 비디오 광고 시청을 완료하면 개발사가 지정한 외부 서버로 콜백을 보냅니다. 이 콜백은 HTTP 또는 HTTPS GET 요청 형태로 전송됩니다. 광고 시청 완료 직후 콜백이 전송되지만, 네트워크 상황에 따라 최대 몇 분까지 지연될 수도 있어요. 임프레션 타임스탬프 파라미터를 사용하면 임프레션과 콜백 시간 사이의 차이를 쉽게 확인할 수 있습니다. 만약 개발사의 서버가 5초 이내에 응답하지 않으면 콜백 요청은 타임아웃 처리됩니다. 타임아웃이 발생하면 DARO는 최대 2회까지 콜백 전송을 재시도합니다.
Callback URL 입력 예시
Callback URL 요청 예시
전송되는 쿼리 파라미터 상세 SPEC
콜백 URL에 다음 표의 파라미터가 모두 쿼리스트링으로 함께 전송됩니다. custom_data 나 user_id를 설정 하지 않은 경우 null로 전달 됩니다.| 쿼리 파라미터 이름 | 설명 | 예시 | 데이터 타입 |
|---|---|---|---|
| ad_unit_id | 미디에이션 광고 단위 ID (UUID v4) | fa1c6d2f-5016-467d-b54c-672299c7db4c | String |
| custom_data (optional) | 사용자 정의 데이터 (URL 인코딩됨). 문자열 크기를 8192자 미만으로 유지할 것을 권장합니다. | my%20custom%20data | String |
| key | 아래 과정을 통해 생성된 키와 비교를 통해 검증 합니다. 1. hmac sha256 ‘콜백 검증 키’*를 넣고 초기화 2. transaction_id 를 넣고 digest 생성 3. 16진수 (hex) 인코딩 | b46635e51e76778ec15856720114c4edd6b6c3c7aeeb2a1b51dc346640cbca45 | String |
| timestamp | 광고 로드 시간의 타임스탬프 (정수, Epoch Time) | 1546300800 | Int |
| transaction_id | 고유 트랜잭션 ID, 32자리 16진수 | 0d0f748fcd0d4a4a9f6ac809216564b1 | String |
| user_id (optional) | 퍼블리셔가 정의한 사용자 ID (URL 인코딩됨); 최대 길이는 8192자 | 7634657898 | String |
- 발급된 콜백 검증 키는 https://dashboard.daro.so/service/account 에서 확인 가능합니다.