Appearance
Pass your click ID with every ad (postback_id)
If you buy traffic and want to match conversions back to your own click IDs, you can hand those IDs to dlserve. We pass your click ID along with every ad request, so conversions can be reported back to you with the click ID they came from.
How it works
When your script URL includes a postback_id parameter, dlserve sends that value along with the ads shown to that visitor — push notifications, in-page notifications and pop ads.
The value is yours: we don't change or interpret it, we only pass it on. Your account manager sets up where conversion postbacks are sent.
Set it up
Add ?postback_id= with your click ID to the end of your dlserve script URL.
With a value filled in by your server (PHP example):
html
<script src="https://cdn.dlserve.ai/sdk/YOUR-PLACEMENT-ID.js?postback_id=<?= $clickid ?>" async></script>What the visitor's browser receives:
html
<script src="https://cdn.dlserve.ai/sdk/YOUR-PLACEMENT-ID.js?postback_id=dajvkdfal4tc73behm20" async></script>Any server-side language works (PHP, Node.js, Python and so on) — the value just needs to be in the script URL when the page loads. Without the parameter, the script works exactly as before:
html
<script src="https://cdn.dlserve.ai/sdk/YOUR-PLACEMENT-ID.js" async></script>Which ads carry it
| Format | What happens |
|---|---|
| In-page notifications | Sent with every ad shown during that page view. |
| Pop ads | Sent with every pop opened from that page view. |
| Push notifications | Saved on the subscriber and sent with every future push. If they later arrive with a different click ID, the newest one replaces it. |
People who subscribed before you added the parameter pick up a click ID the next time they visit a page that includes it.
Good to know
- Any value is accepted — letters, numbers and symbols. Spaces at the start or end are trimmed.
- Limits: values longer than 256 characters, or containing line breaks or other control characters, are ignored.
- URL-encode special characters: if your value can contain
&,=,?,#or spaces, encode it (for example withurlencode()in PHP). - No slowdown: the script is still served from cache, whatever the click ID is.
- Install check: the dashboard's install verification recognizes the script with the parameter.
Troubleshooting
- Nothing arriving? Open your page, view its source (not your template) and check the script URL really contains
?postback_id=followed by a value. An empty value sends nothing. - Values cut off or wrong? The value probably contains an unencoded
&or#. Encode it on your server. - Still stuck? Ask your account manager to confirm where your conversion postbacks are delivered.