S2S 리워드 콜백 API
DARO 서버에서는 개발사가 설정한 외부 서버로 서버 간(S2S) 리워드 콜백을 보낼 수 있습니다. 이 콜백을 통해 앱 유저가 리워드 비디오 광고를 끝까지 시청했을 때 리워드를 받을 자격이 있다는 것을 알려드립니다. 이 기능은 리워드 비디오 광고를 제대로 보지 않고 부당하게 리워드를 받으려는 악의적인 사용자들로부터 서비스를 보호해줍니다.
해당 기능은 현재 Reward 앱에 대해서만 제공하고 있으며, Non-reward 앱에 대해서는 제공하고 있지 않습니다.
소개
DARO 서버는 유저가 DARO를 통해 제공되는 리워드 비디오 광고 시청을 완료하면 개발사가 지정한 외부 서버로 콜백을 보냅니다. 이 콜백은 HTTP 또는 HTTPS GET 요청 형태로 전송됩니다. 광고 시청 완료 직후 콜백이 전송되지만, 네트워크 상황에 따라 최대 몇 분까지 지연될 수도 있어요. 임프레션 타임스탬프 파라미터를 사용하면 임프레션과 콜백 시간 사이의 차이를 쉽게 확인할 수 있습니다.
만약 개발사의 서버가 5초 이내에 응답하지 않으면 콜백 요청은 타임아웃 처리됩니다. 타임아웃이 발생하면 DARO는 최대 2회까지 콜백 전송을 재시도합니다.
이 콜백 기능을 사용하려면 ‘광고 단위’ 페이지에서 리워드 비디오 광고 단위의 ‘콜백 URL’ 값을 설정해주세요.
Callback URL 입력 예시
Callback URL 요청 예시
전송되는 쿼리 파라미터 상세 SPEC
콜백 URL에 다음 표의 파라미터가 모두 쿼리스트링으로 함께 전송됩니다. custom_data 나 user_id를 설정 하지 않은 경우 null로 전달 됩니다.
| 쿼리 파라미터 이름 | 설명 | 예시 | 데이터 타입 |
|---|---|---|---|
| mediation_ad_unit_id | 미디에이션 광고 단위 ID (16자리 16진수) | 9ad0816ac071552a | String |
| custom_data (optional) | 사용자 정의 데이터 (URL 인코딩됨). 문자열 크기를 8192자 미만으로 유지할 것을 권장합니다. | my%20custom%20data | String |
| key | 아래 과정을 통해 생성된 키와 비교를 통해 검증 합니다.
| 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 에서 확인 가능합니다.
퍼블리셔 정의 User ID, Custom Data 세팅하기
아래 링크를 참조하여 각 OS에 맞게 클라이언트에 세팅해주세요. 세팅한 user_id, custom_data 값이 콜백 URL에 함께 전송됩니다. Optional한 값이며 설정하지 않은 경우 null로 전달됩니다.