Click links
How an offer's click_url works: the parameters, what happens when it is opened, and the reasons a user can be turned away.
Every offer in the offers API has a click_url. Open it when your user takes the offer, in the system browser or an in-app browser.
https://redirect.cashadmedia.com/{id}?publisher_id={your account}&user_id={your user's ID}Links in the older form, https://cashadmedia.com/click/{id}?…, keep working, so there is nothing to change in apps that stored one. Always open the click_url the API gives you rather than building the link yourself.
If you didn't pass user_id to the API, the link ends in the literal text {user_id}. Replace it with the user's ID, URL-encoded, before opening it. A link that still contains {user_id} is refused.
What happens when it is opened
The user sees a short CashAdMedia loading page while we check that the offer is still available to them and record the click, and it stays up until the advertiser's page starts to load, so there's no blank screen through the tracking redirects. Then they're on the advertiser's page. The advertiser's own tracking link never appears in the API or in your app.
When a user is turned away
Instead of the advertiser, the user lands on a short page that explains why. The reasons:
| Reason | What happened |
|---|---|
| Ended | The offer ended, was paused, or is no longer available to your account. |
| Country | The offer doesn't run in the user's country. |
| Device | The offer is for another platform, e.g. an iOS app opened on Android. Web offers open on any device. |
| Cap | The offer reached its daily limit. It opens again at midnight UTC. |
| Link | The link is incomplete: no publisher or user ID. |
Refreshing your cached offer list every few minutes keeps these rare.