Skip to main content

​
소개

DARO 서버는 유저가 DARO를 통해 제공되는 리워드 비디오 광고 시청을 완료하면 개발사가 지정한 외부 서버로 콜백을 보냅니다. 이 콜백은 HTTP 또는 HTTPS GET 요청 형태로 전송됩니다. 광고 시청 완료 직후 콜백이 전송되지만, 네트워크 상황에 따라 최대 몇 분까지 지연될 수도 있어요. 임프레션 타임스탬프 파라미터를 사용하면 임프레션과 콜백 시간 사이의 차이를 쉽게 확인할 수 있습니다. 만약 개발사의 서버가 5초 이내에 응답하지 않으면 콜백 요청은 타임아웃 처리됩니다. 타임아웃이 발생하면 DARO는 최대 2회까지 콜백 전송을 재시도합니다. Ad Unit Reward Callback 이 콜백 기능을 사용하려면 ‘광고 단위’ 페이지에서 리워드 비디오 광고 단위의 ‘콜백 URL’ 값을 설정해주세요.

​
Callback URL 입력 예시

​
Callback URL 요청 예시

​
전송되는 쿼리 파라미터 상세 SPEC

콜백 URL에 다음 표의 파라미터가 모두 쿼리스트링으로 함께 전송됩니다. custom_data 나 user_id를 설정 하지 않은 경우 null로 전달 됩니다.

​
응답 상태 코드와 재시도

DARO는 콜백 응답의 HTTP 상태 코드를 기준으로 전송 완료 여부를 판단합니다. 408, 429, 5xx 응답 또는 네트워크 오류가 발생하면 자동으로 재시도되며, 이후에도 실패하면 다시 전송될 수 있습니다.
처리 완료된 비즈니스 거절에는 HTTP 상태 코드 500을 반환하지 마세요.콜백을 정상적으로 수신하고 보상 여부에 대한 판단을 완료했다면, 보상을 지급하지 않는 경우에도 200 또는 204로 응답하세요. 500은 일시적인 서버 장애로 처리되어 불필요한 자동 재시도를 일으키고, 이후 다시 전송될 수 있습니다.
응답 body는 필요에 맞게 구성할 수 있습니다. DARO의 재시도 여부는 body가 아니라 HTTP 상태 코드를 기준으로 결정됩니다.

​
중복 콜백 처리

네트워크 상태나 재시도로 동일한 콜백이 여러 번 전달될 수 있으므로 transaction_id를 기준으로 멱등하게 처리하세요. 처리 결과를 저장하고, 이미 처리한 transaction_id가 다시 전달되면 보상을 중복 지급하지 말고 기존 결과에 따라 2xx로 응답하는 것을 권장합니다.

​
퍼블리셔 정의 User ID, Custom Data 세팅하기

아래 링크를 참조하여 각 OS에 맞게 클라이언트에 세팅해주세요. 세팅한 user_id, custom_data 값이 콜백 URL에 함께 전송됩니다. Optional한 값이며 설정하지 않은 경우 null로 전달됩니다.