# Postback Parameters

##### Summary

This page describes the parameters available for sending postback requests from a CPA network or tracking platform to DAO.AD.

<table id="bkmrk-macro-value-descript" style="height: 273.979px; width: 100%;"><thead><tr style="height: 29.5104px;"><th class="align-left" style="width: 18.8245%; height: 29.5104px;">**URL Parameter**</th><th style="width: 15.6109%; height: 29.5104px;">**Value**</th><th style="width: 65.5249%; height: 29.5104px;">**Description**</th></tr></thead><tbody><tr style="height: 29.4583px;"><td style="width: 18.8245%; height: 29.4583px;">**DAO.AD API Server**</td><td class="align-left" style="width: 15.6109%; height: 29.4583px;">constant</td><td style="width: 65.5249%; height: 29.4583px;">DAO.AD postback endpoint URL</td></tr><tr style="height: 40.25px;"><td class="align-left" style="width: 18.8245%; height: 40.25px;">**key**</td><td class="align-left" style="width: 15.6109%; height: 40.25px;">text</td><td style="width: 65.5249%; height: 40.25px;">Unique API key used to authenticate server-to-server (S2S) postback requests.</td></tr><tr style="height: 30.75px;"><td class="align-left" style="width: 18.8245%; height: 30.75px;">**sum**</td><td class="align-left" style="width: 15.6109%; height: 30.75px;">numeric</td><td style="width: 65.5249%; height: 30.75px;">Conversion value or lead payout amount</td></tr><tr style="height: 30.75px;"><td class="align-left" style="width: 18.8245%; height: 30.75px;">**click-id**</td><td class="align-left" style="width: 15.6109%; height: 30.75px;">numeric</td><td style="width: 65.5249%; height: 30.75px;">Unique Click ID received from DAO.AD URL macros</td></tr><tr style="height: 48.8958px;"><td class="align-left" style="width: 18.8245%; height: 48.8958px;">**type**</td><td class="align-left" style="width: 15.6109%; height: 48.8958px;">text</td><td style="width: 65.5249%; height: 48.8958px;">The postback type (default is `main`). Common values include: `main` (e.g., registration), `dep` (e.g., deposit), or any custom types you define</td></tr><tr style="height: 64.3646px;"><td class="align-left" style="width: 18.8245%; height: 64.3646px;">**ttl**</td><td class="align-left" style="width: 15.6109%; height: 64.3646px;">numeric</td><td style="width: 65.5249%; height: 64.3646px;">Time in secounds. The postback request time-to-live (TTL). During this period, any postback containing the same Click ID will be treated as a duplicate and ignored. The default value is 24 hours. Minimum value 5 seconds</td></tr></tbody></table>

<p class="callout warning">**Important:** The API key can be found on your DAO.AD [Profile page](https://dao.ad/en/profile).</p>

##### Example URL

http://api.daopush-api.info/api/postback/campaign?key=**<span style="color: rgb(45, 194, 107);">XXXXXXXXXXXXX</span>**&amp;sum=**<span style="color: rgb(224, 62, 45);">{sum}</span>**&amp;click-id=**<span style="color: rgb(224, 62, 45);">{click-Id}</span>**&amp;type=**<span style="color: rgb(224, 62, 45);">{type}</span>**&amp;ttl=**<span style="color: rgb(224, 62, 45);">{ttl}</span>**

**where:**

**<span style="color: rgb(45, 194, 107);">XXXXXXXXXXXXX</span>** - your DAO.AD API key  
<span style="color: #b96ad9;">**<span style="color: rgb(224, 62, 45);">{sum}</span>, <span style="color: rgb(224, 62, 45);">{click-Id}</span>, <span style="color: rgb(224, 62, 45);">{type}</span><span style="color: rgb(224, 62, 45);">, </span><span style="color: rgb(224, 62, 45);">{ttl}<span style="color: rgb(0, 0, 0);"> - </span></span>**<span style="color: rgb(224, 62, 45);"><span style="color: rgb(0, 0, 0);">example macro names used by a CPA network or tracking platform.</span></span></span>

#####   
How macro replacement works

DAO.AD URL:  
http://api.daopush-api.info/api/postback/campaign?key=**<span style="color: rgb(45, 194, 107);">XXXXXXXXXXXXX</span>**&amp;sum=**<span style="color: rgb(224, 62, 45);">{sum}</span>**&amp;click-id=**<span style="color: rgb(224, 62, 45);">{click-Id}</span>**&amp;type=**<span style="color: rgb(224, 62, 45);">{type}</span>**&amp;ttl=**<span style="color: rgb(224, 62, 45);">{ttl}</span>**

After CPA/Tracker request:  
http://api.daopush-api.info/api/postback/campaign?key=**<span style="color: rgb(45, 194, 107);">XXXXXXXXXXXXX</span>**&amp;sum=**<span style="color: rgb(224, 62, 45);">10</span>**&amp;click-id=**<span style="color: rgb(224, 62, 45);">61721111</span>**&amp;type=**<span style="color: rgb(224, 62, 45);">dep</span>**&amp;tt<span style="background-color: rgb(255, 255, 255);">l=**<span style="color: rgb(224, 62, 45);">50</span>**</span>

<p class="callout warning">**Important:** These macro names are examples only and may differ depending on the CPA network or tracking platform. Always refer to the documentation of your CPA network or tracker.</p>

#####   
Why is it needed?  


After a user completes a conversion, the CPA network or tracking platform sends conversion information back to DAO.AD. This data is used for reporting, optimization, automated rules, micro-bidding, and campaign analytics.

##### Benefits of postback tracking:

- Accurate conversion tracking
- ROI calculation
- Automated blacklisting rules
- Micro-bidding optimization
- Source and sub-source analysis
- Campaign performance reporting

##### Related

- [Tracking Configuration Models](https://wiki.dao.ad/books/tracking-postback/page/tracking-configuration-models "Tracking Configuration Models")
- [Blacklist and Whitelist Targeting](https://wiki.dao.ad/books/optimization-reporting/page/blacklist-and-whitelist-targeting "Blacklist and Whitelist Targeting")
- [Micro-bidding Tool](https://wiki.dao.ad/books/optimization-reporting/page/micro-bidding-tool "Micro-bidding Tool")
- [Bid Adjustments](https://wiki.dao.ad/books/optimization-reporting/page/bid-adjustments "Bid Adjustments")