Skip to main content

​
Overview

DARO sends an HTTP/HTTPS GET request to your server when users complete rewarded video ads. Callbacks send immediately after completion but may delay up to several minutes depending on network conditions. Use the timestamp parameter to verify time difference between impression and callback. Retry Logic: DARO retries up to 2 times if your server doesn’t respond within 5 seconds. Ad Unit Reward Callback Setup: Configure ‘Callback URL’ for your rewarded video ad unit on the Ad Units page.

​
Callback URL Example

https://yourrewardedserver.com/rewards

​
Callback URL Request Example

https://yourrewardedserver.com/rewards?ad_unit_id=fa1c6d2f-5016-467d-b54c-672299c7db4c&custom_data=yourcustomdata&key=b46635e51e76778ec15856720114c4edd6b6c3c7aeeb2a1b51dc346640cbca45&timestamp=1546300800&transaction_id=32ffe34770064d5c41c24deb3afd6a9fe072d2f423471851c869da6a9bc09ce3&user_id=youruserid

​
Query Parameters

Parameters included as query strings in callback URL. Optional parameters (custom_data and user_id) pass as null if not set.
Query ParameterDescriptionExampleData Type
ad_unit_idMediation ad unit ID (UUID v4)fa1c6d2f-5016-467d-b54c-672299c7db4cString
custom_data (optional)Custom data (URL encoded). Recommended to keep string size under 8192 characters.my%20custom%20dataString
keyVerification key generated through the following process:
1. Initialize HMAC SHA256 with ‘Callback Verification Key’*
2. Generate digest with transaction_id
3. Hex encode		b46635e51e76778ec15856720114c4edd6b6c3c7aeeb2a1b51dc346640cbca45String
timestampTimestamp when ad was loaded (integer, Epoch Time)1546300800Int
transaction_idUnique transaction ID, 32-character hex0d0f748fcd0d4a4a9f6ac809216564b1String
user_id (optional)Publisher-defined user ID (URL encoded); maximum length 8192 characters7634657898String

​
Set Publisher-Defined User ID and Custom Data

Set user_id and custom_data on the client side using platform-specific SDK methods. These optional values send with the callback. Platform Guides: